前言¶
给 AI 代理派活时经常遇到一件事：模型自己看不到互联网。让它「搜一下推特上对这个库的讨论」「把这个 B 站视频的内容整理出来」，它要么编造，要么只能给出泛泛的回答。常见做法是自己攒脚本：临时写 curl 请求、调 yt-dlp 抓字幕、再拼一个搜索接口。每个平台一套逻辑，换个平台就要重写一遍，而且代理侧没有统一的触发和诊断方式。
下面介绍的 Agent Reach 就是把这套「搜索 + 读取」能力打包成一个 SKILL.md 格式的 Skill：代理读到指令后，按内置的用法调用对应平台的工具命令，并能用一条诊断命令检查各渠道是否可用。
这是什么¶
Agent Reach 是一个面向 AI 代理的 Skill，坐标 @clawhub_panniantong/agent-reach，由 panniantong 维护，发布在 ClawHub（OpenClaw 生态的技能市场），同时同步在 SkillHub，分类 ai-agent。当前版本 v1.1.0，License MIT-0。它的定位是一句话：给你的 AI 代理装上眼睛，让它看到整个互联网。
SkillHub 页面记录的热度数据：评分 100000，下载 97965 次，安装 2479 次。简介声称 7500+ GitHub 星标，这一点来自发布者的自述，未经我们独立核对。
它解决的问题很具体：把 Twitter/X、Reddit、YouTube、GitHub、哔哩哔哩、小红书等平台的搜索与读取命令固化进 Skill，代理拿到用户请求后按图索骥，不需要临时发明轮子；同时通过 agent-reach doctor 提供统一的健康检查入口。
核心能力¶
已从上游 SKILL.md 核实的能力如下：
1、任意网页读取：通过 Jina Reader 抓取并转成文本。
2、网页搜索：基于 Exa 的 web_search_exa 和面向代码场景的 get_code_context_exa。
3、Twitter/X：搜索推文、读取单条（支持 /status/ 与 /article/）、拉取用户时间线、展开完整 thread，工具名为 xreach。
4、YouTube 与哔哩哔哩：用 yt-dlp 取视频元数据、下载字幕（支持 zh-Hans/zh/en）、按关键词搜索。
5、Reddit：读取版块热帖和搜索结果（官方 JSON 接口）。
6、GitHub：通过 gh CLI 搜仓库、看仓库、搜代码、查 issue。
7、小红书：搜索笔记、取笔记详情、拉取全部评论，甚至支持发布内容（需登录）。
8、抖音：解析视频信息、取下载链接（不需要登录）。
9、微信公众号文章：用 miku_ai 搜索、用 Camoufox 读取正文。
10、LinkedIn：查个人资料、搜人。
11、RSS：用 feedparser 读订阅源。
所有命令均以 JSON 输出，方便代理解析。
安装与启用¶
安装有两条路径，取决于你从哪个入口接入。
入口一：ClawHub（OpenClaw 生态）安装。官方页面给出的命令是：
openclaw skills install @panniantong/agent-reach
这条命令会把 Skill 本体装进 OpenClaw 的 agent 体系。
入口二：从上游仓库独立安装。官方安装文档（install.md）描述的是 1.6 系列的做法，先装 uv，再用 uv tool 安装发布包：
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install https://github.com/Panniantong/Agent-Reach/releases/latest/download/agent-reach.zip
agent-reach setup
agent-reach setup 会打开默认渠道并安装 agent skill。装完如果提示 agent-reach: command not found，执行 uv tool update-shell 并重开 shell。1.5 及更早版本是用 pipx/pip 装的，升级路径是 uv tool install --force ... 后再跑一次 agent-reach setup，官方文档强调配置和密钥都会保留。
启用后的维护命令：
agent-reach doctor # 检查各渠道可用性并给出修复指引
agent-reach add <channel> # 追加一个平台渠道
agent-reach remove <channel>
agent-reach configure groq-key # 配置需要密钥的渠道（密钥由用户输入）
agent-reach update
两个注意点，都来自官方文档：
1、PyPI 上有个同名包 agent-reach，官方明确说那不是本项目，不要用 pip 装，只认上面 GitHub Releases 的 zip。
2、不要往 agent 工作区写文件。临时输出放 /tmp/，持久数据放 ~/.agent-reach/。
关于宿主环境：ClawHub 页面写明该 Skill 属于 OpenClaw 生态，openclaw skills install 面向 OpenClaw agent；独立安装路径依赖 uv。资料中没有给出 Cursor、Codex CLI、Claude Code 的具体适配说明，这几种环境是否可直接使用，我们无法核实，不做断言。
典型用法¶
以下示例均来自上游 SKILL.md，可直接复现。
读取任意网页：
curl -s "https://r.jina.ai/URL"
Exa 搜索：
mcporter call 'exa.web_search_exa(query: "query", numResults: 5)'
Twitter/X 搜索与读取：
xreach search "query" -n 10 --json
xreach tweet URL_OR_ID --json
xreach thread URL_OR_ID --json
YouTube 字幕（下载到 /tmp 后读 .vtt）：
yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --skip-download -o "/tmp/%(id)s" "URL"
哔哩哔哩同样用 yt-dlp，注意服务器 IP 可能收到 412，官方建议用 --cookies-from-browser chrome 或配置代理。
Reddit：
curl -s "https://www.reddit.com/r/SUBREDDIT/hot.json?limit=10" -H "User-Agent: agent-reach/1.0"
服务器 IP 可能被 403，此时官方建议改用 Exa 搜索或配置代理。
GitHub：
gh search repos "query" --sort stars --limit 10
gh issue list -R owner/repo --state open
小红书：
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 导入 cookies。
微信公众号文章是唯一不能用 Jina Reader 或 curl 直读的渠道，必须走 Camoufox：
cd ~/.agent-reach/tools/wechat-article-for-ai && python3 main.py "https://mp.weixin.qq.com/s/ARTICLE_ID"
RSS：
import feedparser
for e in feedparser.parse('FEED_URL').entries[:5]:
print(f'{e.title} — {e.link}')
适用场景与注意事项¶
适合谁：在 OpenClaw 生态里做 agent 的开发者，或者愿意用 uv 独立装命令行工具、让自家代理按 SKILL.md 执行任务的开发者。如果你需要的是「一个脚本定时跑监控」，这不是它的目标场景。
限制和坑：
1、平台反爬是真实存在的。Reddit 对服务器 IP 直接 403，B 站可能 412，Twitter 抓取失败时官方指引是 npm install -g undici 或 agent-reach configure proxy URL。这些渠道在云服务器上大概率需要代理。
2、部分渠道有登录门槛（小红书、LinkedIn），需要人工导 cookies；部分渠道需要密钥（如 Groq 用于小宇宙转录）。用户只提供凭据，其余配置由代理完成。
3、SkillHub 记录的安装量是 2479 次，但简介里「7500+ GitHub 星标」等说法来自发布者，数据未独立验证。
4、版本信息有错位：ClawHub 页面显示当前版本 v1.1.0，而官方 install.md 已按 1.6 的命令格式（JSON 输出、agent-reach doctor 等）编写。使用前以 agent-reach version 的实际输出为准。
5、该 Skill 的工作方式是代理在本地执行命令行工具，本质是「命令汇编 + 触发词」，不是云端 API。如果你的场景要求严格的出网管控，需要把上面每条命令的出网目标列入白名单。
结尾¶
Agent Reach 的价值在于把 13 个以上平台的搜索与读取命令整理成一份代理可直接照做的 SKILL.md，并附上统一的安装、诊断和渠道增删入口，省掉了自己攒脚本的重复劳动。配合 agent-reach doctor，渠道挂了能快速定位。
官方地址：
- SkillHub 页面：https://www.skillhub.cn/skills/clawhub_panniantong/agent-reach
- 上游仓库（ClawHub）：https://clawhub.ai/panniantong/agent-reach
- 官方安装文档：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
