让你的 Agent 直接搜索和阅读 X、Reddit、YouTube、小红书……

GitHub 热榜爆火开源项目,仓库:Panniantong/Agent‑Reach,MIT 协议、Python 编写,要求 Python ≥ 3.10,v1.5.0 为主要版本;定位是给 AI Agent 装上“阅读全网的眼睛”,免费、无需付费平台 API。

一句话核心:它不是爬虫,也不是统一 API 封装,而是一套本地工具管家:自动安装、健康检测、多后端路由切换;真正拉取内容的是 yt‑dlp、Jina Reader、twitter‑cli、bili‑cli 等上游开源工具,Agent 最后直接调用这些 CLI。

✅ 核心亮点

  1. 零平台 API 费用
    不走官方付费 API,依托本地开源客户端;Cookie、会话全部保存在本机,不上传第三方服务器。
  2. 自动故障兜底路由
    每个平台维护一条有序后端列表,首选链路挂掉自动切备选。典型例子:B站原来走 yt‑dlp,被反爬拦截后项目切换到 bili‑cli,用户不用改代码。
  3. 覆盖国内外主流平台(只读)
    • 海外:X/Twitter、Reddit、YouTube、GitHub、Instagram、LinkedIn、通用网页(Jina Reader)、RSS、Exa 全网搜索
    • 国内特色(最出圈):Bilibili、小红书、V2EX、雪球、小宇宙播客转录
    • ❗注意:抖音、公众号文章目前不支持;全部为只读,不能发帖、评论
  4. 内置诊断工具 agent-reach doctor
    探测后端是否存活、标记需要 Cookie / 代理的渠道,并给出修复方案;还有 watch、check-update 用于长期巡检。
  5. 适配主流 Agent
    Cursor、Claude Code、OpenClaw,只要能执行 Shell 的 Agent 都能用;社区还有 MCP Fork,可以接入 MCP 生态(LobeChat 等)。

📦 快速上手

⚠️ 重要:PyPI 同名包不属于这个项目,不要直接 pip install agent-reach

pipx install [https://github.com/Panniantong/agent-reach/archive/main.zip](https://github.com/Panniantong/agent-reach/archive/main.zip)
agent-reach install --env=auto
# 诊断状态
agent-reach doctor

安全模式预览,避免乱装系统包:

agent-reach install --env=auto --safe --dry-run

也可以直接把安装文档链接丢给 Agent,让它自助部署。

⚠️ 必须重视的风险

  • 账号封禁风险:小红书、X、Reddit、雪球依赖浏览器 Cookie / Chrome 会话,自动化访问容易触发风控;官方强烈建议使用独立小号,不要使用主账号
  • 平台服务条款:自动登录态访问可能违反部分平台用户协议
  • 服务器部署坑:VPS / 机房 IP 极易被封禁,通常需要住宅代理
  • 能力边界:只负责“读”,不是稳定商用检索服务,链路随时可能因为平台反爬失效

🧾 适用场景 & 不适合场景

  • ✅ 适合
    • 让编码 Agent 检索社交讨论、提取 YouTube 字幕、查阅 B 站资料
    • 产品调研、竞品舆情、技术社区话题采集
    • 需要同时访问国内 + 海外社交平台做信息汇总
  • ❌ 不适合
    • 需要稳定合规商用检索、高 SLA 的生产业务
    • 想要一键免登录全平台、无人值守大规模爬取
    • 只需要普通搜索引擎网页检索(模型自带联网通常足够)

和内置联网搜索对比

  • 模型自带联网:只能读到被搜索引擎索引的公开页面,拿不到登录态下的评论、帖子、私密讨论;无账号风险
  • Agent‑Reach:可以拿到登录态生态内内容、视频字幕;有账号风控代价,但弥补了现有 Agent 联网最大短板
免责声明:本网站仅提供网址导航服务,对链接内容不负任何责任或担保。
相关资讯