Agent Reach

Agent Reach

Read and search the internet across 12+ platforms via unified CLI.

Setup

First check if agent-reach is installed:

agent-reach doctor

If command not found, install it:

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

install auto-detects your environment and installs core dependencies (Node.js, mcporter, bird CLI, gh CLI, instaloader). Read the output and run agent-reach doctor to see what's active.

Commands

Read any URL

agent-reach read <url>
agent-reach read <url> --json    # structured output

Handles: tweets, Reddit posts, articles, YouTube/Bilibili (transcripts), GitHub repos, Instagram posts, LinkedIn profiles, Boss直聘 jobs, XiaoHongShu notes, RSS feeds, and any web page.

Search

agent-reach search "query"             # web search (Exa)
agent-reach search-twitter "query"     # Twitter/X
agent-reach search-reddit "query"      # Reddit (--sub <subreddit>)
agent-reach search-github "query"      # GitHub (--lang <language>)
agent-reach search-youtube "query"     # YouTube
agent-reach search-bilibili "query"    # Bilibili (B站)
agent-reach search-xhs "query"        # XiaoHongShu (小红书)
agent-reach search-instagram "query"   # Instagram
agent-reach search-linkedin "query"    # LinkedIn
agent-reach search-bosszhipin "query"  # Boss直聘

All search commands support -n <count> for number of results.

Management

agent-reach doctor        # channel status overview
agent-reach watch         # quick health + update check (for scheduled tasks)
agent-reach check-update  # check for new versions

Configure channels

agent-reach configure twitter-cookies "auth_token=xxx; ct0=yyy"
agent-reach configure instagram-cookies "sessionid=xxx; csrftoken=yyy; ..."
agent-reach configure proxy http://user:pass@ip:port
agent-reach configure --from-browser chrome    # auto-extract cookies from local browser

Configuring a channel ("帮我配 XXX")

All channels follow the same flow. When a user asks to configure/enable any channel:

1. Run agent-reach doctor
2. Find the channel in the output — it shows the current status (✅/⚠️/⬜) and what to do next
3. Execute whatever you can automatically (install packages, start services, register MCP)
4. For steps that require human action (scan QR code, paste cookies, login), tell the user exactly what to do
5. After the user completes their part, run agent-reach doctor again to verify

Do NOT memorize per-channel steps. Always rely on doctor output — it stays up-to-date even when backends change.

Common human actions

These are things only the user can do. When doctor indicates one is needed, explain it clearly:

• Paste cookies: User installs Cookie-Editor Chrome extension → goes to the website → exports Header String → sends it to you → you run agent-reach configure <platform>-cookies "..."
• Scan QR code: User opens the URL shown in doctor output on their phone/browser and scans with the platform's app
• Browser login: Some MCP services need a one-time browser login; on servers without a display, user may need VNC
• Proxy: Reddit/Bilibili/XiaoHongShu block server IPs — suggest a residential proxy (~$1/month) if on a server

Tips

• Always try agent-reach read <url> first for any URL — it auto-detects the platform
• If a channel is ⬜ but the user hasn't asked for it, don't push — let them opt in
• If a channel breaks, run agent-reach doctor to diagnose
• LinkedIn and Boss直聘 have Jina Reader fallback even without full setup
• Twitter search 在 bird 失败时会自动 fallback 到 Exa 搜索

Troubleshooting

Twitter "fetch failed"

bird CLI 用 Node.js 原生 fetch()，不走 HTTP_PROXY/HTTPS_PROXY 环境变量。 Agent Reach 已内置解决方案：通过 undici 的 EnvHttpProxyAgent 自动注入代理。

你（Agent）需要确认：

1. undici 已全局安装：npm list -g undici，没有就装：npm install -g undici
2. 用户已配置代理：agent-reach configure proxy http://user:pass@ip:port
3. Agent Reach 会自动处理注入，不需要用户额外操作

如果以上都没问题仍然 "fetch failed"，建议用户使用透明代理（如 Clash TUN 模式、Proxifier）。

详见 https://github.com/Panniantong/Agent-Reach/blob/main/docs/troubleshooting.md