Agent Reach

项目简介

Agent Reach 是一个面向 AI Agent 的能力层，而不是具体抓取工具。它负责为各平台选择、安装、体检并路由当前可用的接入后端，让 Agent 能读取和搜索网页、YouTube、RSS、GitHub、Twitter/X、B站、Reddit、小红书等渠道；实际读取由 Agent 直接调用上游工具完成，没有额外包装层。

核心功能

• 一条 CLI 为 AI Agent 接入多个互联网平台，覆盖网页、YouTube、RSS、GitHub、Twitter/X、B站、Reddit、小红书、LinkedIn、V2EX、雪球等。
• 每个平台采用首选加备选的有序后端列表，失效时调整路由而非重写代码。
• 提供 agent-reach doctor 诊断，显示各渠道状态和当前使用的后端，并给出修复方向。
• 默认只激活零配置渠道，需要登录态的平台由 Agent 询问后再安装。
• Cookie 和 Token 仅保存在本地配置文件，代码开源可审查；安装默认只检查环境，显式使用 --system 才修改系统。
• 兼容 Claude Code、OpenClaw、Cursor、Windsurf 等能执行命令行的 Agent。

适用场景

• 让 Agent 读取网页、YouTube 字幕和 RSS 内容，进行信息摘要。
• 让 Agent 搜索 Twitter/X、Reddit、B站、小红书等平台上的讨论和口碑。
• 让 Agent 查看 GitHub 仓库、Issue，或进行全网语义搜索与 LLM 框架对比。
• 在服务器或本地为多个 Agent 统一安装、体检和更新互联网接入渠道。

快速开始

• 向 AI Agent 发送“帮我安装 Agent Reach”，并附上项目提供的 docs/install.md 安装文档。
• 已安装时，向 AI Agent 发送“帮我更新 Agent Reach”，并附上 docs/update.md 更新文档。
• OpenClaw 用户安装前需开启 exec 权限，可执行 openclaw config set tools.profile "coding"，然后重启 Gateway 并开启新对话。

部署与要求

• 项目标注支持 Python 3.10+。
• 安装流程会检查 Node.js、gh CLI、mcporter，并给出缺失项的安装方式。
• 默认安装只检查环境，不自动安装系统包或写入配置；只有显式使用 --system 才安装依赖并写入配置。
• 本地电脑不需要代理；部署在服务器上时才可能需要代理，成本约为每月 1 美元。
• OpenClaw 用户需开启 exec 权限，因为 Agent Reach 依赖 Agent 执行 shell 命令。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。
• 通过脚本或 API 调用使用 Cookie 登录的平台，可能触发账号限制或封禁。
• Reddit 没有零配置路径，匿名接口已被封，需要登录态。
• B站原有 yt-dlp 路径因风控被封死，当前改用 bili-cli。
• 服务器部署可能需要代理，本地电脑不需要。
• 默认只激活零配置渠道，需要登录态的平台需点名安装。