Agent Reach 装完 90 秒，一条 doctor 就能说清这台机器现在能读哪些平台：16 个渠道里只有 3 个直接可用。它的定位是给 AI 装「上网工具」的安装器和体检器，自己不抓数据，抓数据靠 yt-dlp、gh CLI 这些上游工具。

仓库在 GitHub 上有 10 万星，Python 写的，MIT 协议。下面这些都是在 Windows 上真装真跑出来的。

PyPI 上的是老版本，别直接 pip install

先去 PyPI 查了一下：agent-reach 这个包确实存在，但版本只有 0.1.0，而 GitHub main 分支上是 1.5.0，差了十几个版本。

所以照 README 给的地址拿 zip，不要直接 pip install agent-reach，那样会装到老版本。

怎么拿到包

官方给的是 GitHub 的 archive 地址：

curl -sL -o main.zip https://github.com/Panniantong/agent-reach/archive/refs/heads/main.zip

本地直连拿不到，改在服务器上下载：1 秒，672857 字节，sha256 是 2926490de15436dd04ad7edffa37cd79bcdff95a957c9b0561f0eca8a0e0ef2d，解压后目录名 Agent-Reach-main。

这个包已经转存到站内的夸克链接。

怎么装，装了多久

python -m venv venv
venv\Scripts\pip.exe install D:/wb_cache/agentreach-main.zip

全程 90 秒，装出 agent-reach 1.5.0，连带 24 个依赖，里面就有 yt-dlp 2026.8.19 和 rich 15.0.0。

装完 venv\Scripts\agent-reach.exe --version 输出 Agent Reach v1.5.0。

它有哪些命令

命令作用
doctor检查各平台渠道能不能用
install一次性安装器，默认只读检查
setup交互配置向导
configure设置单个配置项
skill注册成 Agent 技能
format清洗平台 API 输出
transcribe音视频转文字
watch健康检查加更新检查
check-update只查更新
uninstall清掉配置、token 和技能文件

doctor 体检：16 个渠道只有 3 个能用

它把每个渠道逐个标状态。我这次见到的状态有四种：

状态例子
可用RSS/Atom 源、Jina Reader 读网页、B站搜索 API
已装但需配置GitHub 渠道，因为没装 gh CLI
未安装YouTube，因为 yt-dlp 不在 PATH
API 连接超时V2EX

最后一行写「3/16 个渠道可用」。另外 9 个只提示要单独装工具才能解锁，我没逐个记下名字。

install 会不会改我的系统

不会。它默认就是只读的，开头明确打出 SAFE MODE 和 skipping automatic system changes。

检查项是 GitHub CLI、Node.js、mcporter 三项，缺哪个就给出对应的安装命令。

不过这里有个小毛病：最后那段渠道状态是 rich 渲染的，管道里跑的时候标记没被解析，输出里直接是 [bold cyan]、[green] 这种原始字符串，看着有点乱。

为什么装在 venv 里它看不见

pip 明明把 yt-dlp 装进了 venv，venv\Scripts\yt-dlp.exe 就在那儿，doctor 却报「yt-dlp 未安装」。

查源码，cli.py 里用的是 shutil.which("yt-dlp")，只认 PATH，不看当前 Python 环境的 Scripts 目录。

装进 venv 等于对它的体检隐身。pipx 和改 PATH 这两条路我都没试，不确定能不能绕过。

常见问题

它自己能抓数据吗

不能。它是选择器加安装器，真正抓取靠 yt-dlp、gh CLI 这些上游工具，它只负责判断哪个能用、然后路由过去。

为什么渠道大部分不可用

因为每个渠道依赖不同的外部工具或登录态。默认只装了 pip 依赖，像 gh CLI、mcporter 这些要单独装，装完 doctor 才会转成可用。

3/16 是不是说明它没用

不是。3 个可用的是 RSS、任意网页、B站搜索，已经能覆盖不少场景。剩下的要按需再装工具，不是一次到位。

能直接用 pip install 吗

能装上，但 PyPI 上是 0.1.0 老版本。要 1.5.0 就得照 README 装 GitHub 的 zip。

适合谁

适合已经在用 AI Agent、想让它能读外部平台内容的人。三个上手顺序：

  • 先跑 doctor，看这台机器现在有几个渠道能用
  • 按缺的工具补装，装完再跑一次 doctor 确认状态变了
  • 别一次装全套，用到哪个装哪个

如果你只需要读 RSS 或者某个固定网页，装它反而绕，直接用 Jina Reader 或 feedparser 就够。