Agent Reach

Agent Reach

Read and search the internet across 9+ 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 all dependencies (Node.js, mcporter, bird CLI, gh CLI). Read the output and run agent-reach doctor to see what's active.

For channels that need user input, ask the user. See the full setup guide: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

Commands

Read any URL

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

Handles: tweets, Reddit posts, articles, YouTube (transcripts), GitHub repos, etc.

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 (小红书)

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 proxy http://user:pass@ip:port
agent-reach configure --from-browser chrome    # auto-extract cookies

Channel Status Tiers

• Tier 0 (zero config): Web, YouTube, RSS, Twitter (read-only via Jina)
• Tier 1 (free setup): Exa web search (mcporter required)
• Tier 2 (user config): Twitter search (cookie), Reddit full (proxy), GitHub (token), Bilibili (proxy), XiaoHongShu (MCP)

Run agent-reach doctor to see which channels are active.

Tips

• Always try agent-reach read <url> first for any URL — it auto-detects the platform
• For Twitter cookies, recommend the user install Cookie-Editor Chrome extension
• Reddit and Bilibili block server IPs — suggest a residential proxy (~$1/month) if on a server
• If a channel breaks, run agent-reach doctor to diagnose