AI Agent 越来越强,写代码、改文档、管项目都不在话下——但让它”上网找点东西”时,往往瞬间抓瞎:
- “帮我看看这个 YouTube 教程讲了什么” → 拿不到字幕
- “搜一下推特上大家怎么评价这个产品” → Twitter API 要付费
- “去 Reddit 看看有没有人遇到同样的 bug” → 服务器 IP 被 403
- “看看小红书上这个品的口碑” → 必须登录才能打开
- “B 站上有个技术视频,帮我总结一下” → 通用下载工具被风控拦截
每个平台都有自己的门槛:付费 API、反爬封锁、登录账号、脏数据清洗。自己一个一个去踩坑,光是让 Agent 能读个推特就得折腾半天。
今天推荐的开源项目 Agent Reach,就是来解决这个问题的(仅介绍其能力与原理,请遵守各平台服务条款与相关法律法规)。
本文基于项目官方 README 整理(GitHub 仓库),与项目作者无任何关联背书。 本文不构成对任何违反平台 ToS 之使用方式的鼓励或推荐。
Agent Reach 是什么
Agent Reach 是一个”能力层”(capability layer),不是又一个抓取工具。
它负责一件事:为你的 AI Agent(Claude Code、OpenClaw、Cursor、Windsurf 等)选好、装好、体检好访问互联网的接入方式。底层读取由 Agent 直接调用上游工具完成,没有多余包装层。
它的核心理念是:当下最稳的接入方式,替你选好、装好、体检好。接入方式会换代,你不用操心。
项目采用 MIT 协议完全开源,所有依赖工具也都是开源项目,代码随时可审查。
核心设计:首选 + 备选的多后端路由
每个平台背后都是一个”有序后端列表”,安装或运行时按序真实探测(不只是看命令存不存在),第一个完整可用的当选,坏掉的给出修复处方:
channels/├── web.py → Jina Reader├── twitter.py → twitter-cli ▸ OpenCLI ▸ bird├── youtube.py → yt-dlp├── github.py → gh CLI├── bilibili.py → bili-cli ▸ OpenCLI ▸ 搜索 API├── reddit.py → OpenCLI ▸ rdt-cli├── xiaohongshu.py → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli├── linkedin.py → mcp-server-linkedin ▸ Jina Reader├── rss.py → feedparser└── exa_search.py → Exa via mcporter换接入方式 = 调整列表顺序,不是重写代码。项目维护方会持续追踪各平台变化:比如 2026 年 6 月 yt-dlp 被 B 站风控封死,就切换到了 bili-cli,用户零操作无感。
支持的平台
| 平台 | 装好即用 | 配置后解锁 |
|---|---|---|
| 网页 | 阅读任意网页(Jina Reader) | — |
| YouTube | 字幕提取 + 视频搜索(yt-dlp) | — |
| RSS | 阅读任意 RSS/Atom 源 | — |
| 全网搜索 | — | 语义搜索(Exa MCP,免费无需 Key) |
| GitHub | 读公开仓库 + 搜索(gh CLI) | 私有仓库、提 Issue/PR |
| Twitter/X | 读单条推文 | 搜索、时间线、长文 |
| B 站 | 搜索 + 视频详情(bili-cli) | 字幕 |
| — | 搜索 + 读帖(需登录态) | |
| Facebook / Instagram | — | 搜索、主页、Feed(桌面登录态) |
| 小红书 | — | 搜索、阅读、评论(登录态) |
| 读公开页面 | Profile、职位搜索 | |
| V2EX | 热门帖子、详情 + 回复 | — |
| 雪球 | 股票行情、热门帖子 | — |
| 小宇宙播客 | — | 音频转文字(Whisper) |
安装使用:一句话搞定
复制下面这句话给你的 AI Agent 即可:
帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.mdAgent 会自己完成剩下的所有事情:安装 CLI、检查 Node.js / gh CLI / mcporter、按授权安装依赖、注册 SKILL.md。已安装过的更新也是一句话:
帮我更新 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md装好之后不需要记命令,Agent 读了 SKILL.md 自己知道该调什么:
# 体检所有渠道状态agent-reach doctor
# 只检查环境,不修改系统agent-reach install --env=auto
# 显式允许修改系统时安装依赖agent-reach install --env=auto --system
# 预览所有操作,不做任何改动agent-reach install --env=auto --dry-run需要登录态的平台(小红书、Twitter、Reddit 等),直接告诉 Agent「帮我配 XXX」,它会一步一步引导你。
安全性设计
- 凭据本地存储:Cookie、Token 只存本机
~/.agent-reach/config.yaml,文件权限 600,不上传不外传 - 默认安全:
install默认不修改系统,只有显式--system才安装外部工具、写入配置 - 完全开源:所有代码与依赖工具均可审查
- Dry Run:
--dry-run预览所有操作,不做任何改动
合规使用须知
⚠️ 使用 Agent Reach 前,请务必阅读并遵守以下事项:
- 遵守各平台服务条款:文中提到的所有平台(Twitter/X、Reddit、LinkedIn、小红书、B 站、YouTube 等)均明确禁止未经授权的自动化访问。即使 Agent Reach 提供了技术手段,也请确保你的具体使用场景在该平台 ToS 允许范围内
- 尊重平台数据使用政策:不要把通过 Agent 抓取的数据用于训练、商用转售、舆论操控或其他违反数据保护法律法规的用途
- 个人信息保护:如涉及抓取的用户数据,遵循《个人信息保护法》《数据安全法》的相关规定,必要时进行去标识化处理
- 依赖稳定性:项目依赖大量第三方 CLI 工具,上游工具可能因平台风控策略升级而失效,作者会持续跟进,但短期内可能存在部分渠道不可用
- 自负风险:本文仅介绍开源工具的原理与能力边界,不构成对任何具体使用方式的推荐或背书。因使用本工具造成的账号封禁、数据争议、法律纠纷,均由使用者自行承担
总结
Agent Reach 解决的痛点非常真实:AI Agent 接入互联网的”最后一公里”配置成本。它不发明新工具,而是把当下最稳的开源方案选好、装好、路由好,让用户和 Agent 只面对一句话。
适合人群:重度使用 Claude Code / OpenClaw / Cursor 等 Agent、希望 Agent 能真正”上网干活”的开发者;需要 Agent 抓取公开网页、社交媒体、视频字幕做信息收集的个人与团队。
如果你也在用 AI Agent,值得去 GitHub Star 一下这个项目,下次需要的时候能找到。
相关阅读: