Agent Reach 上手：用一条命令让 AI 智能体读 B站、V2EX、YouTube 字幕和 GitHub
zovo约 4 分钟读完
Agent Reach（MIT，约 10.3 万 star，2026 年 2 月 24 日创建，最新版 v1.6.0 发布于 10 月 23 日，10 月 25 日仍有提交）给 Claude Code、Codex 这类命令行智能体装上读 B站、V2EX、YouTube、GitHub、网页等渠道的能力。本文只讲怎么装、怎么用、怎么排错。核对于 2026 年 10 月 27 日，安装和部分命令在本站 Linux 沙箱实际跑过。
01适用场景
智能体自带搜索和网页读取，但够不着需要登录的平台、视频字幕、中文社区和结构化数据。Agent Reach 把各平台背后的工具装好、测好，统一成 agent-reach <渠道> <动作> 的命令。官方定位只读：只搜索读取，不发帖、不评论、不私信。
02前提
- 能执行终端命令（智能体需开启“允许执行命令”）
- 安装 uv（官方推荐，不需要管理员密码）
- 注意：PyPI 上的 agent-reach 不是本项目，不要用 pip 从 PyPI 装
03方式一：交给智能体
官方推荐直接对智能体说：“帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md”。安装和升级都用这一句。
04方式二：自己装
bash
# 没有 uv 时：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 # 启用默认渠道并安装智能体技能 agent-reach version
装完提示找不到命令时，运行 uv tool update-shell 并开新终端。本站沙箱实测：uv tool install 成功，agent-reach version 返回 1.6.0，安装方式显示 uv。本站没有运行 setup。
05基本用法
bash
agent-reach channels # 列出渠道和动作（输出 JSON） agent-reach github search "agent reach" agent-reach read https://github.com/Panniantong/Agent-Reach # 按链接自动选渠道 agent-reach bilibili search "大模型"
本站沙箱实测：channels 能列出渠道；github search 和 read 返回了 JSON，含仓库简介和 README 文本。所有命令输出一个 JSON 对象，看 ok、items 和 error.hint 判断成败。
06渠道与登录
| 级别 | 渠道（官方 README） | 登录 |
|---|---|---|
| 默认 | bilibili、v2ex、github、youtube、web | 基本无需；B站字幕需扫码；YouTube 转文字需 Groq 或 OpenAI Key |
| 可选 | 小红书、雪球、BOSS、小宇宙、LinkedIn、Reddit | 多数需登录 |
| 实验 | Twitter/X、Facebook、Instagram | 需登录，反爬严，可能随时失效 |
可选渠道对智能体说“帮我加上小红书”即可开启。官方称不替你登录、不要密码，部分平台复用本机浏览器已有登录。
提示安全：建议用小号登录，因为复用的往往是主账号，平台可能限制自动访问；API Key 不要贴进聊天，在自己终端运行 agent-reach configure groq-key。装的内容都在 ~/.agent-reach/，卸载让智能体确认后删除。
07常见失败
- 超时：本站沙箱里 v2ex hot 返回 TIMEOUT（上游 10 秒未应答，可能是网络环境），官方提示出现 TIMEOUT 时不要反复重试或重开登录窗口，先查渠道状态。
- 渠道失效：平台改版是常态，官方用“首选+备选”工具顺序尝试，失败自动换备选。
- 版本：1.5 及更早用 pipx/pip 装的，要按 install.md 的升级流程改用 uv 重装。
- 认准仓库：官方声明本项目没有代币或投资产品，借其名字的加密项目都是骗局。
资料来源（2026-10-27 核对）
本文由 zovo 编辑撰写，转载请注明出处。
DeepSeek
Hy-Memory
Timestral