Panniantong / Agent-Reach
Agent Reach: Give Your AI Agent One-Click Internet Capabilities
👁️ Agent Reach: Give Your AI Agent One-Click Internet Capabilities
Quick Start · English · 日本語 · 한국어 · Supported Platforms · Design Philosophy
Why do you need Agent Reach?
AI Agents can already help you write code, edit documents, and manage projects—but the moment you ask them to find something online, they get stuck:
- 📺 “Help me see what this YouTube tutorial is about” → Can’t watch, can’t get subtitles.
- 🐦 “Search Twitter to see what people think of this product” → Can’t search, Twitter API is paid.
- 📖 “Check Reddit to see if anyone else encountered this bug” → 403 Forbidden, server IP blocked.
- 📕 “Check the reputation of this product on Xiaohongshu” → Can’t open, requires login.
- 📺 “Summarize this technical video on Bilibili” → Can’t connect, overseas/server IPs are blocked.
- 🔍 “Search for the latest LLM framework comparisons” → No good search, either paid or low quality.
- 🌐 “What does this webpage say?” → Returns a mess of HTML tags, unreadable.
- 📦 “What is this GitHub repo for? What’s in the Issues?” → Possible, but authentication is a hassle.
- 📡 “Subscribe to these RSS feeds and notify me of updates” → Have to install libraries and write code yourself.
These aren’t hard to implement, but they require manual configuration. Every platform has its own barrier—paid APIs, blocks to bypass, accounts to log in to, and data to clean. You have to troubleshoot, install tools, and adjust settings one by one. Just getting an Agent to read Twitter can take half a day.
Agent Reach turns this into a single sentence:
Help me install Agent Reach:
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
Copy this to your Agent, and in a few minutes, it will be able to read Twitter, search Reddit, watch YouTube, and browse Xiaohongshu.
Already installed? Updating is just as simple:
Help me update Agent Reach:
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md
⭐ Star this project. We will continuously track changes across platforms and add new channels. You don’t need to monitor them—if a platform blocks us, we fix it; if there’s a new channel, we add it.
✅ Before you use it, you might want to know:
- 💰 Completely Free: All tools are open-source, all APIs are free. The only potential cost is a server proxy (~$1/month); local computers don’t need one.
- 🔒 Privacy & Security: Cookies stay on your local machine; they are never uploaded or transmitted. The code is fully open-source and auditable at any time.
- 🔄 Continuous Updates: Underlying tools (yt-dlp, twitter-cli, rdt-cli, Jina Reader, etc.) are regularly updated to the latest versions. You don’t need to track them yourself.
- 🤖 Compatible with all Agents: Claude Code, OpenClaw, Cursor, Windsurf… any Agent that can run command-line tools can use it.
- 🩺 Built-in Diagnostics:
agent-reach doctortells you in one command what works, what doesn’t, and how to fix it.
Supported Platforms
| Platform | Out-of-the-box | Unlocked after Config | How to configure |
|---|---|---|---|
| 🌐 Web | Read any page | — | No config needed |
| 📺 YouTube | Subtitle extraction + Search | — | No config needed |
| 📡 RSS | Read any RSS/Atom feed | — | No config needed |
| 🔍 Search | — | Full semantic search | Auto-config (MCP, free, no key) |
| 📦 GitHub | Read public repos + Search | Private repos, Issues/PRs, Fork | Tell Agent “Help me log in to GitHub” |
| 🐦 Twitter/X | Read single tweets | Search, Timeline, Post | Tell Agent “Help me configure Twitter” |
| 📺 Bilibili | Local: Subtitles + Search | Server-side support | Tell Agent “Help me configure proxy” |
| Search + Read posts/comments | Cookie login (rdt login) | See rdt-cli docs | |
| 📕 Xiaohongshu | — | Read, Search, Post, Comment | Tell Agent “Help me configure XHS” |
| 🎵 Douyin | — | Video parsing, No-watermark DL | Tell Agent “Help me configure Douyin” |
| Jina Reader (Public) | Profile details, Job search | Tell Agent “Help me configure LinkedIn” | |
| Search + Read articles | — | No config needed | |
| Hot search, User/Topic search | — | No config needed | |
| 💻 V2EX | Hot posts, Node posts, Details | — | No config needed |
| 📈 Xueqiu | Stock quotes, Search, Rankings | — | Tell Agent “Help me configure Xueqiu” |
| 🎙️ Xiaoyuzhou | — | Audio-to-text (Whisper) | Tell Agent “Help me configure Podcast” |
Don’t know how to configure? No need to check documentation. Just tell your Agent “Help me configure XXX,” and it will know what is needed and guide you step-by-step.
- 🍪 For platforms requiring Cookies (Twitter, Xiaohongshu, etc.), we prioritize using the Chrome extension Cookie-Editor to export cookies and send them to the Agent. The process is unified: Login in browser → Export via Cookie-Editor → Send to Agent. It’s simpler and more reliable than scanning QR codes.
- 🔒 Cookies stay local. They are never uploaded. The code is fully open-source.
- 💻 Local computers don’t need a proxy. Proxies are only needed if you deploy on a server (~$1/month).
Quick Start
⚠️ OpenClaw users: Please ensure exec permissions are enabled. Agent Reach relies on the Agent executing shell commands (pip install, mcporter, twitter, etc.). If your OpenClaw uses the default messaging tool profile, the Agent cannot execute commands. Before installing, run:
openclaw config set tools.profile "coding"
Or set it in ~/.openclaw/openclaw.json. Restart the Gateway and start a new chat. Other platforms (Claude Code, Cursor, Windsurf) are not affected.
Copy this to your AI Agent:
Help me install Agent Reach:
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
That’s it. The Agent will handle the rest.
🔄 Already installed? Updating is just one sentence:
Help me update Agent Reach:
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md
🛡️ Worried about security? Use Safe Mode—it won’t automatically install system packages, it will only tell you what is needed:
Help me install Agent Reach (Safe Mode):
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md(Use the--safeparameter during installation)
Design Philosophy
Agent Reach is scaffolding, not a framework. When you set up a new Agent, you always waste time finding tools, installing dependencies, and tweaking configs—what do I use for Twitter? How do I bypass Reddit blocks? How do I extract YouTube subtitles? You have to repeat this every time.
Agent Reach does one simple thing: it finishes the selection and configuration work for you. Once installed, the Agent calls upstream tools (twitter-cli, rdt-cli, xhs-cli, yt-dlp, mcporter, gh CLI, etc.) directly, without passing through an Agent Reach wrapper layer.
🔌 Every channel is pluggable. Behind every platform is an independent upstream tool. Not satisfied? Just swap it out.
Current Selections
| Scenario | Selection | Why? |
|---|---|---|
| Web Reading | Jina Reader | 9.8K Stars, free, no API key needed |
| twitter-cli | 2.1K Stars, Cookie login, full features | |
| rdt-cli | 304 Stars, Cookie auth, search + full text | |
| Video/Subtitles | yt-dlp | 154K Stars, supports 1800+ sites |
| Search | Exa via mcporter | AI semantic search, MCP, no key |
| GitHub | gh CLI | Official tool, full API capabilities |
📌 These are “current selections.” Not satisfied? Just replace the corresponding file. That is the point of scaffolding.