Agent-Reach:给你的 AI Agent 装上互联网眼睛

Agent-Reach logo

项目简介

Agent-Reach 是一个给 AI Agent 装上”互联网眼睛”的开源 CLI 工具,由 Panniantong 开发。它让 Claude Code、OpenClaw、Cursor、Windsurf 等 AI Agent 能够直接读取和搜索 Twitter、Reddit、YouTube、GitHub、B站、小红书、雪球、V2EX 等主流平台的内容——一条命令安装,零 API 费用。

项目地址:https://github.com/Panniantong/Agent-Reach(30K+ ⭐)

国内镜像:AtomGit 同步镜像

为什么要用 Agent-Reach?

AI Agent 已经很能干了——写代码、改文档、管理项目。但当你让它去网上查点东西,它就抓瞎了:

  • 📺 想看 YouTube 教程字幕?拿不到。
  • 🐦 搜推特上大家对某个产品的评价?Twitter API 要付费。
  • 📖 去 Reddit 查 bug 解决方案?服务器 IP 被拒 403。
  • 📕 查小红书上的口碑?必须登录才能看。
  • 📺 总结 B 站视频?下载工具被 B 站风控全面拦截。
  • 🔍 做全网搜索?要么付费要么质量差。

每个平台都有自己的门槛——付费 API、风控封锁、登录要求、数据清洗。自己逐个折腾配置,光是让 Agent 能读个推特就得折腾半天。Agent-Reach 把这件事简化成一句话。

Agent-Reach 支持平台概览

安装方式

直接复制下面这句话给你的 AI Agent:

帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

Agent 会自动完成:安装 CLI 工具(pip install agent-reach)、配置搜索引擎(MCP 接入 Exa,免费无需 API Key)、检测环境、注册 SKILL.md。安装完后运行 agent-reach doctor 即可查看各平台状态。

更新也是一句话:

帮我更新 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md

核心特性

💰 完全免费

所有工具开源、所有 API 免费。唯一可能花钱的是服务器代理(约 $1/月),本地电脑不需要。

🔒 隐私安全

Cookie 只存在本地 ~/.agent-reach/config.yaml,权限 600(仅所有者可读写),不上传不外传。代码完全开源可审查。

🔄 持续换代

每个平台都是「首选 + 备选」多后端路由。某个接入方式失效了自动切换下一个,用户无感。例如 2026 年 6 月 yt-dlp 被 B 站风控封死,已自动切换为 bili-cli。

🤖 兼容所有 Agent

Claude Code、OpenClaw、Cursor、Windsurf……任何能跑命令行的 Agent 都能使用。

🩺 自带诊断

运行 agent-reach doctor 一条命令查看每个平台的状态——哪个通、哪个不通、怎么修。

Agent-Reach 设计理念

支持平台一览

零配置即用(装好就能用)

  • 网页 — 阅读任意网页(Jina Reader)
  • YouTube — 字幕提取 + 视频搜索(yt-dlp)
  • RSS — 阅读任意 RSS/Atom 源(feedparser)
  • B 站 — 搜索 + 视频详情(bili-cli,无需登录)
  • V2EX — 热门帖子、节点帖子、帖子详情+回复
  • GitHub — 读公开仓库 + 搜索(gh CLI)

配置后解锁(告诉 Agent「帮我配 XXX」)

  • 全网搜索 — 语义搜索(Exa via MCP,免费无需 Key)
  • Twitter/X — 搜索推文、浏览时间线、读长文
  • Reddit — 搜索 + 读取帖子和评论
  • 小红书 — 搜索、阅读、评论
  • LinkedIn — Profile 详情、公司页面、职位搜索
  • 雪球 — 股票行情、搜索、热门帖子
  • 小宇宙播客 — 播客音频转文字(Whisper 转录)

日常使用示例

安装完之后,直接告诉 Agent 你想做什么:

  • “帮我看看这个链接” → 读任意网页
  • “这个 GitHub 仓库是做什么的” → 查看仓库详情
  • “这个 YouTube 视频讲了什么” → 提取字幕并总结
  • “B 站搜一下 AI 教程” → 搜索 B 站视频
  • “全网搜一下 LLM 框架对比” → 语义搜索
  • “订阅这个 RSS” → 解析并展示 RSS 内容
  • “小红书上这个产品口碑怎么样” → 搜索小红书内容

不需要记命令。Agent 读了 SKILL.md 之后自己知道该调用什么工具。

设计理念

Agent-Reach 不是一个”又一个工具”,而是一个能力层(Capability Layer)。它比具体实现高一层次——负责选型、安装、体检、路由,不负责底层读取本身。读取由 Agent 直接调用上游工具完成,没有包装层。

选型策略:每个平台按序探测候选后端,第一个完整可用的当选。换接入方式 = 调整列表顺序,不是重写代码。

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 → linkedin-mcp ▸ Jina Reader
├── rss.py → feedparser
├── exa_search.py → Exa via mcporter
└── __init__.py → 渠道注册(doctor 检测用)

安全建议

需要 Cookie 的平台(Twitter、小红书等),Cookie 等同于完整登录权限。建议使用专用小号,不要用主账号,以防平台检测到非正常 API 调用导致封号。

结语

Agent-Reach 解决了一个核心痛点:AI Agent 能写会算,但就是”看不见”互联网。装上它之后,你的 Agent 就真正有了眼睛。30K+ Stars 和持续更新维护,值得一试。

项目地址:https://github.com/Panniantong/Agent-Reach

© 版权声明
THE END
喜欢就支持一下吧
点赞13 分享