5c62a21f32
全局重命名： - 包名: 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 全部正常。 |
||
|---|---|---|
| .. | ||
| cookie-export.md | ||
| install.md | ||
| README_en.md | ||
👁️ Agent Reach
Give your AI Agent eyes to see the entire internet.
Your AI Agent is smart but blind. It can't browse Reddit, search Twitter, or read Bilibili videos. Agent Reach fixes this — once installed, your Agent can search and read content across 10+ platforms.
Install once. Superpowers unlocked. Most features work with zero config, zero cost.
Get Started in 30 Seconds
Copy this to your AI Agent (Claude Code, OpenClaw, Cursor, etc.):
Install Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
Your Agent handles everything. You answer 1-2 questions at most.
Manual install
pip install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto
agent-reach doctor
Works Out of the Box
No configuration needed:
- 🌐 Web pages — read any URL
- 📦 GitHub — repos, issues, PRs, code search
- 📺 YouTube — video transcripts
- 📺 Bilibili — video info + subtitles
- 📡 RSS — any feed
- 🐦 Twitter — read individual tweets
agent-reach read "https://github.com/openai/gpt-4"
agent-reach search-github "LLM framework"
One Key Unlocks Search
Sign up at Exa (free, 1000 searches/month). One key unlocks web + Reddit + Twitter search:
agent-reach configure exa-key YOUR_KEY
agent-reach search "best open source LLM 2025"
agent-reach search-reddit "self-hosted LLM" --sub LocalLLaMA
agent-reach search-twitter "AI agent"
Unlock More
🍪 Cookie-based (free, 2 minutes)
# Local: auto-import all cookies
agent-reach configure --from-browser chrome
# Server: use Cookie-Editor extension, export Header String
agent-reach configure twitter-cookies "cookie_string"
agent-reach configure xhs-cookie "cookie_string"
Unlocks: Twitter deep search, XiaoHongShu notes
🌐 Proxy ($1/month, servers only)
Reddit and Bilibili block server IPs. Local computers are fine.
agent-reach configure proxy http://user:pass@ip:port
Recommend Webshare. One proxy covers both Reddit and Bilibili.
Three Ways to Use
CLI · Python API · MCP Server
agent-reach read "URL"
agent-reach search "query"
agent-reach doctor
from agent_reach import AgentReach
eyes = AgentReach()
result = asyncio.run(eyes.read("https://example.com"))
{"mcpServers": {"agent-reach": {"command": "python", "args": ["-m", "agent_reach.integrations.mcp_server"]}}}
Why Agent Reach?
Not a framework. Not an SDK. Just glue — beautifully simple glue.
- Aggregates the best free tools: Jina Reader, birdx, yt-dlp, Exa, feedparser
- Each channel is ~50 lines. Swap any backend by editing one file.
- CLI, MCP Server, Python API
- 99% free. The remaining 1% costs $1/month.
Credits
Jina Reader · birdx · Exa · yt-dlp · feedparser
License
MIT