今天聊的这个项目叫 Agent Reach。一句话定位：它给你的 AI Agent 装"眼睛"，让 Claude Code、OpenClaw、Cursor 这些 Agent 一句话就能读推特、搜 Reddit、看 YouTube、刷小红书、抓网页。
AI Agent 现在写代码改文档是真在行，但你让它去网上找点东西，它就抓瞎了。每个平台都有自己的门槛——要付费的 API、要绕过的封锁、要登录的账号、要清洗的数据。光是让 Agent 能读个推特，自己折腾就得大半天。
Agent Reach 把这件事变成了一句话。下面拆开看看它到底强在哪。
让 Agent 上网，为什么总翻车
很多人以为 AI Agent 已经能帮你干所有事了，其实不然。让它去网上找东西，大概率会翻车：
- 让 Agent 看 YouTube 教程讲什么——看不了，拿不到字幕
- 让 Agent 搜推特上大家怎么评价某个产品——搜不了，Twitter API 要付费
- 让它去 Reddit 找有没有人遇到过同样的 bug——直接 403 被封，服务器 IP 被拒
- 让它看小红书上一个品的口碑——打不开，必须登录才能看
- 让它总结 B 站上的技术视频——拿不到，通用下载工具被 B 站风控全面拦截
- 让它读个网页内容——抓回来一堆 HTML 标签，根本没法读
这些功能单独实现都不难，难的是每个平台都要单独折腾配置。Agent Reach 的价值，就是把这些坑全帮你填了。
能力层，不是工具层
这是 Agent Reach 跟同类项目最大的区别。它比任何具体实现都高一层，负责选型、安装、体检、路由，不负责底层读取本身。读取由 Agent 直接调用上游工具完成，没有中间包装层。
以前你给一个新 Agent 装环境，总要花时间去找工具、装依赖、调配置。Twitter 用什么读？Reddit 怎么登录？小红书的 CLI 停更了换什么？每次都要重新踩一遍坑。
Agent Reach 替你把"当下最稳的接入方式"选好、装好、体检好。接入方式会换代（2026 年 3 月一批单平台 CLI 集体停更，作者直接换了路由），你不用操心。
首选 + 备选路由
换接入方式等于调整列表顺序，不是重写代码。agent-reach doctor 一条命令告诉你每个平台当前在用哪个后端。渠道文件结构如下：
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每个渠道文件会按序真实探测各候选后端——不是只看命令存不存在，是真的跑一遍看能不能用。第一个完整可用的当选，坏掉的还会给出修复处方。
支持的平台
Agent Reach 覆盖了 10+ 个主流平台，分"装好即用"和"配置后解锁"两类：
需要 Cookie 的平台（Twitter、小红书等），优先用 Chrome 插件 Cookie-Editor 导出 Cookie 发给 Agent 就行，比扫码更简单可靠。Cookie 只存在本地，不上传不外传。
选型逻辑
以下是作者基于真机实测定期复核的"当前选型"：
| 场景 | 首选 | 备选 | 为什么 |
|---|---|---|---|
| 读网页 | Jina Reader | — | 免费，不需要 API Key |
| 读推特 | twitter-cli | OpenCLI | 实测搜索稳定；OpenCLI 走浏览器登录态兜底 |
| OpenCLI（桌面） | rdt-cli | 匿名接口被封，官方 API 审批制，只剩登录态路线 | |
| YouTube | yt-dlp | — | 字幕仍是最佳方案 |
| B 站 | bili-cli | OpenCLI ▸ 搜索 API | yt-dlp 被 B 站风控封死，bili-cli 无登录可搜可读 |
| 搜全网 | Exa via mcporter | — | AI 语义搜索，MCP 接入免 Key |
| GitHub | gh CLI | — | 官方工具，认证后完整 API 能力 |
| 读 RSS | feedparser | — | Python 生态标准选择 |
| 小红书 | OpenCLI（桌面） | xiaohongshu-mcp | 浏览器登录态零摩擦 |
| linkedin-scraper-mcp | Jina Reader | MCP 服务，浏览器自动化 |
2026 年 6 月实测 yt-dlp 被 B 站风控封死，作者直接切换到 bili-cli，用户零操作。这就是"首选+备选"路由设计的价值。
快速上手
装起来真的很简单。复制这句话给你的 AI Agent：
帮我安装 Agent Reach：
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
就这一步。Agent 会自己完成剩下的所有事情：
- 安装 CLI 工具（
pip install agent-reach，自带 yt-dlp、feedparser） - 安装系统基建（自动检测并安装 Node.js、gh CLI、mcporter）
- 配置搜索引擎（通过 MCP 接入 Exa，免费无需 Key）
- 检测环境（判断本地还是服务器，给出对应配置建议）
- 注册 SKILL.md（在 Agent 的 skills 目录装使用指南）
- 问你要不要装更多平台（默认只激活 6 个零配置渠道）
更新也是一句话：
帮我更新 Agent Reach：
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md
三种安装方式
| 方式 | 命令 | 适合场景 |
|---|---|---|
| 一键全自动 | agent-reach install --env=auto |
个人电脑、开发环境 |
| 安全模式 | agent-reach install --env=auto --safe |
生产服务器、多人共用机器 |
| 仅预览 | agent-reach install --env=auto --dry-run |
先看看会做什么 |
技术架构亮点
后端核心依赖是 requests、feedparser、python-dotenv、loguru、pyyaml、rich、yt-dlp，都是 Python 生态成熟的东西。
架构上有三个亮点：
- 能力层设计：只做选型、安装、体检、路由，不做读取本身。Agent 直接调上游工具，没有中间包装层，延迟低、可调试性强
- 可插拔渠道：每个渠道是一个独立文件，不信任某个组件直接换掉对应的 channel 文件就行，不影响其他
- 真实探测：doctor 命令会真实测试每个后端能不能用，坏掉的给出修复处方
适合谁用
需要斟酌的人：对 Cookie 封号风险零容忍的（需要登录态的平台都有风险）；需要大规模工业级抓取的企业（这是工具层，不是分布式爬虫）。
安全注意事项
使用 Cookie 登录的平台（Twitter、小红书等），通过脚本或 API 调用存在被平台检测并封号的风险。务必使用专用小号，不要用主账号。
原因有两个：一是平台可能检测到非浏览器 API 调用导致封禁；二是 Cookie 等同于完整登录权限，用小号可以在泄露时限制影响范围。
诊断和卸载
诊断很简单，agent-reach doctor 一条命令告诉你每个渠道通不通、当前走哪条路、坏掉的怎么修。
卸载也很干净：
agent-reach uninstall # 完整卸载
agent-reach uninstall --dry-run # 只预览不删
agent-reach uninstall --keep-config # 只删 skill 文件，保留 token写在最后
作者自己每天都在用这个项目，所以会一直维护下去。有新需求或大家想要的渠道会陆续加，每个渠道尽量保证能用、好用、免费。项目是纯 vibe coding 出来的，遇到问题可以提 Issue。
与其自己费劲折腾每个平台的配置，不如直接用 Agent Reach。它把当下最稳的接入方式都替你选好、装好、体检好了，平台封了作者修，你只管用就行。