Agent Reach 使用教程

📖 项目简介

Agent Reach 是一个开源的 AI Agent 互联网能力扩展工具。它能让你的 AI Agent（OpenClaw、Claude Code、Cursor 等）轻松访问 Twitter、Reddit、YouTube、GitHub、B站、小红书等 15 个主流平台，完全不需要付费 API Key，只需提供平台 Cookie 即可。

一句话发给你的 Agent，几分钟后它就能读推特、搜 Reddit、看 YouTube、刷小红书了。安装、配置全自动，Agent 自己搞定一切。

💡

GitHub 地址： https://github.com/Panniantong/Agent-Reach

✨ 核心亮点

🆓

零 API 费用

所有工具开源，所有 API 免费，无需任何付费密钥

🌐

15 个平台

覆盖推特、小红书、YouTube、B站、Reddit 等全网平台

🔒

隐私安全

Cookie 只存本地，不上传不外传，代码完全开源可审查

🤖

兼容所有 Agent

OpenClaw、Claude Code、Cursor、Windsurf 都能用

📋 支持平台一览

平台	能力	是否需要配置
🌐 网页	阅读任意网页	无需配置
📺 YouTube	字幕提取 + 视频搜索	无需配置
📡 RSS	阅读任意 RSS/Atom 源	无需配置
🔍 全网搜索	全网语义搜索	自动配置（MCP 接入）
📦 GitHub	读公开仓库 + 搜索	无需配置
🐦 Twitter/X	读推文、搜索、发推	需配置 Cookie
📺 B站	字幕提取 + 搜索	本地无需配置
📖 Reddit	搜索、读帖子和评论	需配置代理（服务器）
📕 小红书	阅读、搜索、发帖、评论、点赞	需配置 Cookie
💼 LinkedIn	Profile 详情、公司页面	需配置
💬 微信公众号	搜索 + 阅读全文	无需配置
📰 微博	热搜、搜索、用户动态	无需配置
💻 V2EX	热门帖子、节点帖子	无需配置
📈 雪球	股票行情、搜索	无需配置
🎵 抖音	视频解析、无水印下载	需配置

💻 环境要求

Python：3.8+
Node.js：推荐安装（部分工具依赖）
AI Agent：OpenClaw / Claude Code / Cursor / Windsurf 等任意能跑命令行的 Agent
Docker：可选（小红书等平台的 MCP 服务需要）

⚠️

OpenClaw 用户注意：如果使用默认的 messaging 工具配置，Agent 无法执行 shell 命令。安装前请先开启 exec 权限：openclaw config set tools.profile "coding"

🚀 安装步骤

一句话安装（推荐）

复制下面这句话发给你的 AI Agent，它会自动完成所有安装和配置：

发给你的 Agent

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

Agent 会自动完成：安装 CLI 工具、安装系统依赖、配置搜索引擎、注册 SKILL.md。

检查安装状态

                        bash
                        agent-reach doctor
                    

一条命令查看每个渠道的可用状态，哪个通、哪个不通、怎么修，一目了然。

配置需要 Cookie 的平台（可选）

对于小红书、Twitter 等需要登录的平台，直接告诉 Agent：

                        text
                        帮我配小红书
帮我配 Twitter
                    

Agent 会一步一步引导你完成配置。推荐使用 Chrome 插件 Cookie-Editor 导出 Cookie。

手动安装

安装 Python 包

                        bash
                        pip install agent-reach
                    

运行安装脚本

                        bash
                        agent-reach install --env=auto
                    

自动检测环境并安装所有依赖（Node.js、gh CLI、mcporter、bird 等）。

验证安装

                        bash
                        agent-reach doctor
                    

🔧 底层原理

Agent Reach 本质是一个脚手架，帮你把各平台的工具选型和配置做好了。安装完成后，Agent 直接调用上游开源工具：

🌐

Jina Reader

读网页 · 9.8K Star · 免费无 API Key

🐦

Bird CLI

读推特 · Cookie 登录 · 完全免费

📺

yt-dlp

视频字幕 · 148K Star · 1800+ 站点

📕

小红书 MCP

模拟真实环境 · Docker 部署 · 稳定安全

每个渠道都是可插拔的，不满意某个工具？换掉对应文件就行，不影响其他渠道。

🔒 安全提醒

⚠️

使用专用小号：需要 Cookie 的平台（Twitter、小红书等），请务必使用专用小号，不要用主账号。平台可能检测到非正常浏览器的 API 调用行为，存在封号风险。

凭据本地存储：Cookie、Token 只存在你本机 ~/.agent-reach/config.yaml，文件权限 600，不上传不外传
安全模式：agent-reach install --safe 不会自动修改系统，只列出需要什么
完全开源：代码透明，随时可审查

❓ 常见问题

Q: Agent Reach 完全免费吗？

100% 免费。所有后端工具都是开源项目，不需要付费 API Key。唯一可选开销是服务器代理（约 $1/月），本地电脑不需要。

Q: 支持哪些 AI Agent？

支持所有能执行命令行的 Agent：OpenClaw、Claude Code、Cursor、Windsurf、Codex 等。

Q: 小红书访问稳定吗？

小红书使用 MCP 工具通过 Docker 运行，完全模拟人类真实使用环境，非常稳定安全。不过仍建议使用专用小号。

Q: 怎么更新？

一句话：发给你的 Agent「帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md」

Q: 怎么卸载？

运行 agent-reach uninstall 即可清除所有配置和 Cookie。卸载 Python 包：pip uninstall agent-reach。