Agent Reach：给你的 AI Agent 一键装上互联网能力——完全免费的开源脚手架
“
本文核心问题：AI Agent 明明能写代码、改文档，为什么一碰到“上网找东西”就抓瞎？有没有一个免费、简单、无需反复折腾的解决方案？
本段回答的核心问题：AI Agent 缺的不是智能，而是“触网”的能力。你让 Agent 帮你总结 YouTube 教程、搜索推特上的产品评价、阅读小红书上的口碑——它要么直接报错，要么给你一堆不可读的 HTML 标签。每个平台都有自己的门槛：付费 API、IP 封锁、强制登录、数据清洗……一个一个去配置，光是让 Agent 能读个推特就要折腾半天。
Agent Reach 就是来解决这个问题的。它是一个脚手架（scaffolding），不是框架。你只需要对你的 AI Agent（Claude Code、OpenClaw、Cursor、Windsurf 等）说一句话，它就能自动完成所有安装和配置。从此，你的 Agent 可以读 YouTube 字幕、搜 Reddit、看小红书、解析抖音、抓取全网搜索结果——而且完全免费，所有凭据只存在你本地。
一、AI Agent 的“互联网困境”：为什么现成的工具总是差一步？
本段核心问题：AI 编程助手已经很强大，但为什么让它“去网上找点东西”就变得又蠢又难用？
目前主流的 AI Agent（比如 Claude Code、Cursor、OpenClaw）都能在你的电脑上执行命令、读写文件、运行脚本。它们的短板不在本地，而在网络。一旦任务涉及第三方网站，就会遇到以下典型障碍：
作者反思： 我最早用 Claude Code 的时候，也遇到这个问题。它写代码一流，但一旦我说“帮我看看推特上某大V的最新推文”，它就卡住了。我试过自己写 Python 脚本用 requests 爬，结果被 Twitter 封 IP；又去申请官方 API，发现免费版根本不能搜索；最后找到 twitter-cli 这个开源工具，但每次换新环境都要重新安装、配置 Cookie……每个平台都要重复这一套。这不是 Agent 的问题，是“给 Agent 装上网能力”这件事太碎片化了。
二、Agent Reach 是什么？——一句话安装，一键解锁全网能力
本段核心问题：有没有一种方法，让我的 Agent 在几分钟内就能读几乎所有主流平台，而且不用我自己记命令和配环境？
答案：有。你只需要对你的 Agent 说一句话：
帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
就这一句话。Agent 会自己读那个安装指南，然后自动完成以下所有事情：
-
安装 CLI 工具 — 执行 pip install agent-reach，装好agent-reach命令行。 -
安装系统依赖 — 自动检测你的操作系统，安装 Node.js、GitHub CLI（ gh）、mcporter、twitter-cli、rdt-cli等上游工具。 -
配置搜索引擎 — 通过 MCP（Model Context Protocol）接入 Exa 语义搜索，免费，无需 API Key。 -
检测环境 — 判断你是本地电脑还是服务器，给出对应的代理建议（只有服务器上访问 B 站等需要代理，约 $1/月）。 -
注册 SKILL.md — 在你的 Agent 的 skills 目录安装使用指南。以后 Agent 遇到“搜推特”“看视频”“读小红书”这类需求，会自动知道该调用哪个上游工具。
安装完成后，运行一条诊断命令，所有渠道的状态一目了然：
agent-reach doctor
“
已经安装过？更新也是一句话：
帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md
作者反思： 我最得意的一点是，这个安装过程不是“让用户读文档然后手动敲命令”，而是把安装指南也写成了 Agent 能读懂的 Markdown。Agent 自己就是“读者”，它会逐行执行里面的指令。这就像给 Agent 配了一个“安装说明书”，它照着做就行。你甚至不需要知道什么是 pip，什么是 gh CLI——Agent 知道。
三、支持的平台：一张表看清你能获得什么
本段核心问题：Agent Reach 到底能帮我访问哪些网站？哪些开箱即用，哪些需要简单配置？
以下表格基于当前版本（v1.0+）的支持情况。每个平台背后都是一个独立的上游开源工具，不满意可以直接换掉（这就是脚手架的好处）。
“
🍪 配置 Cookie 的统一方法：对于需要登录的平台（Twitter、小红书、Reddit 等），优先使用 Chrome 插件 Cookie-Editor（Chrome 商店链接）导出 Cookie，然后发给 Agent。流程：浏览器登录 → Cookie-Editor 导出 → 告诉 Agent “这是 Cookie，帮我配置”。比扫码更可靠，而且 Cookie 只存本地，不上传。
场景案例 1：让 Agent 总结一个 YouTube 技术视频
你只需要说：“帮我看看这个视频讲了什么：https://youtube.com/watch?v=xxx”
Agent 会在后台执行：
yt-dlp --dump-json "URL" # 提取元数据和字幕
然后它自动读取字幕内容，给你生成一份要点总结。你完全不需要知道 yt-dlp 这个工具。
场景案例 2：让 Agent 搜索 Twitter 上关于某个产品的讨论
你说：“帮我搜一下推特上大家对‘OpenClaw’的评价”
Agent 会执行：
twitter search "OpenClaw" --count 20
然后返回推文列表，甚至可以进一步帮你分析情绪倾向。
场景案例 3：让 Agent 读取一篇需要登录的小红书笔记
你给了 Agent 一个小红书分享链接。如果已经配置过 Cookie，Agent 会调用：
xhs read "笔记ID"
返回笔记的正文、图片、评论。如果没有配置，Agent 会主动说：“请先用 Cookie-Editor 导出小红书 Cookie 发给我。”
作者反思： 你可能会问：为什么不把所有平台都做成“装好即用”？因为像小红书、Twitter 这样的平台，强制要求登录态。但我不希望用户去折腾 OAuth、申请 API Key——那太复杂了。Cookie 方案是目前最省事、最通用的办法。你只需要在浏览器登录一次，导出 Cookie 发给 Agent，之后它就能一直用。而且 Cookie 只存在你本地的 ~/.agent-reach/config.yaml，文件权限 600，只有你自己能读写。
四、设计理念：可插拔的“工具箱”，而不是一个笨重的框架
本段核心问题：Agent Reach 和其他“AI 上网工具”有什么本质不同？为什么它更灵活、更安全？
核心差异：Agent Reach 不包装任何 API，不劫持你的网络请求，它只是一个“安装器 + 配置器 + 知识库”。
安装完成后，Agent 直接调用上游的独立工具（twitter-cli、rdt-cli、xhs-cli、yt-dlp、gh 等），完全不经过 Agent Reach 的中间层。这意味着：
-
没有性能损耗：Agent 执行的就是原生命令。 -
没有单点故障：如果某个上游工具更新了，Agent 可以直接用新特性，Agent Reach 只负责最初安装。 -
你可以随时换掉任何一个组件：不喜欢 twitter-cli？换成官方 tweepy 库就行，只要修改 Agent 的 skill 提示词。
每个平台对应的渠道在代码中只是一个独立的 Python 文件（例如 channels/twitter.py），它只做一件事：检查该工具是否已安装（提供给 agent-reach doctor 使用）。实际的读写、搜索完全由上游工具完成。
当前选型（都是开源、免费、社区活跃的项目）：
场景案例 4：你想用 Firecrawl 替换 Jina Reader 来读网页
你只需要做两件事：
-
安装 Firecrawl 的 CLI 或 MCP 服务。 -
修改 Agent 的 skill 文件（ ~/.agent-reach/skills/web.md），把里面的示例命令从curl https://r.jina.ai/URL改成 Firecrawl 的命令。
其他渠道（Twitter、Reddit 等）完全不受影响。这就是可插拔架构的好处。
作者反思： 我见过太多“大一统”的 AI 工具，它们试图把所有功能包在一个库里，结果变得臃肿、难维护、而且一旦某个上游 API 变化，整个工具就挂了。Agent Reach 反其道而行：只做薄薄的一层“胶水”。用户和 Agent 几乎感觉不到它的存在，但它解决了“从零到一”的安装和配置痛苦。之后你爱怎么改就怎么改，它不绑架你。
五、安全性：Cookie 本地存储 + 安全模式 + 完全开源
本段核心问题：让 Agent 管理我的 Twitter、小红书 Cookie 安全吗？会不会被上传到某个服务器？
答案：Cookie 永远只存在你的本地电脑，Agent Reach 的代码完全开源，你可以自己审查。
具体安全措施如下：
“
⚠️ 重要封号风险提醒：使用 Cookie 登录的平台（Twitter、小红书、Reddit 等），通过脚本/API 调用存在被平台检测并封号的风险。请务必使用专用小号，不要用你的主账号。原因有二：
平台可能检测到非正常浏览器的 API 调用行为，导致账号被限制或封禁。 Cookie 等同于完整登录权限，用小号可以在凭据泄露时限制影响范围。
作者反思： 我一开始设计的时候，考虑过把 Cookie 加密后存储，但后来觉得过度设计反而增加复杂度。最简单、最透明的做法就是明文存本地，让用户自己知道文件在哪。如果你不放心，可以自己用 GPG 加密那个文件，Agent 调用前再解密——Agent Reach 不阻止你这么做。另外，我强烈建议使用小号，这不仅是安全建议，也是我对用户负责的态度。任何声称“用主账号也绝对安全”的工具都是在撒谎。
六、快速上手：OpenClaw 用户需要先做一件事
本段核心问题：我用的 Agent 是 OpenClaw，直接复制安装命令就可以了吗？还是需要额外配置？
OpenClaw 用户注意：OpenClaw 默认使用 messaging 工具配置，该配置不允许 Agent 执行 shell 命令（比如 pip install、twitter search）。Agent Reach 依赖这些命令来安装和使用上游工具。所以安装前必须开启 exec 权限：
openclaw config set tools.profile "coding"
或者在 ~/.openclaw/openclaw.json 中设置：
{
"tools": {
"profile": "coding"
}
}
设置后重启 Gateway：
openclaw gateway restart
然后开启一个新对话，再粘贴安装命令。
其他平台（Claude Code、Cursor、Windsurf、Codex 等）不受此限制，因为它们默认就允许执行命令。
安装命令（通用）：
帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
如果你担心安全问题，可以用安全模式：
帮我安装 Agent Reach（安全模式）：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
安装时使用 --safe 参数
安全模式下，Agent 不会自动运行 sudo apt install 或 brew install，只会告诉你“需要安装 Node.js，请手动运行 brew install node”。
七、装好就能用的实际案例（无需任何配置）
本段核心问题：安装完成后，我马上就能让 Agent 做什么？能不能给几个具体的、有用的例子？
以下所有命令都不需要你手动输入，你只需要用自然语言对 Agent 说出需求，Agent 会自己调用对应的命令。但为了让你理解背后的机制，我列出 Agent 实际会执行的内容。
1. 读任意网页（使用 Jina Reader）
你说： “帮我总结一下这个网页：https://example.com/article”
Agent 执行：
curl https://r.jina.ai/https://example.com/article
返回干净的 Markdown 格式文本，没有广告和杂乱标签。
2. 提取 YouTube 字幕
你说： “这个视频讲了什么？https://youtube.com/watch?v=abc123”
Agent 执行：
yt-dlp --dump-json "https://youtube.com/watch?v=abc123" | jq '.subtitles'
然后读取英文字幕（或自动选择可用语言），生成摘要。
3. 搜索 GitHub 仓库
你说： “搜一下 GitHub 上有什么好用的 LLM 框架”
Agent 执行：
gh search repos "LLM framework" --limit 10
返回仓库名、描述、星数。
4. 读一条公开推文（无需登录）
你说： “帮我看看这条推文：https://twitter.com/elonmusk/status/123456”
Agent 执行：
twitter tweet "https://twitter.com/elonmusk/status/123456"
返回推文全文、回复数、转发数。
5. 订阅一个 RSS 源
你说： “帮我订阅这个 RSS，看看最新文章：https://news.ycombinator.com/rss”
Agent 执行：
python3 -c "import feedparser; feed = feedparser.parse('https://news.ycombinator.com/rss'); print(feed.entries[0].title)"
作者反思： 你可能注意到了，Agent Reach 没有发明任何新的命令语法。它只是把业界已经成熟的开源工具（curl、yt-dlp、gh、twitter-cli 等）通过一个 SKILL.md 文件告诉 Agent：“当你遇到 X 类型的任务时，就用 Y 命令”。这很像给新员工一份“内部操作手册”。你不需要培训 Agent，它自己读手册。
八、卸载与清理
本段核心问题：如果我不想用了，怎么彻底删除 Agent Reach 以及它保存的 Cookie？
运行：
agent-reach uninstall
它会删除：
-
~/.agent-reach/整个目录（含所有 token 和 Cookie） -
各 Agent 的 skill 文件（如 ~/.claude/skills/agent-reach/） -
mcporter 中自动添加的 MCP 配置
如果你只想预览会删除什么，不实际删除：
agent-reach uninstall --dry-run
如果你想保留 Cookie 配置，只删除 skill 文件（比如重装时用）：
agent-reach uninstall --keep-config
最后，卸载 Python 包本身：
pip uninstall agent-reach
九、常见问题（FAQ）——基于真实用户提问
Q1：Agent Reach 完全免费吗？会不会有隐藏的 API 费用？
A：100% 免费。所有上游工具都是开源且不需要付费 API Key 的（Jina Reader、yt-dlp、twitter-cli、rdt-cli、Exa 等）。唯一可能产生费用的是：如果你把 Agent 部署在海外服务器上且需要访问 B 站，可能需要一个住宅代理（约 $1/月）。本地电脑不需要代理。
Q2：我和 Claude Code / Cursor / Windsurf 兼容吗？
A：兼容。任何能运行 shell 命令的 AI 编程 Agent 都可以用。只需 pip install agent-reach 然后运行 agent-reach install，Agent 就能立即调用上游工具。OpenClaw 需要先开启 exec 权限（见第六节）。
Q3：Reddit 返回 403 错误怎么解决？
A：Reddit 自 2024 年起强制要求认证。运行 rdt login（Agent Reach 安装时会自动装 rdt-cli），它会尝试从你的浏览器自动提取 Cookie。如果自动提取失败，用 Cookie-Editor 导出 Cookie 后手动配置。
Q4：怎么让 Agent 读小红书笔记？
A：安装 xhs-cli（pipx install xiaohongshu-cli），然后运行 xhs login 用 Cookie 登录。之后 Agent 就能用 xhs read NOTE_ID 阅读详情。不需要 Docker。
Q5：Twitter 搜索功能需要付费 API 吗？
A：不需要。Agent Reach 使用 twitter-cli 通过 Cookie 认证，完全免费。安装后确保你的浏览器已登录 x.com，然后运行 twitter search "关键词" 即可。
Q6：安装失败或者某个渠道不工作怎么办？
A：运行 agent-reach doctor，它会逐一检查每个上游工具是否安装、配置是否正确，并给出具体的修复建议。如果问题依旧，去 GitHub 提 Issue。
Q7：我能自己加一个新渠道吗（比如知乎）？
A：可以。每个渠道就是一个独立的 Python 文件（放在 channels/ 目录），实现 check() 方法即可。然后让 Agent 在 skill 里增加对应的命令模板。欢迎提 PR。
Q8：Agent Reach 和普通的 pip install 包有什么区别？
A：它不只是 Python 包，而是一个安装编排器。它会自动安装系统依赖（Node.js、gh CLI、twitter-cli 等）、配置 MCP 服务、注册 Agent skill。普通 pip install 只装 Python 库，不会帮你搞定这些周边。
十、一页速览（操作清单）
如果你想在 5 分钟内让 Agent 拥有全网能力，按以下顺序操作：
-
OpenClaw 用户先开 exec 权限（其他 Agent 跳过）
openclaw config set tools.profile "coding"→ 重启 Gateway → 新对话 -
复制安装命令给你的 Agent
帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md -
等待 Agent 自动完成（约 2-5 分钟，取决于网络）
-
运行诊断（可选）
在 Agent 对话中说：“运行agent-reach doctor看看状态” -
配置需要登录的平台（按需）
-
Twitter：浏览器登录 → Cookie-Editor 导出 → 发给 Agent “帮我配 Twitter” -
小红书：同上 -
Reddit： rdt login或 Cookie-Editor -
GitHub： gh auth login
-
-
开始使用
直接对 Agent 说：“帮我搜索推特上的最新 AI 新闻”“总结这个 YouTube 视频”“读一下这篇小红书笔记” -
更新（未来某天）
帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md
十一、作者后记：为什么我每天在用，也值得你 Star
本段核心问题：这个项目会长期维护吗？我为什么要信任它？
这个项目是我纯 vibe coding 出来的——就是我自己每天都在用，遇到痛点就随手加一个渠道，渐渐地它变成了一个完整的脚手架。我不靠它赚钱，也不想做成一个闭源的商业产品。
-
我会一直维护，因为我自己离不开它。我的 Claude Code 每天要读几十条推文、看十几个 YouTube 视频、搜 GitHub 仓库……没有 Agent Reach，我每个新环境都要重新折腾一遍。 -
平台封了我就修。Twitter 改版、Reddit 强化反爬、B 站屏蔽海外 IP——这些变化我会持续跟进，更新底层工具版本或更换替代方案。 -
新渠道会陆续加。如果你有想接入的平台（比如知乎、即刻、豆瓣），直接提 Issue 或 PR，我会尽快评估。
给项目点个 Star ⭐，下次你换新电脑、新 Agent 的时候，能快速找到它。
十二、实用摘要（核心要点回顾）
最终的一句话总结：Agent Reach 不是让你去学新工具，而是让你的 Agent 自动学会用已有的开源工具。你只需要说话，它干活。
