Agent-Reach

概述

Agent-Reach 是一个给 AI Agent 一键装上”全网信息获取能力”的 CLI 脚手架工具（非框架），MIT 协议完全开源免费、无需任何 API Key。GitHub 50.7k Stars。把跨平台信息获取封装成开箱即用命令，实际干活的是上游工具（xreach 读 Twitter、yt-dlp 读 YouTube），中间无包装层、性能损耗为零。

项目地址：github.com/Panniantong/Agent-Reach
星标：50.7k（截至 2026-07-11 源文）
协议：MIT
公众号作者：程序员凯凯（github.com/lenyanjgk）

定位：脚手架而非框架

框架会包一层又一层，最后连底层工具长什么样都不知道。脚手架只管帮你把环境搭好，实际干活的还是上游工具。装完之后 Agent 直接调用上游工具，中间没有包装层。上游工具更新不用等 Agent-Reach 跟进，工具链每一环可独立替换。

覆盖平台

开箱即用（零配置）

任意网页（读取+清理 HTML）
YouTube（yt-dlp 字幕/搜索）
RSS/Atom 订阅
微信公众号（搜文章+全文 Markdown）
微博（热搜/动态/评论）
V2EX（热门/节点/详情+回复）
全网语义搜索（无需 API Key）

简单配置后解锁

GitHub（gh CLI，私有仓库/Issue/PR/Fork）
X/Twitter（Cookie 认证，搜推文/时间线/发推）
B 站（本地字幕提取与搜索）
Reddit（代理+Exa）
小红书（npm rednote-mcp 扫码登录）
抖音（视频解析与内容获取）
LinkedIn（个人资料/公司/职位搜索）
小宇宙播客（Whisper 音频转文字）

安装与使用

对 Agent 说”帮我安装 Agent Reach”即可
手动：pip install https://github.com/Panniantong/agent-reach/archive/main.zip + agent-reach install --env=auto
Skill 安装：npx skills add Panniantong/Agent-Reach@agent-reach
安全模式：不自动装系统包，只告知需装什么
诊断：agent-reach doctor 列出所有渠道状态（绿=可用，灰=需配置）

架构

每平台独立一个 Python 文件（twitter.py、youtube.py…），每模块有 check() 方法供 doctor 用。加平台加文件、删平台删文件，模块化干净。实际数据读写不经过 Agent-Reach。

风险

Cookie 认证封号风险：Twitter/小红书模拟浏览器登录，平台检测异常可能封号，建议小号
认证本地存储：Cookie/Token 存 ~/.agent-reach/config.yaml（权限 600）
平台接口稳定性：xreach 绕官方 API，Twitter 随时可能改接口
Windows 兼容性：底层工具多为 Mac/Linux 设计；GBK 编码 bug（需手改加 encoding=‘utf-8’）

成本套利

Twitter 官方 API：免费档基本只能发不能读，按量计费每月约 200 美元（约 1400+ 人民币）。Agent-Reach：每月 0 元。个人开发者/小团队探索期先用 Agent-Reach 验证需求，业务稳定再升官方 API。

兼容

Claude Code、OpenClaw、Cursor、Windsurf，只要跑得动命令行即可。

与 MCP 的关系

Agent-Reach 解决的是信息层接入问题（打通平台访问限制），而非 MCP 解决的协议层标准化问题（Agent ↔ 工具通信标准）。二者正交：Agent-Reach 装好的上游工具，仍可通过 MCP 暴露给 Agent 调用。见 AI-MCP。

10xAI Wiki

导航