前言¶
做全网调研时，Agent 手里往往只有通用搜索可用。小红书、B 站、微信公众号、RSS 这些平台要么没有现成接口，要么得自己写爬虫和解析。等你把登录态、Cookie、代理都配好，话题已经变了。
Agent Reach 走的是另一条路：把 14 类平台的上游工具统一安装好，Agent 拿到的是可以直接执行的命令或接口调用，不需要临时造轮子。下面介绍它的能力、安装方式和典型用法。
这是什么¶
Agent Reach 是一个面向 AI Agent 的互联网调研 Skill，定位是「给 Agent 装上眼睛」。由 panniantong 发布维护，上游仓库在 GitHub（github.com/Panniantong/agent-reach），License 为 MIT-0。
它解决的问题很具体：Agent 需要在网上查证话题、读网页、搜平台讨论时，缺少可执行的读取工具。Skill 本体只负责把内容取回来，报告撰写等后续加工不在它的职责内。
版本口径需要说明：ClawHub 页面显示 v1.1.0，上游安装文档已按 1.6 描述（JSON 输出、uv 安装）。以你实际安装到的版本为准。
核心能力¶
-
平台覆盖。官方页面列出的渠道包括：Twitter/X、Reddit、YouTube、GitHub、哔哩哔哩、小红书、抖音、微博、微信公众号、LinkedIn、Instagram、RSS、Exa 网页搜索，以及任意网页。清单随版本变化，可用
agent-reach doctor查当前实际可用渠道。 -
统一的取数方式。每个平台对应一段可直接执行的命令或
mcporter调用，Agent 不需要理解爬虫细节，照着 SKILL.md 里的用法调用即可。 -
零配置与诊断。默认渠道安装后即用；
agent-reach doctor输出各渠道状态和修复指令，渠道不通时先看这里。 -
工作区规则明确。临时输出写
/tmp/，持久数据和配置写~/.agent-reach/，不在 Agent 工作目录里建文件。
安装与启用¶
这条命令把 Skill 装进 OpenClaw 生态：
openclaw skills install @panniantong/agent-reach
也可以走上游安装器，适合需要完整 CLI 工具链的场景。先确认 uv 是否可用：
uv --version
缺 uv 的话先装它（macOS / Linux）：
curl -LsSf https://astral.sh/uv/install.sh | sh
然后安装并初始化：
uv tool install https://github.com/Panniantong/Agent-Reach/releases/latest/download/agent-reach.zip
agent-reach setup
setup 会开启默认渠道并安装 Agent Skill。装完找不到命令，执行 uv tool update-shell 后重开终端。后续用 agent-reach update 更新；从 1.5 及更早版本升级，官方文档给出的做法是 uv tool install --force 同一地址后重跑 agent-reach setup，密钥和配置会保留。
一个坑：PyPI 上有个叫 agent-reach 的包不是这个项目，官方明确要求不要用，只认上面 GitHub Release 的地址。
典型用法¶
先看渠道状态，这一步决定后面哪些命令能用：
agent-reach doctor
读任意网页。Jina Reader 把页面转成纯文本：
curl -s "https://r.jina.ai/URL"
网页搜索走 Exa：
mcporter call 'exa.web_search_exa(query: "query", numResults: 5)'
Twitter/X 搜索与读帖，用 xreach：
xreach search "query" -n 10 --json
xreach tweet URL_OR_ID --json
xreach tweets @username -n 20 --json
xreach thread URL_OR_ID --json
YouTube 和 B 站都走 yt-dlp。下载字幕不下载视频：
yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --skip-download -o "/tmp/%(id)s" "URL"
B 站视频可能返回 412，官方建议加 --cookies-from-browser chrome 或配代理。
Reddit 直接调 JSON 接口，记得带 User-Agent：
curl -s "https://www.reddit.com/search.json?q=QUERY&limit=10" -H "User-Agent: agent-reach/1.0"
GitHub 走 gh CLI：
gh search repos "query" --sort stars --limit 10
gh search code "query" --language python
gh issue list -R owner/repo --state open
小红书走 mcporter：
mcporter call 'xiaohongshu.search_feeds(keyword: "query")'
mcporter call 'xiaohongshu.get_feed_detail(feed_id: "xxx", xsec_token: "yyy", load_all_comments: true)'
注意这条链路需要登录，要用 Cookie-Editor 导入 Cookie。
微信公众号是个特例，Jina Reader 和 curl 都读不了，必须走内置的 Camoufox 绕过反爬：
cd ~/.agent-reach/tools/wechat-article-for-ai && python3 main.py "https://mp.weixin.qq.com/s/ARTICLE_ID"
RSS 用 feedparser 解析：
python3 -c "
import feedparser
for e in feedparser.parse('FEED_URL').entries[:5]:
print(f'{e.title} — {e.link}')
"
频道增减和密钥配置：
agent-reach add <channel> # 比如 add Xiaohongshu
agent-reach remove V2EX
agent-reach configure groq-key
agent-reach configure proxy URL
适用场景与注意¶
适合这几类场景：话题全网调研、看某平台的讨论走向、搜索 GitHub 仓库与 issue、抓 YouTube/B 站字幕、读公众号长文、聚合 RSS。
几个已知限制，按官方文档如实列出：
- 服务器 IP 在 Reddit 可能 403、在 B 站可能 412，需要代理或浏览器 Cookie，不是配置错误。
- 小红书、Twitter 等渠道依赖登录态，Cookie 失效后渠道会静默失败，先跑
agent-reach doctor。 - 微信公众号只有 Camoufox 一条路，Jina Reader 和 curl 均无效。
- 平台清单在不同来源口径不一（官方页面写 14 类，任务资料写 16 类），以安装后
agent-reach doctor的输出为准。 - 评分和下载数各来源统计不一致，本文未采用，需要时去 ClawHub 页面自行核对。
- 上游 SKILL.md 的用法指南里含
xiaohongshu.publish_content这类发布接口，是否开放写操作由你按需配置。
结尾¶
Agent Reach 的价值在于把多平台调研从「先搭环境再查资料」变成「装好就能查」。它不负责写报告，也不替代搜索 API，只是把你取数这一层做厚。
官方地址：https://api.skillhub.cn/org-b6kzcl68/agent-reach
上游仓库：https://github.com/Panniantong/agent-reach
ClawHub 页面：https://clawhub.ai/panniantong/agent-reach
