你的 AI Agent 为啥需要这个？
现在的 AI Agent 已经能写代码、改文档、管项目，看起来挺能干的——但一旦让它去网上查点资料，立马就"瞎"了：
- 🎬 "帮我总结一下这个 YouTube 教程"——拿不到字幕
- 🐦 "看看推特上大家怎么评价这个产品"——Twitter API 收费
- 📖 "去 Reddit 搜搜有没有人遇到过这个 bug"——403 封禁，IP 被拉黑
- 📕 "看看小红书上这个产品的口碑"——必须登录才能访问
- 📺 "B 站有个技术视频，帮我提炼要点"——通用下载工具全军覆没
- 🔍 "搜一下最新的 LLM 框架对比"——搜索质量参差不齐，要么付费
- 🌐 "看看这个网页写了啥"——抓回来一堆 HTML 标签，没法读
- 📦 "这个 GitHub 仓库是干啥的？Issue 里讨论了什么？"——能用，但配置很麻烦
- 📡 "帮我订阅这几个 RSS 源"——得自己装库写解析代码
这些问题单独解决都不难，但每个平台都有自己的门槛——付费 API、要绕过的封锁、必须登录的账号、要清洗的脏数据。光让 Agent 读个推特就得折腾大半天。
Agent Reach 的核心理念就一句话：把"让 Agent 上网"变成"告诉 Agent 一句话"。
一键安装 / 一键更新
复制下面这句话给你的 AI Agent（Claude Code、OpenClaw、Cursor、Windsurf 等都行）：
Text帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
几分钟后，你的 Agent 就能读推特、搜 Reddit、看 YouTube、刷小红书了。
已经装过？想更新也是一句话：
Text帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md
✅ 上手前你需要知道的事
| 特性 | 说明 |
|---|---|
| 💰 完全免费 | 所有工具开源、所有 API 免费。唯一可能花钱的是服务器代理（约 $1/月），本地电脑完全不需要 |
| 🔒 隐私安全 | Cookie 只存你本地，不上传不外传。代码完全开源，随时可审查 |
| 🔄 持续换代 | 每个平台都做了「首选 + 备选」多后端路由。某条路失效了自动切下一条，你完全无感（实测案例：2026-06 yt-dlp 被 B 站风控封死 → 已切换 bili-cli，用户零操作） |
| 🤖 全 Agent 兼容 | Claude Code、OpenClaw、Cursor、Windsurf……任何能跑命令行的 Agent 都能用 |
| 🩺 自带诊断 | agent-reach doctor 一条命令告诉你哪个渠道通、哪个不通、怎么修 |
🌍 支持的平台一览
| 平台 | 装好即用 | 配置后解锁 | 配置方式 |
|---|---|---|---|
| 🌐 网页 | 阅读任意网页 | — | 无需配置 |
| 📺 YouTube | 字幕提取 + 视频搜索 | — | 无需配置 |
| 📡 RSS | 阅读任意 RSS/Atom 源 | — | 无需配置 |
| 🔍 全网搜索 | — | 语义搜索 | 自动配置（MCP 接入，免 Key） |
| 📦 GitHub | 读公开仓库 + 搜索 | 私有仓库、提 Issue/PR、Fork | 告诉 Agent「帮我登录 GitHub」 |
| 🐦 Twitter/X | 读单条推文 | 搜索、浏览时间线、读长文 | 告诉 Agent「帮我配 Twitter」 |
| 📺 B 站 | 搜索 + 视频详情（bili-cli，无需登录） | 字幕（OpenCLI） | 告诉 Agent「帮我配 B 站」 |
| — | 搜索 + 读帖 + 评论 | 桌面装 OpenCLI 用浏览器登录态；或 rdt-cli + Cookie | |
| — | 搜索、主页、Feed、群组 | 桌面装 OpenCLI（复用 Chrome 登录态） | |
| — | 用户搜索、Profile、帖子、Explore | 桌面装 OpenCLI（复用 Chrome 登录态） | |
| 📕 小红书 | — | 搜索、阅读、评论 | 桌面装 OpenCLI（刷过小红书即可）；服务器用 xiaohongshu-mcp 扫码 |
| Jina Reader 读公开页 | Profile 详情、公司页、职位搜索 | 告诉 Agent「帮我配 LinkedIn」 | |
| 💻 V2EX | 热门帖、节点帖、详情+回复、用户信息 | — | 无需配置 |
| 📈 雪球 | 股票行情、搜索、热门帖、热门股 | — | 告诉 Agent「帮我配雪球」 |
| 🎙️ 小宇宙播客 | — | 音频转文字（Whisper 免费） | 告诉 Agent「帮我配小宇宙播客」 |
不知道怎么配？不用查文档。直接告诉 Agent「帮我配 XXX」，它会一步步引导你。
💡 小贴士：需要 Cookie/登录态的平台（Twitter、小红书、Reddit、Facebook、Instagram 等），优先用你自己浏览器里登录过的账号。OpenCLI 能复用 Chrome 登录态；传统 CLI 才需要用 Cookie-Editor 导出 Cookie。🔒 Cookie 只存本地，不上传不外传。代码开源可审计。💻 本地电脑无需代理，只有部署在服务器上才需要（约 $1/月）。
🚀 快速上手
⚠️ OpenClaw 用户请注意
Agent Reach 需要 Agent 执行 shell 命令（pip install、mcporter、twitter 等）。如果你的 OpenClaw 用了默认的 messaging 工具配置，Agent 是没法跑命令的。安装前先开启 exec 权限：
Bashopenclaw config set tools.profile "coding"
或者在 ~/.openclaw/openclaw.json 里设置 "tools": { "profile": "coding" }，然后重启 Gateway（openclaw gateway restart）开新对话即可。其他平台（Claude Code、Cursor、Windsurf）不受这个限制。
三种安装姿势
| 方式 | 适用场景 |
|---|---|
| 🚀 一键全自动 | 个人电脑、开发环境 |
| 🛡️ 安全模式 | 生产服务器、多人共用机器——不自动装系统包，只列清单 |
| 👀 仅预览 | 先看看会做什么，不实际改动 |
装好之后能干啥的？
| 你说 | Agent 调用的工具 |
|---|---|
| "帮我看看这个链接" | 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 之后自己知道该调什么。需要登录的平台（小红书、Twitter、Reddit、Facebook、Instagram），告诉 Agent「帮我配 XXX」就解锁。
🧠 能力边界：「读」和「动手」是两回事
有些任务已经超出"读"的范畴——登录后的网页操作、表单提交、多账号隔离、并行浏览器会话、自动化流程里的登录/验证/风控处理。这类「动手」场景，建议配合 BrowserAct 这类浏览器自动化工具——30+ 预制平台技能，同样支持 Claude Code / OpenClaw / Cursor 等主流 Agent。
当前选型表
| 场景 | 首选 | 备选 | 选型理由 |
|---|---|---|---|
| 读网页 | Jina Reader | — | 免费，免 API Key |
| 读推特 | twitter-cli | OpenCLI | 实测搜索稳定；OpenCLI 走浏览器登录态兜底 |
| OpenCLI（桌面） | rdt-cli | 匿名接口已废、官方 API 审批制——只剩登录态 | |
| OpenCLI（桌面） | — | Graph API/Groups API 权限收紧；浏览器登录态最实用 | |
| OpenCLI（桌面） | 官方 Graph API | instaloader 类路径不稳；OpenCLI 复用真实浏览器会话 | |
| YouTube 字幕 + 搜索 | yt-dlp | — | 154K Star，YouTube 仍是最佳（不再用于 B 站） |
| B 站 | bili-cli | OpenCLI ▸ 搜索 API | yt-dlp 被 B 站风控 412 封死（2026-06 实测） |
| 搜全网 | Exa via mcporter | — | AI 语义搜索，MCP 接入免 Key |
| GitHub | gh CLI | — | 官方工具，认证后完整 API |
| 读 RSS | feedparser | — | Python 生态标配 |
| 小红书 | OpenCLI（桌面） | xiaohongshu-mcp（服务器）▸ xhs-cli | xhs-cli 作者已转投 OpenCLI（24K Star） |
| linkedin-scraper-mcp | Jina Reader | MCP 服务，浏览器自动化 |
📌 这些都是「当前选型」，基于真机实测定期复核。某条路失效了我们换下一条——agent-reach doctor 永远告诉你现在走的是哪条。
🔐 安全性
Agent Reach 在设计上就把安全放在第一位：
| 措施 | 说明 |
|---|---|
| 🔒 凭据本地存储 | Cookie、Token 只存你本机 ~/.agent-reach/config.yaml，文件权限 600，不上传不外传 |
| 🛡️ 安全模式 | agent-reach install --safe 不自动改系统，只列出需要什么，由你决定装不装 |
| 👀 完全开源 | 代码透明可审计。所有依赖工具也都是开源项目 |
| 🔍 Dry Run | agent-reach install --dry-run 预览所有操作，不做任何改动 |
| 🧩 可插拔架构 | 不信任某个组件？换掉对应的 channel 文件即可，其他不受影响 |
🍪 Cookie 安全建议
⚠️ 封号风险提醒：用 Cookie 登录的平台（Twitter、小红书等），通过脚本/API 调用存在被平台检测并封号的风险。请务必使用专用小号，不要用主账号。
需要 Cookie 或登录态的平台（Twitter、小红书、Reddit、Facebook、Instagram 等）建议用专用小号，原因有两个：
- 封号风险——平台可能检测到非正常浏览器的 API 调用行为，导致账号被限制或封禁
- 安全风险——Cookie 等同于完整登录权限，用小号可以在凭据泄露时限制影响范围
📦 安装 / 更新 / 卸载速查
安装
| 方式 | 命令 | 适合 |
|---|---|---|
| 🚀 一键全自动 | agent-reach install --env=auto | 个人电脑、开发环境 |
| 🛡️ 安全模式 | agent-reach install --env=auto --safe | 生产服务器、多人共用 |
| 👀 仅预览 | agent-reach install --env=auto --dry-run | 先看看会做什么 |
卸载
Bashagent-reach uninstall
会清除：~/.agent-reach/（含所有 token/cookie）、各 Agent 的 skill 文件、mcporter 中的 MCP 配置。
Bash# 只预览，不实际删除agent-reach uninstall --dry-run# 只删 skill 文件，保留 token 配置（重装时用）agent-reach uninstall --keep-config
卸载 Python 包本身：pip uninstall agent-reach