Agent-Reach/docs/install.md
Panniantong 5c62a21f32 rename: Agent Eyes → Agent Reach
全局重命名:
- 包名: agent_eyes → agent_reach
- CLI: agent-eyes → agent-reach
- 类名: AgentEyes → AgentReach
- 显示名: Agent Eyes → Agent Reach
- GitHub: Panniantong/agent-eyes → Panniantong/Agent-Reach

所有 36 个测试通过,CLI/doctor/read/search 全部正常。
2026-02-24 10:25:46 +01:00

2.4 KiB
Raw Blame History

Agent Reach — Installation Guide

For Humans

Copy this to your AI Agent:

帮我安装 Agent Reachhttps://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

For AI Agents

Step 1: Install

pip install https://github.com/Panniantong/agent-reach/archive/main.zip || pip3 install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto

This single command does everything automatically:

  • Detects local computer vs server
  • Auto-imports browser cookies on local (Twitter, XiaoHongShu, Bilibili)
  • Auto-detects Exa API key if already in environment
  • Tests all channels
  • Shows what's working and what needs setup

Read the output carefully. It tells you exactly what happened and what's next.

Step 2: Only if needed — configure what's missing

Based on the install output, you may need to configure one or two things. Only ask the user for items the install output says are missing.

If search is not configured:

"Want to unlock web search? Go to https://exa.ai → sign up (free) → send me the API key."

agent-reach configure exa-key THE_KEY

If cookies were not auto-imported (server users):

"To unlock Twitter and XiaoHongShu, install the Cookie-Editor Chrome extension, go to the site, click Export → Header String, and paste it to me." Extension: https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm

agent-reach configure twitter-cookies "PASTED_STRING"
agent-reach configure xhs-cookie "PASTED_STRING"

If on server and wants Reddit/Bilibili full access:

"Reddit and Bilibili block server IPs. Get a proxy at https://webshare.io ($1/month) and send me the address."

agent-reach configure proxy http://user:pass@ip:port

Step 3: Verify

agent-reach doctor

Report what's active. Users can configure more anytime by asking.


Quick Reference

Command What it does
agent-reach install --env=auto Full auto-setup
agent-reach doctor Show status
agent-reach configure exa-key KEY Unlock search
agent-reach configure twitter-cookies "..." Unlock Twitter
agent-reach configure xhs-cookie "..." Unlock XiaoHongShu
agent-reach configure proxy URL Unlock Reddit + Bilibili (server)
agent-reach read URL Read any URL
agent-reach search "query" Search the web