Agent-Reach 是 GitHub 本周榜第 17 的开源项目，给 AI agent 装上「读全网」的能力。截至 2026 年 7 月底，61,391 颗星、4,971 个 fork、MIT 协议、纯 Python，首提交于 2026 年 2 月 24 日，最新版 v1.5.0，作者 Panniantong。它干的事一句话能说明白：让 Claude Code、Cursor、OpenClaw 这类 coding agent 一句话读 Twitter、Reddit、YouTube、B站、小红书、GitHub--一个 CLI 零 API 费，自带 MCP server。topics 标签自报家门：twitter-scraper、reddit-scraper、youtube-transcript、xiaohongshu、bilibili、mcp、free-api。
解决什么痛点
写过 agent 自动化的人都遇到过：让 LLM 写代码、改文档它一把好手，你让它去网上找点东西就抓瞎--YouTube 字幕拿不到、Twitter API 要付费、Reddit 匿名接口被 403、小红书必须登录、B站风控把通用下载工具全线拦死、通用网页抓回来一堆 HTML 标签没法读。每个平台都有自己的坑：付费的 API、要绕的封锁、要登的账号、要清洗的数据，光让 agent 能读一条推特就得折腾半天，装一堆库、调一堆配置。Agent Reach 把这件事压成一句话：你把 README 的 install.md 链接丢给 agent，说「帮我安装 Agent Reach」，几分钟它就装好--推特能搜、Reddit 能读、YouTube 字幕能拉、小红书能逛，agent 自己看 SKILL.md 就知道该调哪个上游工具。核心转变是从「每个平台自己踩坑选工具」换成「能力层替你选好、装好、体检好」。
多平台读取：一个 CLI 装好全网入口
支持的平台覆盖中英文主流渠道。零配置即用的有：网页（Jina Reader 读任意 URL）、YouTube（yt-dlp 提字幕 + 视频搜索）、RSS（feedparser 解析任意源）、GitHub（gh CLI 读公开仓库 + 搜索）、B站（bili-cli 无登录搜索 + 视频详情）、V2EX（热门帖 + 节点 + 详情）、雪球（股票行情 + 热帖）。配置后解锁的有：Twitter（搜推文 + 浏览时间线 + 读长文）、Reddit（搜帖 + 读评论）、Facebook/Instagram（搜索 + Profile + Feed）、小红书（搜索 + 阅读 + 评论）、LinkedIn（Profile + 公司 + 职位）、小宇宙播客（Whisper 转录音频转文字）、全网语义搜索（Exa 通过 MCP 接入；Exa 2026 年中起转 X402 按次付费，约 $0.007/次，100 次试用后收费）。这里的设计取舍很务实：能匿名读的零配置直接给，要登录态的（Twitter/小红书/Reddit 等）走「告诉 agent 帮我配 XXX」，agent 一步步引导你导出 Cookie 或复用浏览器会话，不点名不装。
零 API 费 + 多后端路由：被封了自动换
这是它和「又一个单平台 CLI」根本不同的地方。Agent Reach 把自己定位成能力层（capability layer），不是又一个工具--只负责选型、安装、体检、路由，底层读取由 agent 直接调上游工具完成，没有包装层。每个平台是一个有序后端列表：首选 + 备选。比如 B站走 bili-cli ▸ OpenCLI ▸ 搜索 API（yt-dlp 2026 年 6 月被 B站风控 412 封死后已退役），Twitter 走 twitter-cli ▸ OpenCLI，小红书走 OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli，LinkedIn 走 linkedin-scraper-mcp ▸ Jina Reader。某条路失效了，作者换下一条，你无感升级--2026 年 3 月一批单平台 CLI 集体停更，作者换了路由，用户零操作。agent-reach doctor 一条命令告诉你每个平台当前在用哪个后端，哪个通哪个不通，怎么修。所有上游工具开源、几乎全部 API 免费（唯一例外：Exa 搜索 2026 年中已转 X402 按次付费，约 $0.007/次），唯一可能花钱的是服务器代理（约 1 美元/月），本地电脑不需要。
MCP 与 Agent 编排
它不是另一个 SaaS，是装在你 agent 旁边的本地 CLI + MCP 服务。安装方式本身就走 agent：你给 Claude Code/Cursor/OpenClaw 贴一句「帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md」，agent 自己 pip install、装系统基建（Node.js、gh CLI、mcporter）、配 Exa 搜索引擎、注册 SKILL.md 到 agent 的 skills 目录，之后 agent 遇到「全网调研」「搜推特」「看视频」这类需求会自动知道调哪个上游工具。MCP 部分通过 mcporter 接入 Exa 语义搜索（注：Exa 2026 年中已转 X402 按次付费，免 Key 已不成立，100 次试用后约 $0.007/次），任何支持 MCP 的客户端都能直接调。兼容面覆盖 Claude Code、OpenClaw、Cursor、Windsurf--任何能跑命令行的 agent 都能用，OpenClaw 用户需先开 exec 权限（openclaw config set tools.profile "coding"）。安全上 Cookie 只存在本地 ~/.agent-reach/config.yaml（权限 600），不上传不外传；--safe 模式不自动装系统包，只列清单；--dry-run 预览所有操作不做改动；不信任某个组件，换掉对应的 channel 文件即可，不影响其他。
三分钟上手
# 1. 装（Python >= 3.10）
pip install agent-reach
# 2. 一键安装（个人电脑默认模式）
agent-reach install --env=auto
# 或安全模式（生产服务器）：agent-reach install --env=auto --safe
# 或仅预览：agent-reach install --env=auto --dry-run
# 3. 体检
agent-reach doctor
# 输出每个平台的当前后端、连通状态、修复处方
# 4. 用（任何支持命令行的 Agent 都行）
# 直接对 Claude Code 说：
# 「帮我看看这个 YouTube 视频讲了什么：URL」
# 「搜一下推特上大家怎么评价这个产品」
# 「全网搜一下最新的 LLM 框架对比」
# Agent 读 SKILL.md 自己调对应上游工具更省事的路子：把 README 里那段 install.md 链接丢给 agent，agent 自己完成装包、装基建、配 MCP、注册 skill，你只管下指令。要更新也是一句话：贴 update.md 链接。agent-reach uninstall 一键清除所有 token/cookie、skill 文件、MCP 配置，--keep-config 可保留配置方便重装。
适合谁 + 五个踩坑
适合：要让 coding agent 做全网调研、社交监听、竞品监测的人；自建 agent 工作流、不想为每个平台单独调 API 的开发者；预算敏感、不愿付各家平台 API 月费的个人和小团队；数据隐私要 Cookie 不出本机的场景。
踩坑记五条。一是 Cookie 封号风险，用 Cookie 登录的平台（Twitter、小红书、Reddit 等），脚本/API 调用可能被平台检测封号，务必用专用小号、不要用主账号，Cookie 等同完整登录权限，小号能在泄露时限制影响范围。二是 Twitter Cookie 特殊处理，agent-reach configure xhs-cookies 不会把 Cookie 注入 OpenCLI/Chrome，Twitter Cookie 保存后仅供 doctor 检查配置是否齐全，直接跑上游 twitter 命令前仍需在当前进程环境显式设 TWITTER_AUTH_TOKEN 和 TWITTER_CT0。三是平台 ToS，抓取各平台数据看条款，批量抓取、绕过反爬有法律灰区，商用前读条款，工具是 MIT 但你的用法不一定 MIT。四是后端退役与切换，yt-dlp 2026 年 6 月被 B站风控封死已退役，平台反爬升级是常态，某条路失效了等作者换路由或自己挂代理，本地 agent-reach doctor 永远告诉你当前走的是哪条。五是服务器部署，本地电脑不需要代理，部署在服务器上才需要（约 1 美元/月），服务器环境跑 agent-reach install --env=auto --safe 别默认全自动，多人共用机器更要走安全模式。
和竞品比
和各家平台官方 API 比，本质是「零费 + 多渠道聚合」对「付费 + 单平台」：官方 API 稳定合规但 Twitter API 月费起步百美元、Reddit 官方 API 审批制、小红书干脆没公开 API，Agent Reach 把这些都压成零费开源，代价是用 Cookie/浏览器登录态走灰区、要自己承担合规风险。和 Jina Reader 比，Jina 只读网页（一行 URL 转 markdown），Agent Reach 多了一层社交平台读取能力，Jina 反而是它的一个上游后端（web 渠道首选）。和 firecrawl 比，firecrawl 是付费 SaaS 做网页结构化提取，强在批量爬整站、输出干净 markdown，但只覆盖网页不碰社交平台，Agent Reach 是开源本地 CLI 覆盖社交 + 网页 + 搜索，定位是给 agent 装全网入口，不是做网页数据 ETL。和单平台 CLI（twitter-cli、bili-cli 各自一个）比，Agent Reach 多了选型 + 体检 + 多后端路由 + SKILL.md 自动注册，单平台 CLI 停更了它换路由，你不用自己盯着。一句话：要让 coding agent 一句话读全网、零 API 费、还能自动跟进平台反爬升级，选 Agent Reach。
参考来源
- Agent-Reach GitHub 仓库（61,391 star，MIT，Python）：https://github.com/Panniantong/Agent-Reach
- 官方 README（中文 / English / 日本語 / 한국어 多语言）：https://github.com/Panniantong/Agent-Reach
- GitHub Trending 周榜第 17（本周榜）：见仓库 Trending 状态
- 上游工具列表（Jina Reader / yt-dlp / gh CLI / bili-cli / Exa / OpenCLI / twitter-cli / rdt-cli / xiaohongshu-mcp / feedparser / linkedin-scraper-mcp）：见 README 致谢段
- 安装与更新文档：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md