Agent Reach 免登录实测：5 个通道通了，YouTube 字幕还没通

一句话

Agent Reach 是给 Claude Code、Codex 这类 Agent 接全网读取能力的开源 CLI（MIT 开源，GitHub 10 万星量级）：装完之后，Agent 不用你手写爬虫，就能搜 GitHub、读 V2EX、读网页、B 站热门、全网搜索。本文是在两台机器上亲测过的免登录部分——5 个通道通了，YouTube 字幕没跑通，如实写；登录通道（X、Reddit、小红书等）本次没测，一律不写步骤。

先说清三件事

  • 安装别走 PyPI：PyPI 上那个同名包不是这个项目，官方明确警告不要从 PyPI 装；走 GitHub 发布包（见下）。
  • setup 不等于全绿：实测里 setup 和 doctor 退出码都是 0，但 setup 自己报“还差一步”“默认功能 3/5 准备成功”；doctor 只是无网络状态检查，别把它当成全部通道就绪。
  • 版本与通道会变：本文实测版本 1.6.0；1.6.0 里已经没有 RSS 通道，旧文章提到的 RSS 别再写。默认通道是 github、youtube、bilibili、v2ex、web，其余 9 个为可选或实验通道，多需登录或 Key。

安装步骤（已实测）

  1. 环境：Python 3.10+；建议隔离安装，别装到系统 Python 里。
  2. 建隔离目录并建虚拟环境：python3 -m venv agent-reach-test/venv（InstaBox 机器上系统 venv 缺组件，改用 uv venv，同样不用 sudo）。
  3. 从 GitHub 发布包安装：venv/bin/pip install https://github.com/Panniantong/Agent-Reach/archive/refs/tags/v1.6.0.zip（实测装了 14 个包，agent-reach==1.6.0）。
  4. 初始化并自检：venv/bin/agent-reach setup，再跑 venv/bin/agent-reach doctor；看到 setup 报“3/5 准备成功”属实测原样，不必强求全绿。
  5. 不登录、不输 Key、不绑卡：下面 5 个通道都不需要任何凭证。

5 个已验证通道

  • GitHub（搜仓库、读 README）：agent-reach github search yt-dlp --limit 3 约 2.5 秒出 3 条；agent-reach github read yt-dlp/yt-dlp 返回 README 全文开头。说明：无凭证时 gh 后端会跳过、公共 API 兜底，属预期内。
  • V2EX（热门、读帖）：agent-reach v2ex hot 约 1.2 秒返回 10 条热门；agent-reach v2ex read <帖子链接> 返回正文加多条回复；自检里 hot/node/read/user 四项全部通过。
  • 网页读取：agent-reach web read https://example.com 约 1.4 秒返回完整干净正文；英文维基百科 Python 词条约 4.8 秒同样通。
  • B 站热门：agent-reach bilibili hot 约 2.6 秒返回 10 条真实热门视频（含标题、UP 主、播放量）。
  • 全网搜索：agent-reach web search "python programming language" 在 InstaBox 机器上约 1.5 秒返回 5 条（维基 Python 词条、Python.org 等）。提醒：本机沙箱上同一命令曾超时一次、429 一次，属环境或限流问题，不是每次都通。
  • Agent 接入也跑通了：本机 agy 以非交互模式、HOME 指向测试目录、只用 venv 里的二进制，成功执行了 GitHub 搜索 + V2EX 热门跨平台小任务并汇总，全程无安装、无登录、无测试目录外读写。

没跑通的两项

  • YouTube 字幕（未验证）：两次失败原因不同。本机沙箱上 yt-dlp 报证书验证失败（出口代理问题，脱离 Agent Reach 直接跑 yt-dlp 也一样失败）；InstaBox 机器上 yt-dlp 报 HTTP 429 限流（平台侧 Too Many Requests），按工具“尊重暂停、不循环重试”的提示已停手。家用网络或换时间段可能通，但本文没验过，不写成可用。
  • B 站搜索、读视频、字幕（未验证）：本机上 bili-cli 直连 api.bilibili.com 报 SSL 错误，同样是出口环境问题；字幕按 README 本来就可能要求登录，本次未测登录路径。
  • 不写的内容：RSS（1.6.0 已无此通道）；任何登录通道的步骤（X、Reddit、小红书、Facebook、Instagram、LinkedIn 等，本次未批、未测）；雪球、小宇宙等可选通道（需 add，小宇宙转录还需 Groq Key）。

在 InstaBox 上跑的补充

  • 实测机器：InstaBox 免费机 agent-browser-5glx（4 vCPU / 8 GiB / 20 GiB），免费档永不计费。
  • 休眠两条线：闲置 30 分钟暂停（官方定义：没 Agent 干活、没终端使用、CPU 很低），暂停后状态保留、恢复不到 1 秒；免费档最长运行固定 480 分钟（8 小时），即使活动中也暂停，暂停后有 10 分钟冷却期。
  • instabox auto-suspend <机器名> 0 确实存在，0 表示关闭闲置休眠，但帮助里写明只在付费档有效；免费档别指望靠它实现 7×24。
  • 以后连机器：本机装 CLI 并登录一次后，instabox ssh <机器名> 进交互 shell，instabox exec <机器名> -- <命令> 直接跑命令；登录需浏览器确认一次或用 API key。

出处

  • 项目仓库：Panniantong/Agent-Reach（MIT 开源，实测版本 1.6.0）；
  • 原帖：X 博主 @ozmazzz（2026 年 10 月 24 日）；
  • 实测环境：本机云主机 VM + InstaBox 免费机 agent-browser-5glx，实测日期 2026 年 10 月 25 日；未登录、未输 Key、未付费。