Agent-Reach

给你的 AI Agent 一键装上互联网能力

更新于 2026-08-10

一句话定位

当下最稳的联网接入方式，替 Agent 选好、装好、体检好

AI Agent 能写代码改文档，但让它上网就抓瞎——YouTube 字幕拿不到、Reddit 被 403、小红书要登录、B站风控拦截。Agent-Reach 把「读推特、搜 Reddit、看 YouTube、刷小红书」变成一句话安装：复制安装 URL 给 Agent，几分钟后全部能用。平台封了它换路由，新渠道它加进来，你不用自己盯。

核心数据

Trendshift GitHub Trending #1 Repository of the Day；支持 Claude Code / OpenClaw / Cursor 等任意能读文件+执行命令的 Agent；中英日韩四语 README。

AI Agent 上网的五道墙

能力层，不是又一个工具

Agent-Reach 比任何具体实现高一层——负责选型、安装、体检、路由，不负责底层读取本身。读取由 Agent 直接调用上游工具完成，没有包装层。

• 换接入方式 = 调列表顺序：每个渠道是「首选 + 备选」的有序后端列表，不是重写代码
• 渠道会换代，路由不重构：2026-03 单平台 CLI 集体停更 → 重排路由即恢复；yt-dlp 被 B站风控封死(2026-06) → 换 bili-cli
• Agent 无需记命令：读完 SKILL.md 自己知道该调什么工具

12 个渠道

真实探测的渠道路由

每个渠道文件按序真实探测候选后端——不只是看命令存不存在，而是实际验证可用性，第一个完整可用的当选，坏掉的给出修复处方。

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
├── exa_search.py   → Exa via mcporter
└── __init__.py     → 渠道注册（doctor 检测用）

不信任某个组件？换掉对应的 channel 文件即可，其他不受影响——可插拔架构。

一句话安装 / 一句话更新

# 复制这句给你的 AI Agent（Claude Code / OpenClaw / Cursor…）
帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

# 已装过？更新也是一句话
帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md

# 装完体检（各渠道状态 + 当前走哪条路）
agent-reach doctor

默认安全：install 只检查环境，不自动装系统包、不改配置；显式 --system 才写入。安装向导默认只激活 6 个零配置渠道，需要登录态的（小红书/Twitter/Reddit…）点名才装。

零配置示例

• "帮我看看这个链接" → curl https://r.jina.ai/URL 读任意网页
• "这个 GitHub 仓库是干嘛的" → gh repo view owner/repo
• "这个 YouTube 视频讲了什么" → yt-dlp 提取字幕
• "B站搜一下 AI 教程" → bili search（无需登录）
• "全网搜一下 LLM 框架对比" → Exa 语义搜索
• "订阅这个 RSS" → feedparser 解析

不需要记命令——Agent 读 SKILL.md 后自己知道调什么。需要登录的平台告诉 Agent「帮我配 XXX」，它一步步引导解锁。

安全设计

• 凭据本地存储：Cookie/Token 只存本机 ~/.agent-reach/config.yaml，文件权限 600，不上传不外传
• 默认安全：install 默认不修改系统；只有显式 --system 才装外部工具和写配置
• Dry Run：agent-reach install --dry-run 预览所有操作，不做任何改动
• 可插拔：不信任某组件就换对应 channel 文件，不影响其他
• Cookie 用专用小号：README 明确警告——脚本/API 调用有被平台检测封号风险，且 Cookie 等同完整登录权限

谁适合用

需要警惕

• 封号风险真实存在：Cookie 登录平台（Twitter/小红书）脚本调用可能被平台检测封号——务必专用小号
• 依赖第三方工具存续：路由链上的开源 CLI（twitter-cli/OpenCLI 等）自身也可能停更，维护压力转移给本项目
• 登录态方案的黑盒性：OpenCLI 复用浏览器会话，行为更接近真人但语义仍是自动化，边界模糊
• 合规边界：绕过平台限制抓取需注意各平台 ToS；Cookie 导出与使用需符合平台政策
• 星标增速极快：Trending #1 光环下需持续观察路由维护是否跟得上平台反爬变化

未来空间

「能力层」抽象是对的——Agent 生态每换一代，接入方案就要换代，谁能持续维护「当下最稳路径」谁就有长期价值。若渠道覆盖扩展到更多平台 + 订阅模式社区共建路由表，可成为 Agent 联网能力的默认基础设施。