Agent Reach：给AI Agent一键装上互联网能力
Agent Reach：给AI Agent一键装上互联网能力
一句话安装，让你的Agent能读推特、刷小红书、看YouTube、搜Reddit。
痛点
AI Agent已经能帮你写代码、改文档、管项目——
但你让它去网上找点东西，它就抓瞎了： "
- 📺 "帮我看看这个YouTube教程讲了什么" → 看不了，拿不到字幕
- 🐦 "帮我搜一下推特上大家怎么评价这个产品" → 搜不了，Twitter API要付费
- 📖 "去Reddit上看看有没有人遇到过同样的bug" → 403被封，服务器IP被拒
- 📕 "帮我看看小红书上这个品的口碑" → 打不开，必须登录才能看
- 📺 "B站上有个技术视频，帮我总结一下" → 拿不到，通用下载工具被B站风控全面拦截
- 🔍 "帮我在网上搜一下最新的LLM框架对比" → 没有好用的搜索，要么付费要么质量差
- 🌐 "帮我看看这个网页写了啥" → 抓回来一堆HTML标签，根本没法读
- 📦 "这个GitHub仓库是干嘛的？Issue里说了什么？" → 能用，但认证配置很麻烦
- 📡 "帮我订阅这几个RSS源，有更新告诉我" → 要自己装库写代码
这些不难实现，但是需要自己折腾配置。
每个平台都有自己的门槛——要付费的API、要绕过的封锁、要登录的账号、要清洗的数据。你要一个一个去踩坑、装工具、调配置，光是让Agent能读个推特就得折腾半天。
Agent Reach
Panniantong开源的Agent工具——
给AI Agent一键装上完整的互联网能力。
核心特性
- 🎯 一键安装 — 告诉Agent一句话，几分钟后就能用
- 🌐 多平台支持 — YouTube、Twitter、Reddit、GitHub、B站、小红书、Facebook、Instagram、LinkedIn、V2EX、雪球、小宇宙播客、RSS等
- 🔀 智能路由 — 每个平台首选+备选，自动选择最稳定的
- 🔄 持续维护 — 平台变化自动适配，用户无感
- 💰 完全免费 — 所有工具开源、所有API免费
- 🔒 隐私安全 — Cookie只存在本地，不上传不外传
- 🩺 自带诊断 —
agent-reach doctor一条命令告诉你哪个通、哪个不通 - 🤖 兼容所有Agent — Claude Code、OpenClaw、Cursor、Windsurf……任何能跑命令行的Agent都能用
一句话安装
复制这句话给你的AI Agent：
帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md就这一步。
Agent会自己完成剩下的所有事情：
- 安装CLI工具（
pip install agent-reach） - 安装系统基建（Node.js、gh CLI、mcporter）
- 配置搜索引擎（Exa语义搜索，免费无需API Key）
- 检测环境（本地电脑还是服务器）
- 注册SKILL.md（让Agent知道什么时候该用什么工具）
- 问你要不要更多（小红书、Twitter等需要登录态的平台，点名才装）
已安装过？更新也是一句话：
帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md支持的平台
零配置平台（装好即用）
| 平台 | 能力 | 技术选型 |
|---|---|---|
| 🌐 网页 | 阅读任意网页 | Jina Reader（免费，无需API Key） |
| 📺 YouTube | 字幕提取 + 视频搜索 | yt-dlp（154K Star，YouTube最佳选择） |
| 📡 RSS | 阅读任意RSS/Atom源 | feedparser（Python生态标准） |
| 💻 V2EX | 热门帖子、节点帖子、帖子详情+回复、用户信息 | 原生API |
| 📈 雪球 | 股票行情、搜索股票、热门帖子、热门股票排行 | 原生API |
无需任何配置，装好就能用。
配置后解锁
| 平台 | 能力 | 配置方式 |
|---|---|---|
| 🔍 全网搜索 | 全网语义搜索 | 自动配置（MCP接入Exa，免费无需Key） |
| 📦 GitHub | 私有仓库、提Issue/PR、Fork | 告诉Agent「帮我登录GitHub」 |
| 🐦 Twitter/X | 搜索推文、浏览时间线、读长文 | 告诉Agent「帮我配Twitter」 |
| 📺 B站 | 字幕提取（OpenCLI） | 告诉Agent「帮我配B站」 |
| 搜索 + 读帖子和评论 | 桌面装OpenCLI用浏览器登录态；或rdt-cli + Cookie | |
| 搜索、主页、Feed、群组列表 | 桌面装OpenCLI（复用Chrome登录态） | |
| 用户搜索、Profile、用户最近帖子、Explore | 桌面装OpenCLI（复用Chrome登录态） | |
| 📕 小红书 | 搜索、阅读、评论 | 桌面装OpenCLI（刷过小红书即可用）；服务器用xiaohongshu-mcp扫码 |
| Profile详情、公司页面、职位搜索 | 告诉Agent「帮我配LinkedIn」 | |
| 🎙️ 小宇宙播客 | 播客音频转文字（Whisper转录） | 告诉Agent「帮我配小宇宙播客」 |
不知道怎么配？不用查文档。 直接告诉Agent「帮我配XXX」，它会一步一步引导你。
智能路由
每个平台都是「首选 + 备选」多后端路由。
某个接入方式失效了，Agent Reach自动切换下一个，用户无感。
实例：B站
2026年6月： yt-dlp被B站风控412封死
Agent Reach： 自动切换到bili-cli
用户： 零操作，继续使用
当前选型
| 场景 | 首选 | 备选 |
|---|---|---|
| 读网页 | Jina Reader | — |
| 读推特 | twitter-cli | OpenCLI（浏览器登录态兜底） |
| OpenCLI（桌面） | rdt-cli（Cookie） | |
| OpenCLI（桌面浏览器登录态） | — | |
| OpenCLI（桌面浏览器登录态） | 官方Graph API | |
| YouTube | yt-dlp | — |
| B站 | bili-cli | OpenCLI ▸ 搜索API |
| 搜全网 | Exa via mcporter | — |
| GitHub | gh CLI | — |
| 读RSS | feedparser | — |
| 小红书 | OpenCLI（桌面） | xiaohongshu-mcp（服务器） ▸ xhs-cli |
| linkedin-mcp | Jina Reader |
这些都是「当前选型」，基于真机实测定期复核。
某条路失效了Agent Reach换下一条——agent-reach doctor永远告诉你现在走的是哪条。
装好就能用
不需要记命令，告诉Agent就行：
示例1：读网页
帮我看看这个链接讲了什么：https://example.com/articleAgent用Jina Reader读取，提取关键信息。
示例2：看YouTube
这个YouTube视频讲了什么？Agent用yt-dlp提取字幕，总结内容。
示例3：搜推特
帮我搜一下推特上大家怎么评价这个产品Agent用twitter-cli搜索，提取推文内容。
示例4：刷小红书
小红书上这个产品的口碑怎么样？Agent用OpenCLI搜索，提取帖子内容。
示例5：GitHub调研
这个GitHub仓库是干嘛的？Issue里说了什么？Agent用gh CLI读取仓库信息和Issue。
示例6：全网搜索
帮我在网上搜一下最新的LLM框架对比Agent用Exa语义搜索，返回高质量结果。
示例7：B站视频
B站搜一下AI教程，帮我总结一下Agent用bili-cli搜索，提取字幕总结。
自带诊断
agent-reach doctor一条命令告诉你：
- ✅ 哪个渠道通了
- ❌ 哪个渠道不通
- 🔧 怎么修
输出示例：
✅ 网页 (Jina Reader)
✅ YouTube (yt-dlp)
✅ GitHub (gh CLI)
❌ Twitter (twitter-cli) - 需要配置
🔧 运行：告诉Agent「帮我配Twitter」
✅ B站 (bili-cli)
❌ 小红书 (OpenCLI) - 需要登录
🔧 运行：在浏览器打开小红书，然后重试设计理念
Agent Reach是一个能力层（capability layer），不是又一个工具。
它比任何具体实现高一层——负责选型、安装、体检、路由，不负责底层读取本身。
为什么需要能力层？
你给一个新Agent装环境的时候，总要花时间去找工具、装依赖、调配置：
- Twitter用什么读？
- Reddit怎么登录？
- 小红书的CLI停更了换什么？
每次都要重新踩一遍。
Agent Reach做的事情很简单：
当下最稳的接入方式，我们替你选好、装好、体检好。接入方式会换代，你不用操心。
实例：2026年3月
一批单平台CLI集体停更——
Agent Reach换了路由，用户零操作。
架构设计
channels/
├── web.py → Jina Reader
├── twitter.py → twitter-cli ▸ OpenCLI ▸ bird
├── youtube.py → yt-dlp
├── github.py → gh CLI
├── bilibili.py → bili-cli ▸ OpenCLI ▸ 搜索API
├── reddit.py → OpenCLI ▸ rdt-cli
├── facebook.py → OpenCLI（桌面浏览器登录态）
├── instagram.py → OpenCLI（桌面浏览器登录态）
├── xiaohongshu.py → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli
├── linkedin.py → linkedin-mcp ▸ Jina Reader
├── rss.py → feedparser
├── exa_search.py → Exa via mcporter
└── __init__.py → 渠道注册（doctor检测用）每个渠道文件按序真实探测各候选后端（不只是看命令存不存在），第一个完整可用的当选。
坏掉的会给出修复处方。
安全性
| 措施 | 说明 |
|---|---|
| 🔒 凭据本地存储 | Cookie、Token只存在你本机~/.agent-reach/config.yaml，文件权限600（仅所有者可读写），不上传不外传 |
| 🛡️ 安全模式 | agent-reach install --safe不会自动修改系统，只列出需要什么，由你决定装不装 |
| 👀 完全开源 | 代码透明，随时可审查。所有依赖工具也是开源项目 |
| 🔍 Dry Run | agent-reach install --dry-run预览所有操作，不做任何改动 |
| 🧩 可插拔架构 | 不信任某个组件？换掉对应的channel文件即可，不影响其他 |
⚠️ 封号风险提醒
使用Cookie登录的平台（Twitter、小红书等），通过脚本/API调用存在被平台检测并封号的风险。
请务必使用专用小号，不要用你的主账号。
安装方式
方式一：一键全自动（推荐）
agent-reach install --env=auto适合场景：个人电脑、开发环境
方式二：安全模式
agent-reach install --env=auto --safe适合场景：生产服务器、多人共用机器
不会自动修改系统，只列出需要什么，由你决定装不装。
方式三：仅预览
agent-reach install --env=auto --dry-run适合场景：先看看会做什么
预览所有操作，不做任何改动。
能力边界
能做什么
- ✅ 读内容（网页、推文、帖子、视频字幕、RSS等）
- ✅ 搜索（全网搜索、平台内搜索）
- ✅ 提取信息（GitHub仓库、YouTube字幕、小红书帖子等）
不能做什么
有些任务超出"读"的范围：
- ❌ 登录后的网页操作
- ❌ 表单提交
- ❌ 多账号隔离
- ❌ 并行浏览器会话
- ❌ 自动化流程中的登录、验证、风控提示
这类"动手"场景，可以配合BrowserAct这类浏览器自动化工具——30+预制平台技能，支持Claude Code/OpenClaw/Cursor等主流Agent。
为什么值得Star
作者自己每天在用，所以会一直维护：
- 有新需求或者大家提了想要的渠道，会陆续加上
- 每个渠道会尽量保证能用、好用、免费
- 平台改了反爬或者API变了，会想办法解决
为Web 4.0基建贡献一份自己的力量。
Star一下，下次需要的时候能找到。⭐
核心价值
1. 一句话安装
不是一堆配置命令，而是一句话。
复制给Agent，几分钟后就能用。
2. 多平台支持
不是单一工具，而是工具箱。
YouTube、Twitter、Reddit、GitHub、B站、小红书、Facebook、Instagram、LinkedIn、V2EX、雪球、小宇宙播客、RSS……
3. 智能路由
不是固定死，而是自适应。
首选+备选，某个失效了自动切换下一个。
4. 持续维护
不是装完就不管，而是持续跟进。
平台变化自动适配，用户无感。
5. 完全免费
不是付费API，而是开源免费。
所有工具开源、所有API免费。
唯一可能花钱的是服务器代理（$1/月），本地电脑不需要。
6. 安全可靠
不是黑盒，而是开源透明。
代码完全开源，Cookie只存在本地。
7. 自带诊断
不是瞎猜，而是明确告诉你。
agent-reach doctor一条命令告诉你哪个通、哪个不通、怎么修。
8. 兼容所有Agent
不是绑定某个Agent，而是通用能力。
Claude Code、OpenClaw、Cursor、Windsurf……任何能跑命令行的Agent都能用。
最后
传统Agent联网能力：WebSearch + WebFetch。
有限、笨拙、要配置。
Agent Reach：完整的互联网能力 + 智能路由 + 持续维护。
完整、智能、免配置。
给AI Agent一键装上互联网能力。
项目地址：https://github.com/Panniantong/agent-reach
作者：Panniantong
License：MIT
联系：pnt01@foxmail.com | Twitter: @Neo_Reidlab
关注公众号 Fen9Pi，聊聊AI时代的Agent能力。