Panniantong/Agent-Reach

Agent Reach – 为您的 AI 代理提供一键式网络能力增强

它是什么 – 一个基于 Python 的能力层，为任何命令行驱动的 AI 代理（如 Claude Code、OpenClaw、Cursor、Windsurf 等）配备即用型的多种网络服务访问能力。它能为每个平台（YouTube 字幕、Twitter 推文、Reddit 帖子、GitHub 数据、RSS 订阅等）发现、安装并配置最可靠的工具，并在网站更改 API 或封锁爬虫时保持路由更新。

为什么重要 – 现代代理虽然能编写代码或管理项目，但在被要求“上网查询”时往往会受阻。Agent Reach 消除了手动且易出错的设置工作（安装 CLI 工具、处理 Cookie、应对验证码），让代理能专注于更高层级的任务。

主要功能

• 零配置频道：支持许多热门网站（网页、YouTube、RSS、GitHub、LinkedIn 等）。
• 可选的登录频道：Twitter/X、Reddit、Facebook、Instagram、小红书等，可通过简单的“帮我配 XXX”提示启用；工具会引导用户进行 Cookie 导出或浏览器会话链接。
• 自动后端选择：每个频道定义了主要与备用实现（例如 twitter-cli → OpenCLI → bird）。CLI 会探测环境并选择第一个可用的后端，并通过 agent-reach doctor 回报选择结果。
• 安全优先安装：agent-reach install 默认仅检查环境，除非用户加上 --system 参数。试运行模式（dry-run）可精确显示将安装的内容。
• 仅限本地的凭证存储：Cookie 与 Token 存储在 ~/.agent-reach/config.yaml 中，权限设为 600；不会上传任何数据。
• 自我诊断：agent-reach doctor 会告知您哪些频道功能正常，以及如何修复损坏的频道。
• 跨代理兼容性：适用于任何能执行 Shell 指令的代理；OpenClaw 用户唯一的要求是启用 exec 工具配置文件。

如何使用

1. 将以下单行指令复制到您的代理对话框中：

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

2. 代理会执行安装脚本，该脚本会：
   • 安装 agent-reach CLI（包含 yt-dlp、feedparser 等）
   • 检查必要的系统工具（Node.js、gh CLI、mcporter）
   • 注册 SKILL.md 文件，让代理知道该调用哪些指令。
3. 安装完成后，只需要求代理“阅读此链接”、“总结 YouTube 视频”、“搜索 Reddit 关于…”，系统会自动调用适当的后端。
4. 若要更新，请发送相同的单行提示并附上更新 URL。

支持平台（摘要）

平台	开箱即用	需要额外配置
网页	✅ (Jina Reader)	—
YouTube	✅ (yt‑dlp subtitles)	—
RSS/Atom	✅ (feedparser)	—
GitHub (公开)	✅ (gh CLI)	私有仓库需登录
Twitter/X	✅ (tweet fetch)	搜索/时间轴需登录
Reddit	✅ (post fetch)	完整搜索需登录
Bilibili	✅ (bili‑cli)	—
Facebook / Instagram	✅ (OpenCLI)	需登录
小红书	✅ (OpenCLI)	需登录
LinkedIn	✅ (mcp‑server‑linkedin)	需登录
其他 (Snowball, Boss直聘等)	✅ (特定 CLI)	可能需手动 Chrome 会话

设计理念 – Agent Reach 不是另一个爬虫；它是一个能力层，抽象化了工具选择、安装与健康检查的过程。每个频道都是一个小型 Python 模块，列出主要与备用后端；doctor 指令会探测它们并回报目前启用的后端。当后端失效（例如 yt‑dlp 被 Bilibili 封锁）时，项目只需重新排序列表，用户无需更改任何代码。

安全与隐私

• 所有 Cookie/Token 均保留在用户机器上；仓库绝不会传输它们。
• 除非传入 --system，否则安装过程不会修改系统文件。
• README 警告了使用登录型频道时可能导致账号被封锁的风险，并建议使用免洗账号。

开始使用 – 仓库包含：

• docs/install.md 与 docs/update.md（您提供给代理的 URL）。
• channels/ 目录，包含各平台的适配器。
• CLI 指令：agent-reach install, agent-reach doctor, agent-reach uninstall。

谁适合使用 – 开发自定义 AI 助理的开发者、部署内部数据收集代理的团队，或是希望代理能浏览网页而无需编写爬虫代码的爱好者。

---

以上所有信息均直接取自项目的 README；未推论任何额外功能。