Claude Code、Cursor 这类 AI agent 写代码已经很熟练，但让它去网上找点东西，常常卡住：推特的 API 要付费，Reddit 拒绝服务器的请求，小红书必须登录，B 站会拦下载工具，网页抓回来是一堆 HTML 标签。
Agent-Reach 解决的就是这个问题。它是一个开源项目，今年 2 月在 GitHub 建仓，现在接近 9 万星，10 月 4 日又一次冲上 trending，当天涨了 1,696 星。装好以后，你对 agent 说一句「帮我看看推特上大家怎么评价这个产品」，agent 就能自己去搜。官方列出的平台有 16 个，包括网页、X、Reddit、YouTube、B 站、小红书、GitHub、V2EX、RSS、LinkedIn 和小宇宙播客。
本文先讲它是怎么做到的，再讲它比自己一个个装工具好在哪里，最后附上我在本机逐个渠道的实测结果，以及用之前要注意的几件事。我从 4 月开始用它，最近一周每天用它跑选题调研。
agent 联网难在每个平台都有自己的门槛
让 agent 读一个平台的内容，技术上都不难，难的是每个平台的门槛都不一样：
| 平台 | 门槛 |
|---|---|
| X | 官方 API 要付费 |
| 匿名接口已经封了，服务器 IP 直接返回 403 | |
| 小红书 | 不登录看不了 |
| B 站 | 通用下载工具 yt-dlp 在 6 月被风控拦截，返回 412 |
| YouTube | 网页上看不到字幕原文，要专门的工具提取 |
| 网页 | 直接抓回来是 HTML，agent 读起来浪费 token |
每个门槛社区里都有人做了绕过的工具，比如读 X 的 twitter-cli、读 Reddit 的 rdt-cli、读 B 站的 bili-cli。问题在于这些工具散落在各处，各有各的安装方式和登录方式，而且隔几个月就有一批停更或者被平台封掉。自己维护一套，要不停地换工具。
Agent-Reach 不抓数据，只管选工具和装工具
Agent-Reach 的 README 里有一句话说明了它的定位：它是一个能力层，负责选型、安装、体检和路由，不负责底层读取。真正去读推特、读 Reddit 的，还是上面那些上游工具，agent 直接调用它们，中间没有包装层。
它具体做三件事：
- 替你挑工具。每个平台在仓库里对应一个文件，里面是一张按优先级排好的工具列表。
- 替你装工具，并且写一份 SKILL.md 放进 agent 的 skill 目录。agent 读了这份说明，就知道「搜推特用
twitter search，读 Reddit 用rdt read」，不需要你记命令。 - 替你体检。
agent-reach doctor逐个检查这些工具能不能用，坏了的给出修复命令。
当前的选型是这样的：
| 平台 | 首选 | 备选 |
|---|---|---|
| 网页 | Jina Reader | |
| X | twitter-cli | OpenCLI、bird |
| OpenCLI | rdt-cli | |
| B 站 | bili-cli | OpenCLI、搜索 API |
| 小红书 | OpenCLI | xiaohongshu-mcp、xhs-cli |
| YouTube | yt-dlp | |
| GitHub | gh | |
| 全网搜索 | Exa |
优势一：安装是一句话，不用查文档
安装方式是把下面这句话直接发给你的 agent：
帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
agent 会去读这份安装文档，自己执行剩下的步骤：装 agent-reach 命令行，检查 Node.js、gh 这些依赖，判断你是在本地电脑还是服务器上，最后注册 SKILL.md。默认只开 6 个不用登录的渠道，X、Reddit、小红书这些要登录的，agent 会列出来问你要哪几个。
这种「把安装文档交给 agent 执行」的方式，比给人看的 README 省事很多。需要配置某个平台时也一样，对 agent 说「帮我配 Twitter」，它会一步步引导你。
优势二：平台封了一条路，换下一条
每个平台都是「首选 + 备选」的列表，这是 Agent-Reach 和自己装一套工具最大的区别。
README 里有一个真实的例子：6 月 B 站开始拦截 yt-dlp，返回 412。Agent-Reach 把 B 站的首选后端换成了 bili-cli，用户更新以后就能继续用，不用自己去找替代品。README 里还提到，3 月有一批单平台命令行工具集体停更，他们也是这样换掉的。
doctor 会告诉你每个平台当前走的是哪个工具，哪个工具没通、怎么修。
上图左边是我本机装的 1.4.0 版，右边是最新代码。两边的格式一样，每个渠道一行状态。新版的检查更严格，后文会讲。
优势三：免费、本地运行、哪个 agent 都能用
- 免费：用到的工具都开源，接口都免费。只有部署在服务器上时，部分平台要配代理，README 估计每月 1 美元左右。
- 本地：cookie 和 token 只存在本机的
~/.agent-reach/config.yaml，文件权限是 600。 - 不挑 agent：它只依赖 agent 能执行命令行，所以 Claude Code、Cursor、Windsurf、OpenClaw 都能用。安装时会同时写进几个 agent 的 skill 目录。
8 个渠道的本机实测
10 月 4 日我按 SKILL.md 里的命令，在本机逐个跑了一遍：
| 渠道 | 结果 | 耗时 | 备注 |
|---|---|---|---|
| 网页（Jina Reader） | 成功 | 1.0s | 返回干净的 Markdown |
| GitHub（gh） | 成功 | 1.2s | |
| Reddit（rdt-cli） | 成功 | 3.5s | 中途一次 SSL 错误，自动重试后拿到 10 条 |
| YouTube（yt-dlp） | 成功 | 2.2s | |
| V2EX | 成功 | 0.5s | |
| B 站（bili-cli） | 成功 | 1.3s | 默认搜用户，搜视频要加 --type video |
| X（twitter-cli） | 失败 | 0.2s | 旧版文档里的参数写法过时了，见下文 |
| 全网搜索（Exa） | 失败 | 0.3s | 要单独配置，doctor 会给出命令 |
再加上这一周做选题调研的实际体验：直接请求 reddit.com 一律返回 403，走 Agent-Reach 装的 rdt-cli 就能拿到帖子和评论；B 站、YouTube、网页这几个渠道没有出过问题。X 是最不稳定的，连续拉十个左右的账号就会被限流。
使用前要注意的几件事
实测里也发现了几个问题，用之前最好知道：
- 装完不会自动更新。我本机是 4 月装的 1.4.0，到现在最新代码已经多了 126 个提交。旧版 SKILL.md 里写的 X 搜索参数是
--limit，而现在的 twitter-cli 只认-n，agent 照着执行就会报错，上表 X 失败就是这个原因。旧版的doctor每运行一次还会重写 skill 文件，新版已经改成只读检查。更新方式是对 agent 说「帮我更新 Agent Reach」，附上 update.md 的链接。 - X 默认会用你浏览器里登录的账号。twitter-cli 在没设置
TWITTER_AUTH_TOKEN和TWITTER_CT0两个环境变量时，会自动从 Chrome、Firefox 等浏览器里读 cookie。我本机没设过，它从 Chrome 里读出了 17 个 cookie。Agent-Reach 的 README 专门提醒过，用 cookie 登录的平台有被封号的风险，要用小号。想用小号，就把小号的 cookie 设进这两个环境变量。 - 新旧版本的体检结果不一样。同一台机器上，旧版报 10 个渠道可用，新版只报 6 个。新版不再实际调用 X、Reddit、小红书的登录检查，因为那几个上游工具在检查时也会去读浏览器 cookie，所以只标成「已装但需配置」。
适合谁用
| 你的情况 | 建议 |
|---|---|
| 想让 agent 读网页、看 YouTube 字幕、搜 GitHub | 直接装，这几个渠道不用登录，开箱可用 |
| 要做调研，需要 Reddit、B 站、V2EX 的内容 | 值得装，比自己一个个找工具省事 |
| 需要搜 X 或小红书 | 可以用，但先准备一个小号，把 cookie 配进去 |
| 已经装过 | 先 agent-reach --version 看版本，旧的就更新一次 |
Agent-Reach 的价值不在某个具体的抓取技术，而在它替你维护了一张「每个平台现在用什么工具最稳」的表，并且把这张表写成了 agent 能直接读懂的说明书。平台的封锁会一直变，这张表也会一直改，所以装上之后，记得隔一段时间更新一次。
资料来源：Panniantong/Agent-Reach（README、docs/install.md）；public-clis/twitter-cli；public-clis/rdt-cli；public-clis/bilibili-cli。本文所有命令输出来自本机实测，涉及账号和路径的内容已脱敏。
