Agent Reach：一键给 AI Agent 装上全网信息触角

小新软件平替发表于2026-06-23

你的 AI Agent 能写代码、改文档、做方案——但让它去网上查点东西，就各种碰壁：YouTube 拿不到字幕、Twitter 搜不了、Reddit 被 403、小红书要登录、B站被风控拦截。每个平台都有自己的门槛，自己一个一个折腾配置，光是让 Agent 能读个推特就得花半天。

Agent Reach 就是来解决这个问题的。它不是一个读取工具本身，而是一个能力层——负责替你选型、安装、体检、路由各平台的最佳接入方式。你只需要复制一句话给 Agent，几分钟后它就能读推特、搜 Reddit、看 YouTube、刷小红书了。

Agent Reach 是什么？ 由 Neo Reid 开发的开源 Python CLI 工具（MIT 许可证），为 AI Agent 一键接入 10+ 互联网平台的信息读取能力。采用”首选+备选”多后端路由架构，平台接口失效时自动切换，用户零操作。兼容 Claude Code、Cursor、OpenClaw、Windsurf 等所有支持命令行的 Agent。

关键数据：

🌟 GitHub Stars: 快速增长中（仓库链接）
📦 当前版本：v1.5.0
⚖️ 许可证：MIT License
🧠 核心特性：一键安装，Agent 自动获得 10+ 平台的互联网信息读取能力
📦 核心特性：多后端自动路由 + 自带诊断，平台封了自动切换，用户无感

前提条件

开始之前，你需要准备：

**Python 3.10+**：已安装并可正常运行
一个 AI Agent：Claude Code、Cursor、OpenClaw、Windsurf 等任何能执行命令行的 Agent
网络环境：本地电脑无需代理；服务器部署可能需要代理（约 $1/月）

概述

本教程将带你完成 Agent Reach 的安装、基础配置和实际使用。整个流程非常简单——核心就是一句话让 Agent 自动完成，你需要手动操作的只有少数需要登录的平台。

详细步骤

第一步：一句话安装

复制这段话给你的 AI Agent：

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

Agent 会自动完成以下工作：

通过 pip install 安装 agent-reach 命令行工具
检测并安装 Node.js、gh CLI、mcporter 等系统基建
通过 MCP 接入 Exa 语义搜索（免费，无需 API Key）
在 Agent 的 skills 目录注册使用指南

安装完成后，以下渠道零配置即可用：

平台	能力	说明
🌐 网页	阅读任意网页	Jina Reader，免费
📺 YouTube	字幕提取 + 视频搜索	yt-dlp
📡 RSS	阅读任意 RSS/Atom 源	feedparser
📦 GitHub	读公开仓库 + 搜索	gh CLI
🔍 全网搜索	AI 语义搜索	Exa via mcporter
📺 B站	搜索 + 视频详情	bili-cli，无需登录
💻 V2EX	热门帖子、节点帖子、用户信息	无需配置

💡 提示：如果你的 OpenClaw 使用默认的 messaging 工具配置，需要先开启 exec 权限：
1
openclaw config set tools.profile "coding"
设置后重启 Gateway 并开启新对话即可。Claude Code、Cursor 等不受此限制。

第二步：选择并安装可选渠道

基础渠道装好后，Agent 会列出可选渠道让你选择：

🌟 OpenCLI（桌面推荐）— 一次安装，小红书/Reddit/B站字幕/Twitter 备选全解锁
🐦 Twitter/X — 搜推文、看时间线（需要 Cookie）
📕 小红书 — 搜索、阅读、评论
📖 Reddit — 搜索和阅读帖子（必须登录态）
💼 LinkedIn — Profile、职位搜索
📈 雪球 — 股票行情、热门帖子
🎙️ 小宇宙播客 — 音频转文字

告诉 Agent 你要哪些，比如”帮我装小红书和 Twitter”，或者”全部装”。

第三步：配置需要登录的平台

需要 Cookie 的平台（Twitter、小红书等），推荐使用 Cookie-Editor Chrome 插件：

在浏览器上登录对应平台
安装 Cookie-Editor 插件
点击插件 → Export → Header String
把导出的字符串发给 Agent

⚠️ 安全提醒：使用 Cookie 登录的平台存在被检测封号的风险。请务必使用专用小号，不要用主账号。Cookie 只存在你本地，不上传不外传。

以 Twitter 为例：

1	agent-reach configure twitter-cookies "导出的Cookie字符串"

第四步：验证安装状态

运行诊断命令，一条命令看清所有渠道的状态：

1	agent-reach doctor

输出会告诉你每个渠道是否正常、当前使用哪个后端、以及如何修复不正常的渠道。

第五步：实际使用

安装完成后，你不需要记任何命令。直接用自然语言告诉 Agent 即可：

“帮我看看这个链接” → 自动用 Jina Reader 读网页
“这个 YouTube 视频讲了什么” → 自动用 yt-dlp 提取字幕
“帮我搜一下推特上大家怎么评价这个产品” → 自动用 twitter-cli 搜索
“B站搜一下 AI 教程” → 自动用 bili-cli 搜索
“全网搜一下 LLM 框架对比” → 自动用 Exa 语义搜索
“帮我看看小红书上这个品的口碑” → 自动用 OpenCLI 读取

Agent 读了 SKILL.md 之后自己知道该调用哪个上游工具。

设计理念：能力层而非工具

Agent Reach 的核心设计思路是不做读取本身。它是一个能力层（capability layer），负责：

选型：为每个平台选择当下最稳定的接入方式
安装：一键安装所有依赖工具
体检：agent-reach doctor 检测每个渠道是否正常
路由：每个平台 = 首选 + 备选的有序后端列表

实际的读取操作由 Agent 直接调用上游工具完成（yt-dlp、twitter-cli、gh CLI 等），Agent Reach 不做包装层。这种设计意味着：

接入方式失效时，只需调整后端列表顺序，不需要改代码
用户可以随时审查每个上游工具的安全性
没有额外的性能开销

常见问题（FAQ）

Q: Agent Reach 完全免费吗？有没有 API 费用？
A: 100% 免费。所有后端工具（yt-dlp、twitter-cli、bili-cli、Exa 等）都是开源项目，不需要付费 API Key。唯一可能花钱的是服务器代理（约 $1/月），本地电脑不需要。

Q: 支持哪些 AI Agent 平台？
A: 兼容所有能执行命令行的 Agent，包括 Claude Code、Cursor、OpenClaw、Windsurf、Codex 等。Agent Reach 是一个安装器和配置工具，不依赖特定 Agent 平台。

Q: Cookie 安全吗？会不会泄露？
A: Cookie 只存储在本地 ~/.agent-reach/config.yaml，文件权限设为 600（仅所有者可读写），不上传不外传。代码完全开源可审查。但建议使用专用小号，降低封号风险。

Q: 平台接口失效了怎么办？
A: Agent Reach 采用多后端路由架构，每个平台都有”首选+备选”的接入方式。某个接口失效后，维护者会切换到下一个后端，用户只需运行更新命令即可。2026 年 6 月的实际案例：yt-dlp 被 B站风控封死，已自动切换到 bili-cli。

Q: 如何更新 Agent Reach？
A: 复制这段话给 Agent：

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

Q: 如何卸载？
A: 运行 agent-reach uninstall，会清除所有配置、token、skill 文件。加 --dry-run 可预览不实际删除，加 --keep-config 可保留 token 配置以便重装。

Q: 中国大陆网络环境能用吗？
A: 本地电脑大部分功能可用。访问 Reddit、Twitter 等受限平台需要配置代理：agent-reach configure proxy http://user:pass@ip:port。服务器部署建议配置代理。项目提供 AtomGit 国内镜像方便克隆。