Agent Reach 使用指南 — 让 AI Agent 读懂小红书、B站、V2EX

它对国内平台的支持是真的

先说这个，因为这是它和 Tavily、Brave 这类工具最大的区别。Agent Reach 由国内开发者维护， 对中文互联网的覆盖不是顺带加的：小红书笔记、B站视频和字幕、V2EX 节点与主题、雪球行情 与讨论、小宇宙播客转文字，都是它明确支持的渠道。

这意味着当您让 Agent 去调研一个话题时，它能真的去翻 B站 和 V2EX，而 不是只在英文网页里打转 — 对做国内市场、看国内舆论的场景，这个差别很大。

Agent Reach 到底是什么

它是一个 MIT 协议的开源项目，本质上是两样东西：一个负责装上游命令行工具的安装器， 加一份告诉 Agent「什么平台该调什么命令」的 skill 文件。

第二部分才是关键。没有它，Agent 收到「看看大家怎么评价 X」这种需求时只能自己瞎猜 — 通常是编一个网址然后被拦。装上之后 Agent 手里有一张路由表：这个平台、用这条命令、 失败了走哪条备选链路。它不再靠猜。

也要说清楚它不是什么：它不是托管服务，不是您去连的 API，也没有什么地址可以填到 设置里。它完全不对外开 HTTP 端口，就是一个 CLI 加一份 skill，都跑在您自己的容器里。

只读，不写

Agent Reach 只做抓取和搜索，不发帖、不评论、不点赞。上游的 skill 文件里写明了这一点。 这是刻意划的边界，不是功能没做完 — 自动化工具去动社交账号的写操作，正是最容易把 账号搞进风控的地方。

托管实例上实测能用的渠道

这部分很多文章写得含糊，这里给实测数字。在 OpenClaw Launch 的标准实例上，CLI 刚装完、 什么都还没配的时候，agent-reach doctor 报的是15 个渠道里 4 个可用，不需要任何 Key 和配置：

• 任意网页 — 通过 Jina Reader 转成干净的 Markdown
• RSS / Atom 订阅源 — 任何源都能读
• V2EX — 热门主题、节点浏览、主题详情，走公开 JSON API
• B站搜索 — 视频搜索，走公开 API

装上 yt-dlp 之后 YouTube 会变成第 5 个，这一步就在下面的安装命令里 — 配置完的实例报的 5/15 就是这么来的。Exa 语义搜索在注册 mcporter 之后可用， 同样在下面的命令里。GitHub 搜索是唯一的例外：需要单独装好并认证 gh CLI，因为 gh auth login 是交互式的，没法在这里脚本化完成。

开始之前该知道的限制

上面这些占了 15 个里的 7 个。剩下 8 个的门槛并不一样，这个区别比数字本身更值得注意：

• 小红书、Twitter/X、Reddit、雪球 — 需要您自己导出的 Cookie。 其中 Reddit 完全没有匿名路径，未登录接口是被封的。
• Facebook 和 Instagram — 只支持桌面端。它们走的是您本人控制的 Chrome 会话，由浏览器扩展驱动。托管的无头 Agent 没有这个环境，所以在托管实例上， 这两个应该当作用不了，而不是当作一项待配置的任务。
• 领英 — 这组里门槛最低的。基础的主页内容通过 Jina Reader 就能读，完全不用登录；只有更复杂的查询才需要 LinkedIn MCP 和登录态。

对需要 Cookie 的那一组，在托管 Agent 上需要两样东西：

• 您自己的 Cookie。从已经登录的浏览器里导出。Agent Reach 不会替您登录， 在服务器上也不会去读您的浏览器会话。
• 住宅代理。托管的 Agent 跑在机房 IP 段上，这些平台对机房 IP 本身就 不信任，Cookie 有效也没用。上游项目建议用每月一美元左右的住宅代理，就是这个原因。 注意这条针对的是服务器部署（比如托管实例）— 在自己电脑上跑 Agent Reach 一般不需要代理。

上游还建议用小号而不是主号去授权，因为平台风控可能会限制表现出自动化访问特征的账号。 这条建议值得认真对待：出问题的代价不是一次请求失败，而是一个账号被限制。

第 15 个是个特例：小宇宙播客转文字不需要登录，也不需要代理，但也不是零配置。它需要 ffmpeg 做音频切片、一个免费的 Groq API Key 做转写，并且要显式安装这个渠道：agent-reach install --system --channels=xiaoyuzhou。

如果您的用途是查资料和读内容 — 文档、文章、论坛帖子、视频字幕、订阅源 — 免配置的那几个渠道已经够用，上面这些都不用管。Cookie 和代理只有在您确实要读社交平台 时才需要折腾。

在 OpenClaw 上安装

先从 Skills 市场安装这个 skill，它会把路由文件和配套的 参考文档放进您的实例。然后 Agent 还需要 CLI 本体。最省事的方式是把这句话发给您的机器人， 让它自己跑上游的安装流程：

帮我安装 Agent Reach：
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

如果您想自己动手：容器里有 Python 但没有 pip，所以走 pipx。Agent 用户有免密 sudo， 下面这些可以直接执行：

sudo apt-get update && sudo apt-get install -y pipx
export PATH="$HOME/.local/bin:$PATH"
pipx install "https://github.com/Panniantong/agent-reach/archive/main.zip"

# 解锁 YouTube 和 Exa 搜索
pipx install yt-dlp
mkdir -p ~/.config/yt-dlp && echo '--js-runtimes node' >> ~/.config/yt-dlp/config
sudo npm install -g mcporter
mcporter config add exa https://mcp.exa.ai/mcp --scope home

# 看看现在哪些渠道通了
agent-reach doctor

agent-reach doctor 这条命令要记住。它会列出每个渠道、当前走的是哪个后端， 以及还没通的渠道该执行什么命令去解锁。

在 Hermes 上安装

Hermes 本身是 Python 的，自带 uv 而不是 pip 或 pipx，所以装法不一样。 另外要注意：yt-dlp 是作为依赖装进工具自己的虚拟环境的，不单独装成工具的话，它的可执行 文件不会暴露出来：

uv tool install "https://github.com/Panniantong/agent-reach/archive/main.zip"
uv tool install yt-dlp
agent-reach doctor

skill 文件要放到 Hermes 自己的 skills 目录，而不是 OpenClaw 的路径。上游没有为 Hermes 准备目标路径：它的安装器按名字识别 OpenClaw、Claude Code 和 OpenCode，识别不到就回退到 通用的 ~/.agents/skills，而 Hermes 并不读这个位置。所以在 Hermes 上是手动 放进去，放好之后就会和其他 skill 一样出现在列表里。

和单一搜索服务的区别

Agent Reach 不是用来替代搜索 API 的，两者解决的问题不一样：

• Tavily、Brave 这类给您一个高质量的通用网页索引，一个 Key 搞定。适合要稳定的排序结果、 并且愿意按次付费的场景。
• Firecrawl、Crawl4AI 这类是抽取引擎，用来把页面内容成规模地结构化提取出来。
• Agent Reach 拼的是覆盖面。当答案在某个具体平台上 — 一条 B站视频、一个 V2EX 帖子、 一份 YouTube 字幕、一个 GitHub 仓库 — 而不是在通用网页索引里，同时您也不想再接 一个计费 API 时，它是那个选项。

这两类是可以叠加的：通用检索交给搜索 API，具体平台的内容交给 Agent Reach。

验证是否真的生效

装完之后，问一个必须走 skill、没法靠瞎猜蒙混过去的问题：

用 agent-reach skill 抓一下 V2EX 当前热门主题，
列出 3 个标题，并说明你用的是哪个后端。

跑对了的样子很好认：Agent 会先打开 skill 文件，按路由表找到对应命令，执行，然后主动说明 自己用的是哪个后端 — skill 里要求它这么做。如果它反过来自己编了个网址，或者说自己 不能上网，那就是 skill 没加载上，需要回头检查安装。

长期维护的一个注意点

这样装上的东西都在容器的可写层里，所以容器一旦重建，这些二进制文件就没了，需要重新安装。 从 Skills 市场装的 skill 会自动恢复，CLI 工具不会。如果哪天 Agent 突然说找不到agent-reach，重装基本就是答案。

要不要装

如果您的 Agent 要做调研 — 读文章、跟论坛讨论、扒视频字幕、盯订阅源 — 而您又不想为此接好几个 API 并付费，那就装。免配置的那几个渠道立刻能用，一分钱不花。

但如果您真正要的就是在托管 Agent 上读小红书、Twitter 或 Reddit，那得掂量一下。这条路 走得通，但绝不是开箱即用：需要您自己的 Cookie、一个住宅代理，以及承担自动化访问带来的 账号风险。先想清楚自己属于哪一种。