AI Agent 能写代码、改文档、管项目,但一旦需要上网查资料就容易出问题:YouTube 拿不到字幕、Twitter API 要付费、Reddit 被 403、小红书要登录、B站有风控。Agent Reach 就是为了解决这个问题而生的开源工具,让 Agent 能轻松读取和搜索主流平台内容。
项目概况
Agent Reach 由开发者 Panniantong 维护,采用 MIT 许可证,目前已有 70,000+ GitHub Star、5,900+ Fork,曾登上 GitHub Trending 榜单。
解决什么问题
每个内容平台都有自己的访问门槛:
| 平台 | 常见障碍 |
|---|---|
| YouTube | 拿不到字幕 |
| Twitter/X | API 要付费 |
| 服务器 IP 被拒(403) | |
| 小红书 | 必须登录才能查看 |
| B站 | 通用下载工具被风控拦截 |
| 网页 | 抓回来一堆 HTML 标签,无法阅读 |
Agent Reach 把这些痛点统一解决,变成一句话即可调用。
安装方式
把以下命令复制给任意 AI Agent(Claude Code、OpenClaw、Cursor 等):
帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
更新同样简单:
帮我更新 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md
安装完成后运行 agent-reach doctor 即可查看每个渠道的状态。
支持的平台
| 平台 | 功能 |
|---|---|
| 网页阅读 | 任意网页 |
| YouTube | 字幕提取 + 视频搜索 |
| RSS | 阅读任意 RSS/Atom 源 |
| 全网搜索 | 语义搜索(MCP 接入,免费) |
| GitHub | 读公开仓库 + 搜索私有仓库、提 Issue/PR |
| Twitter/X | 读单条推文,搜索、浏览时间线、读长文 |
| B站 | 搜索 + 视频详情字幕 |
| 搜索 + 读帖子和评论 | |
| 搜索、主页、Feed | |
| 用户搜索、Profile、帖子 | |
| 小红书 | 搜索、阅读、评论 |
| 读公开页面、Profile 详情、职位搜索 | |
| V2EX | 热门帖子、帖子详情 |
| 雪球 | 股票行情、搜索股票 |
| 小宇宙 | 播客音频转文字 |
设计理念
Agent Reach 的定位是能力层,不是具体工具。它负责选型、安装、体检、路由,不负责底层读取——读取由 Agent 直接调用上游工具完成。
每个平台都维护一个「首选 + 备选」的有序后端列表。换接入方式只需调整列表顺序,不需要重写代码。某个接入方式失效时会自动切换到备选方案。
例如:2026 年 6 月,yt-dlp 被 B 站风控封杀,Agent Reach 迅速切换到 bili-cli,用户无感知。
安全性
| 措施 | 说明 |
|---|---|
| 凭据本地存储 | Cookie、Token 只存在本机 ~/.agent-reach/config.yaml,权限 600 |
| 默认安全 | 默认安装不修改系统,只有 --system 参数才安装外部工具 |
| 完全开源 | 代码透明,可随时审查 |
| Dry Run | --dry-run 预览所有操作,不做改动 |
| 可插拔架构 | 不信任某组件可单独替换 |
⚠️ 注意:使用 Cookie 登录的平台(Twitter、小红书等),通过脚本调用存在被平台检测并封号的风险,建议使用专用小号而非主账号。
使用示例
安装完成后直接告诉 Agent:
- "帮我看看这个链接" → 读任意网页
- "这个 GitHub 仓库是做什么的" → 查看仓库信息
- "这个 YouTube 视频讲了什么" → 提取字幕
- "B站搜一下 AI 教程" → 搜索视频
- "搜一下 LLM 框架对比" → 全网语义搜索
- "订阅这个 RSS" → 解析订阅源
需要登录的平台(小红书、Twitter、Reddit、Facebook、Instagram),告诉 Agent "帮我配 XXX" 即可。
上手建议
Agent Reach 默认只激活 6 个零配置渠道(网页、YouTube、RSS、GitHub、B站搜索、全网搜索)。需要登录态的平台会在安装时列出菜单,按需配置即可。
安装命令:
agent-reach install --env=auto # 安全检查
agent-reach install --env=auto --system # 允许修改系统
agent-reach install --dry-run # 只预览不改动
卸载:
agent-reach uninstall
GitHub 项目地址:https://github.com/Panniantong/Agent-Reach