Agent Reach:给你的 AI Agent 一键装上全网调研能力(15 平台零 API Key,GitHub 趋势 1)
配套媒体
本页对应的 PPT 与演示视频
下载没反应？点这里复制直链
侧边栏预览窗口（Electron webview）会拦截下载，把下面的链接复制到 Chrome / Edge 地址栏打开即可保存。
../../Agent-Reach-recommend.pptx../../Agent-Reach-recommend.mp4本文目录
- 为什么这篇值得写?
- 它是什么?——不是工具,是"能力层"
- 一句话安装
- 支持的 15 个平台
- 装好之后:Agent 自己知道该调什么
- 和"每个工具单独装"差在哪?
- 3 分钟上手
- 步骤 1:复制安装指令给你的 Agent
- 步骤 2:回答 Agent 的提问
- 步骤 3:跑体检
- 步骤 4:第一次调研
- 核心亮点 1:多后端路由策略——平台封了就换
- 核心亮点 2:完全免费 + 隐私安全
- 核心亮点 3:兼容所有主流 Agent
- 真实应用例子:30 分钟做完一次"竞品舆情调研"
- 生产实践:3 个最容易踩的坑
- 坑 1:OpenClaw 用户没开 exec 权限
- 坑 2:小红书 / Twitter 用主账号
- 坑 3:以为"装好 = 全平台能用"
- 最适合什么场景?
- 本文重点回顾
- 延伸阅读
Agent Reach:给你的 AI Agent 一键装上全网调研能力(15 平台零 API Key,GitHub 趋势 #1)
金句开头:AI Agent 写代码已经卷到没朋友,但让它上网查点资料,99% 的 Agent 都会当场"翻车"——Twitter 要付费 API、Reddit 服务器 IP 被封、小红书必须登录、YouTube 拿不到字幕。Agent Reach 做的事,就是让 Agent 一句话装上"读遍全网"的能力,15 个平台、零 API Key、完全免费。
为什么这篇值得写?
你大概已经习惯 Claude Code、Cursor、Codex 这些 AI 编程工具。它们写代码、改文档、管仓库,确实猛。但只要你说一句"帮我看下这个产品的 Twitter 上大家怎么评价",90% 的 Agent 会立刻"装死"——
- 📺 "看看这个 YouTube 教程讲了什么" → 拿不到字幕
- 🐦 "搜一下推特上大家怎么看" → Twitter API 要付费
- 📖 "Reddit 上有没有人遇到过这 bug" → 403 服务器 IP 被拒
- 📕 "小红书这个品口碑怎么样" → 必须登录才能看
- 📺 "B 站这个技术视频帮我总结一下" → 通用下载工具被风控全面拦截
每加一个平台,你都得踩半天坑、调一堆配置。Panniantong/Agent-Reach 这个项目,直接把这些事做成"一句话安装"——GitHub Trendshift 当日 #1 Repository,完全开源(MIT),3 天内新增 1k+ stars。
它是什么?——不是工具,是"能力层"
Agent Reach 不是又一个抓取工具,而是一个能力层(Capability Layer)。它不做底层读取,只负责三件事:
- 选型:每个平台都按"首选 + 备选"维护一个有序后端列表
- 安装:自动检测环境、装依赖、注册 SKILL.md 到 Agent 的 skills 目录
- 体检:
agent-reach doctor一条命令告诉你哪个通、哪个不通、怎么修
比如 B 站,首选是 bili-cli(无需登录),备选是 OpenCLI,最末是搜索 API——但 README 里专门写明:"2026-06 实例:yt-dlp 被 B 站风控 412 封死 → 已切换 bili-cli,用户零操作。"也就是说,平台封了就换,用户不用操心。
一句话安装
告诉你的 Agent 这句话:
帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
然后 Agent 会自己完成剩下所有事——pip install、装 Node.js、装 gh CLI、注册 SKILL.md、问你要不要配登录态平台。
支持的 15 个平台
| 平台 | 装好即用 | 配置后解锁 | 怎么配 |
|---|---|---|---|
| 🌐 网页 | 阅读任意网页(Jina Reader) | — | 无需配置 |
| 📺 YouTube | 字幕提取 + 视频搜索(yt-dlp) | — | 无需配置 |
| 📡 RSS | 阅读任意 RSS/Atom 源(feedparser) | — | 无需配置 |
| 🔍 全网搜索 | — | Exa 语义搜索 | 自动配置(MCP 接入,免费无需 Key) |
| 📦 GitHub | 读公开仓库 + 搜索(gh CLI) | 私有仓库、提 Issue/PR、Fork | "帮我登录 GitHub" |
| 🐦 Twitter/X | 读单条推文 | 搜索推文、浏览时间线 | "帮我配 Twitter" |
| 📺 B 站 | 搜索 + 视频详情(bili-cli) | 字幕(OpenCLI) | "帮我配 B 站" |
| — | 搜索 + 读帖子和评论 | OpenCLI 复用浏览器登录态 | |
| — | 搜索、主页、Feed、群组 | OpenCLI(复用 Chrome) | |
| — | 用户搜索、Profile、最近帖子 | OpenCLI(复用 Chrome) | |
| 📕 小红书 | — | 搜索、阅读、评论 | OpenCLI 桌面 / xiaohongshu-mcp 服务器扫码 |
| Jina Reader 读公开页 | Profile、公司页、职位搜索 | "帮我配 LinkedIn" | |
| 💻 V2EX | 热门、节点、帖子、用户 | — | 无需配置 |
| 📈 雪球 | 行情、搜索、热门股票 | — | "帮我配雪球" |
| 🎙️ 小宇宙播客 | — | Whisper 转录(免费 Key) | "帮我配小宇宙播客" |
不知道怎么配?不用查文档。直接告诉 Agent "帮我配 XXX",它会一步一步引导你。
装好之后:Agent 自己知道该调什么
不需要记命令。Agent 读了 SKILL.md 之后自己知道该调什么:
- "帮我看看这个链接" →
curl https://r.jina.ai/URL - "这个 GitHub 仓库是做什么的" →
gh repo view owner/repo - "这个 YouTube 视频讲了什么" →
yt-dlp提取字幕 - "B 站搜一下 AI 教程" →
bili search - "全网搜一下 LLM 框架对比" → Exa 语义搜索
- "订阅这个 RSS" →
feedparser
需要登录的平台,告诉 Agent "帮我配 XXX" 即可解锁。
和"每个工具单独装"差在哪?
| 维度 | 自己折腾 | Agent Reach |
|---|---|---|
| Twitter 怎么读 | 调研 → 选 CLI → 申请 API Key → 调 Cookie → 撞风控 → 换工具 | "帮我配 Twitter",Agent 走完剩下所有步骤 |
| B 站字幕 | yt-dlp 失败 → 找替代 → 装 Node → 配置登录态 | bili-cli 已就绪,无需登录可搜可读 |
| 匿名接口被封 → 走官方 API → 等审批 | OpenCLI 复用浏览器登录态,几秒搞定 | |
| 小红书 | xhs-cli 试一下 → 作者已停更 → 换 xiaohongshu-mcp → 配服务器 | OpenCLI 桌面版直接复用 Chrome 登录 |
| 平台改风控 | 你自己监控、自己找替代方案 | 项目维护者真机实测后切换路由,doctor 告诉你当前走哪条路 |
| 新平台接入 | 重新踩坑 | 提 Issue,作者会持续加 |
Agent Reach 真正强的不是"加了多少工具",而是"你不用再为每个工具踩坑"。
3 分钟上手
步骤 1:复制安装指令给你的 Agent
帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
步骤 2:回答 Agent 的提问
Agent 会问你要解锁哪些需要登录态的平台(小红书、Twitter、Reddit 等)。选你常用的 1-2 个,其他以后再加。
步骤 3:跑体检
agent-reach doctor
它会列出每个渠道的当前状态、首选 + 备选后端、修复处方。
步骤 4:第一次调研
"帮我搜一下 Twitter 上关于 GPT-5.5 的最新讨论,再用 YouTube 上一个相关教程的字幕总结一下"—— Agent 会自己调 twitter-cli 拉推文、调 yt-dlp 拿字幕,然后给你一份综合报告。
核心亮点 1:多后端路由策略——平台封了就换
Agent Reach 最有意思的设计,是每个平台 = 首选 + 备选的有序后端列表。
# agent_reach/channels/ 下的核心代码结构
channels/
├── twitter.py → twitter-cli ▸ OpenCLI ▸ bird
├── bilibili.py → bili-cli ▸ OpenCLI ▸ 搜索 API(yt-dlp 已被封,退役)
├── reddit.py → OpenCLI ▸ rdt-cli(必须登录态)
├── xiaohongshu.py → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli
└── ...
每个渠道文件按序真实探测各候选后端(不只是看命令存不存在),第一个完整可用的当选;坏掉的会给出修复处方。
实际意义:2026 年 3 月一批单平台 CLI 集体停更时,Agent Reach 项目方调整列表顺序就行,不用重写代码。这是和"自己写一堆抓取脚本"最本质的差别——可维护性天差地别。
核心亮点 2:完全免费 + 隐私安全
| 措施 | 详情 |
|---|---|
| 💰 完全免费 | 所有工具开源、所有 API 免费。唯一可能花钱的是服务器代理(~$1/月),本地不需要 |
| 🔒 隐私安全 | Cookie 只存本地 ~/.agent-reach/config.yaml(权限 600),不上传不外传 |
| 👀 完全开源 | 代码透明,所有依赖工具也是开源项目,随时可审计 |
| 🛡️ 安全模式 | agent-reach install --safe 不自动装系统包,只列需求 |
| 🔍 Dry Run | agent-reach install --dry-run 预览所有操作,不做任何改动 |
⚠️ 封号风险提醒:使用 Cookie 登录的平台(Twitter、小红书等),通过脚本/API 调用存在被平台检测并封号的风险。务必使用专用小号,不要用主账号。
核心亮点 3:兼容所有主流 Agent
完整插件级支持(自动注册 SKILL.md):Claude Code、OpenClaw、Cursor、Windsurf、Cline、Copilot Chat、Aider、Kiro、Zed、Junie、Amp、Jules、Devin CLI、Codex、GitHub Copilot CLI、Pi、OpenCode、Gemini CLI、Qoder、Antigravity CLI、Hermes Agent、CodeWhale、Swival、OpenClaw。
也就是说,任何能跑命令行的 Agent 都能用。
真实应用例子:30 分钟做完一次"竞品舆情调研"
不用 Agent Reach 时,你需要:
- 打开 Twitter,搜竞品名 → 复制粘贴到本地
- 打开 Reddit,搜同样的关键词 → 复制
- 打开小红书,搜竞品名 → 复制
- 打开 YouTube,搜评测视频 → 听 + 写笔记
- 手动汇总成报告
用 Agent Reach(假设已配好登录态):
"帮我调研下 Cursor 和 Windsurf 在 Twitter / Reddit / 小红书上的用户口碑对比。重点找 2026 年 6 月以后的负面评价,以及大家在性能、价格、学习曲线上的吐槽。"
然后你就去喝杯咖啡。Agent 会自动:
- 调 twitter-cli 搜两条时间线
- 调 OpenCLI 读 Reddit 相关 r/ClaudeAI、r/cursor 帖子
- 调 OpenCLI 读小红书相关笔记
- 过滤负面关键词 + 时间窗口
- 输出 Markdown 对比报告
这是真正"把搜索交给 Agent"的工作流,而不是把搜索结果粘给 Agent。
生产实践:3 个最容易踩的坑
坑 1:OpenClaw 用户没开 exec 权限
openclaw config set tools.profile "coding"
然后重启 Gateway,开启新对话。Claude Code / Cursor 等不受此限制。
坑 2:小红书 / Twitter 用主账号
务必专用小号。一旦被检测,主号也危险。
坑 3:以为"装好 = 全平台能用"
doctor 会明确告诉你哪些是装好即用、哪些需要登录态。第一次跑 doctor,看看哪些渠道红了,再决定是否解锁。
最适合什么场景?
| 场景 | 推荐度 | 理由 |
|---|---|---|
| 个人开发者做技术调研 | ⭐⭐⭐⭐⭐ | 一次安装,日常高频使用 |
| 内容创作者追热点 | ⭐⭐⭐⭐⭐ | Twitter + 小红书 + B 站三件套,极其实用 |
| 投研 / 行业研究 | ⭐⭐⭐⭐ | 全网搜索 + Twitter + 雪球,组合很香 |
| 普通用户偶尔用一下 | ⭐⭐ | 太重,直接用浏览器或 ChatGPT 搜索更轻 |
| 企业内网部署 | ⭐⭐⭐ | 需要服务器代理($1/月),配合 --safe 模式 |
本文重点回顾
- Agent Reach 是"能力层",不是又一个抓取工具——它负责选型、安装、体检、路由,不负责底层读取
- 15 平台覆盖,9 个装好即用,6 个一句话解锁登录态
- 多后端路由策略——平台封了就换,用户无感,这是和"自己写脚本"最本质的差别
- 完全免费 + 本地优先——所有 API 免费、Cookie 存本地、代码完全开源
- 兼容 20+ 主流 Agent——Claude Code / OpenClaw / Cursor / Windsurf 全覆盖
- Trandeshift 当日 #1 Repository——3 天内新增 1k+ stars,作者持续维护
延伸阅读
- GitHub 仓库:https://github.com/Panniantong/Agent-Reach
- Trendshift 热度榜:https://trendshift.io/repositories/24387
- 底层依赖:yt-dlp(154k★)、gh CLI、Jina Reader、Exa、feedparser、bili-cli、twitter-cli
- 同类项目对比:直接给 Agent 加 web 搜索能力的方案有 Perplexity API、Tavily 等,但它们都要 API Key 费用,且不支持中文平台
一句话总结:Agent Reach = AI Agent 的"互联网能力路由器"。让 Agent 一句话装上全网调研能力,把"读 + 搜 + 订阅"三件事从踩坑变成开箱即用。