Agent Reach：给 AI Agent 一键装上「互联网之眼」，一个 CLI 打通 Twitter、Reddit、B站、小红书
AI Agent 已经能帮你写代码、改文档、管项目——但你让它去网上找点东西，它往往立刻抓瞎：YouTube 拿不到字幕、Twitter API 要付费、Reddit 直接 403、小红书必须登录、B站被风控拦截。每个平台都有自己的门槛，你要一个个踩坑、装工具、调配置。
Agent Reach 正是为解决这一痛点而生的开源项目。它由开发者 Panniantong 于 2026 年 2 月开源，定位是「Agent 的互联网能力层」——一条命令安装，就能让你的 AI Agent 自主读取、搜索全网各大平台的内容。截至本文发布，项目在 GitHub 已收获 9 万+ 星标，并被 Trendshift 评为 GitHub Trending 单日第一。
- GitHub 星标：90,017+
- GitHub 仓库：https://github.com/Panniantong/Agent-Reach
- 许可证：MIT
- 语言：Python（要求 3.10+）
- 作者：Panniantong
- 定位：Agent 联网能力层（capability layer）
一句话简介
Agent Reach 是给 AI Agent 使用的「互联网接口层」：它替你选好、装好、体检好各大平台当前最稳的接入方式，让 Agent 用一个 CLI 就能读网页、搜 Twitter、看 YouTube、刷小红书、查 GitHub，且全链路免费、凭据只存本地。
它的设计哲学很清晰——Agent Reach 是一个能力层，而不是又一个抓取工具。它比具体实现高一层，负责「选型、安装、体检、路由」，真正的读取由 Agent 直接调用上游工具完成，没有额外包装层。
核心功能
1. 一个 CLI 打通 16+ 平台
Agent Reach 把主流内容平台的读取能力收拢到统一的命令行接口下，覆盖中英文互联网：
| 平台 | 装好即用 | 配置后解锁 |
|---|---|---|
| 🌐 网页 | 阅读任意网页 | — |
| 📺 YouTube | 字幕提取 + 视频搜索 | — |
| 📡 RSS | 阅读任意 RSS/Atom 源 | — |
| 🔍 全网搜索 | — | Exa 语义搜索（免费） |
| 📦 GitHub | 读公开仓库 + 搜索 | 私有仓库、提 Issue/PR |
| 🐦 Twitter/X | 读单条推文 | 搜索、时间线、长文 |
| 📺 B站 | 搜索 + 视频详情 | 字幕 |
| 💻 V2EX | 热帖、节点、回复 | — |
| 📈 雪球 | 行情、搜索、热门帖 | — |
| — | 搜索 + 读帖和评论 | |
| 📕 小红书 | — | 搜索、阅读、评论 |
| 📘 Facebook / 📷 Instagram | — | 搜索、主页、Feed |
| 公开页面 | Profile、职位搜索 | |
| 🎯 Boss直聘 | — | 搜索岗位 + JD 全文 |
| 🎙️ 小宇宙播客 | — | 音频转文字（Whisper） |
其中 6 个渠道（网页、YouTube、RSS、V2EX、雪球、B站搜索）零配置开箱即用，需要登录态的平台只需对 Agent 说一句「帮我配 XXX」，它会一步步引导你完成。
2. 「首选 + 备选」多后端路由，平台变了你不用管
这是 Agent Reach 最有价值的工程亮点。每个平台对应一个有序的后端列表，例如：
twitter.py → twitter-cli ▸ OpenCLI ▸ bird
bilibili.py → bili-cli ▸ OpenCLI ▸ 搜索 API
reddit.py → OpenCLI ▸ rdt-cli
xiaohongshu.py → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli
渠道会真实探测每个候选后端（不只是检查命令是否存在），第一个完整可用的当选，坏掉的会给出修复处方。这意味着接入方式换代时，用户只需调整列表顺序，而不是重写代码。2026 年 6 月就有真实案例：yt-dlp 被 B站风控全面封死后，项目切换到 bili-cli，用户零操作。
3. 自带诊断：一条命令看清所有渠道状态
agent-reach doctor
doctor 会告诉你每个渠道当前能不能用、正在走哪条后端路径、缺什么、怎么修。对经常被平台反爬折腾的用户来说，这个功能省去了大量排错时间。
4. 对 Agent 原生友好，兼容几乎所有主流 Agent
Agent Reach 把使用方式设计成「对人一句话，对 Agent 一个链接」。安装只需把下面这句话丢给你的 Agent：
帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
它兼容 Claude Code、OpenClaw、Cursor、Windsurf 等任何能执行 shell 命令的 Agent。安装后 Agent 会读取自带的 SKILL.md，自己知道该调用什么命令，你不需要记忆任何 CLI 语法。
5. 安全优先：凭据本地存储 + 默认只读检查
- 凭据本地化：Cookie、Token 只存在本机
~/.agent-reach/config.yaml，文件权限 600，不上传不外传。 - 默认安全：
agent-reach install默认只检查环境、不改系统；只有显式加--system才会安装外部依赖或写入配置。 - Dry Run：
agent-reach install --dry-run可预览所有操作，不做任何改动。 - 可插拔架构：不信任某个组件？换掉对应的 channel 文件即可，不影响其他平台。
- 官方提醒：使用 Cookie 登录的平台（Twitter、小红书等）存在被平台检测封号的风险，建议使用专用小号而非主账号。
适用人群
- 重度 AI Agent 用户：日常用 Claude Code、Cursor、OpenClaw 等工具，希望 Agent 具备联网检索能力
- 内容创作者与自媒体运营：需要跨平台搜集选题、热点、竞品口碑，尤其是覆盖小红书、B站、雪球等中文平台
- 市场与投研人员：需要抓取社区舆情、股价讨论、行业动态做分析
- 研发与技术支持：让 Agent 自动查 GitHub Issue、Reddit 上的同类 bug 与解决方案
- RAG / 知识库搭建者：需要一个低成本的统一数据采集入口来喂给检索系统
- 不想为 API 付费的个人开发者：所有工具开源、所有 API 免费，本地电脑无需代理
与同类工具对比
| 维度 | Agent Reach | 单平台 CLI（yt-dlp 等） | 商业抓取平台 | 传统爬虫框架 |
|---|---|---|---|---|
| 平台覆盖 | 16+ 平台统一入口 | 单一平台 | 以英文站为主 | 需自行开发 |
| 接入方式 | 多后端自动路由 | 手动选型 | 平台提供 | 完全自建 |
| 配置成本 | 一句话交给 Agent | 逐个踩坑 | 需付费订阅 | 高 |
| 成本 | 完全免费 | 免费 | 按量付费 | 免费但费人力 |
| 中文平台 | ✅ B站/小红书/雪球/V2EX | 部分 | 通常不支持 | 需自研 |
| 诊断能力 | ✅ doctor 一键体检 | ❌ | 部分 | ❌ |
| Agent 集成 | ✅ 原生 SKILL.md | ❌ | 需自行对接 | ❌ |
| 安全 | 凭据本地、默认只读 | 视工具而定 | 数据经第三方 | 自控 |
Agent Reach 的真正差异化在于「能力层」定位：它不和 yt-dlp 竞争谁抓得更好，而是替你在众多抓取工具之间做选型、路由和体检。对只想让 Agent 「能上网」的用户来说，这比逐个安装和调试单平台工具高效得多；对需要大规模定制抓取的企业，它也是一个良好的起点，但可能仍需在其上做二次开发。
如何使用
方式一：让 Agent 自己装（推荐）
复制下面这句话发给你的 AI Agent（Claude Code / OpenClaw / Cursor / Windsurf 均可）：
帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
Agent 会自动完成安装 CLI、检查系统基建、检测环境、注册 SKILL.md，并询问你要激活哪些需要登录态的渠道。就这一步，其余交给 Agent。
⚠️ OpenClaw 用户注意：Agent Reach 依赖 Agent 执行 shell 命令，安装前需先开启 exec 权限：
> openclaw config set tools.profile "coding" > ``` > 设置后重启 Gateway 并开启新对话。Claude Code、Cursor 等不受此限制。 ### 方式二：手动安装并指定行为bash
默认安全检查（只读检查、列出缺失项，不改系统）
agent-reach install –env=auto
明确允许修改当前机器后，安装系统依赖并通过 MCP 接入 Exa
agent-reach install –env=auto –system
先预览会做什么，不做任何改动
agent-reach install –env=auto –dry-run
### 安装后：先体检，再使用
bash
一条命令查看每个渠道状态、当前走哪条后端路径
agent-reach doctor
然后直接对 Agent 下达自然语言指令即可：
bash
读任意网页
“帮我看看这个链接讲了什么”
看 YouTube 视频字幕
“这个 YouTube 视频讲了什么”
B站搜索（无需登录）
“B站搜一下 AI 教程”
全网语义搜索
“全网搜一下 LLM 框架对比”
需要登录的平台，点名即可解锁
“帮我配 Twitter” “帮我配小红书”
Agent 读了 SKILL.md 之后会自己判断该调用哪个命令、走哪个后端，你完全不用记语法。
### 更新与卸载
bash
更新（同样一句话交给 Agent）
帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md
卸载（清除配置、skill 文件与 MCP 配置）
agent-reach uninstall –dry-run # 先预览 agent-reach uninstall # 执行
只删 skill 文件，保留 token 配置
agent-reach uninstall –keep-config ```
总结
Agent Reach 精准地击中了 AI Agent 落地时最真实的一块短板——联网检索。在 2026 年，Agent 的「手脚」（执行、编码）已经足够强大，但「眼睛」（读取互联网）却因各家平台的付费 API、反爬封锁和登录门槛而支离破碎。Agent Reach 用「能力层 + 多后端路由 + 一键诊断」的设计，把这件事从「折腾半天」降维成「一句话」。
它最可贵的地方在于工程务实：不追求大而全的包一层，而是老老实实做选型与路由，平台封了它修、渠道停更它换，用户无感。90,000+ 星标和 Trendshift 单日第一的成绩，也印证了社区对这类「粘合剂型」工具的强烈需求。加之 MIT 开源、凭据本地存储、默认只读安装等设计，安全边界也交代得清楚。
需要注意的短板同样明确：依赖 Cookie 登录的平台存在封号与合规风险，官方也明确建议使用小号；部分渠道（如小红书、Reddit）体验受平台风控波动影响较大；作为快速迭代的社区项目，长期维护依赖作者个人投入。
推荐指数：⭐⭐⭐⭐⭐（5/5） —— 如果你在用 AI Agent 且需要联网检索能力，尤其是涉及中文平台的数据采集，Agent Reach 几乎是没有理由不装的工具。它把「让 Agent 上网」这件事做到了当前最省心的程度。