Agent Reach
Give your AI agent eyes to see the internet. Agent Reach installs, routes, and health-checks upstream tools for 15 platforms — Twitter/X, Reddit, Facebook, Instagram, YouTube, GitHub, Bilibili, XiaoHongShu, LinkedIn, V2EX, Xueqiu, Xiaoyuzhou Podcast, RSS, web search, and any web page. One install, zero API fees.
Quick Start
- Installation Guide: Step-by-step setup instructions for AI agents
- README (中文): Full documentation in Chinese
- README (English): Full documentation in English
Core Commands
- CLI Usage:
agent-reach doctor --jsonshows the active backend; agents then call upstream tools directly (opencli,twitter,bili,yt-dlp,gh,mcporter, etc.).
Key Features
- Read any URL: tweets, Reddit posts, Facebook pages/feed/groups, Instagram profiles/posts, YouTube videos (transcripts), GitHub repos, articles, XiaoHongShu notes, Bilibili videos, RSS feeds
- Search/discover across platforms: Twitter/X, Reddit, Facebook, Instagram user search, GitHub, YouTube, Bilibili, XiaoHongShu, LinkedIn, V2EX, Xueqiu, Web (via Exa)
- Self-diagnosis:
agent-reach doctorchecks what works and what needs setup - Auto-installs dependencies:
agent-reach install --env=auto - Browser-session / cookie auth for platforms that require login (Twitter, Reddit, Facebook, Instagram, XiaoHongShu, Xueqiu)
- Proxy support for platforms that block server IPs (Reddit, Twitter)
- Zero API fees: all backends are free and open-source (OpenCLI, twitter-cli, rdt-cli, bili-cli, yt-dlp, Jina Reader, mcporter/Exa, etc.)
Troubleshooting
- Troubleshooting Guide: Common issues and solutions
Optional
- SKILL.md: Integration guide for AI agent frameworks (OpenClaw, Claude Code, etc.)
- Install from GitHub (the
agent-reachpackage on PyPI is NOT this project):pipx install https://github.com/Panniantong/agent-reach/archive/main.zip