agent-reach

Agent Reach（agent-reach）是一个面向 AI Agent 的互联网接入能力层，目标是让 Agent 通过一句自然语言指令完成工具选型、安装、体检和路由配置。项目以 MIT 协议开源，要求 Python 3.10+。 核心思路：Agent Reach 本身不直接封装各平台的读取逻辑，而是由 Agent 直接调用上游工具（如 yt-dlp、gh CLI、feedparser、Jina Reader、OpenCLI、twitter-cli、bili-cli 等），Agent Reach 负责维护“每个平台当前可用的接入方式”并生成 SKILL.md 供 Agent 使用。每个渠道都设计为“首选 + 备选”的有序后端列表，安装或诊断时会真实探测可用性，某个前置后端失效时切换至下一个，用户可通过 `agent-reach doctor` 查看各渠道状态和当前生效的路由。 快速使用：将安装指令（读取 docs/install.md）发送给支持执行 shell 命令的 Agent（如 Claude Code、OpenClaw、Cursor、Windsurf），Agent 会按步骤安装 agent-reach CLI、检查 Node.js、gh CLI、mcporter 等基础依赖，并在显式授权下写入 Agent 的 skills 目录。默认安全：`agent-reach install` 只读检查环境，不自动修改系统或写入配置；只有显式传入 `--system` 才安装系统依赖和写入配置；另有 `--dry-run` 可预览所有操作。更新同样可通过一条指令完成。 已接入的渠道包括：网页阅读（Jina Reader）、YouTube 字幕提取与视频搜索（yt-dlp）、RSS/Atom 阅读（feedparser）、全网语义搜索（Exa via mcporter）、GitHub（gh CLI，含仓库阅读、搜索，配置后支持私有仓库、Issue/PR）、Twitter/X 推文阅读与搜索、B站搜索与视频详情（bili-cli 等）、Reddit 搜索与帖子阅读、Facebook 主页与 Feed、Instagram 用户与帖子、小红书搜索与阅读、LinkedIn 资料与职位搜索、V2EX、雪球、小宇宙播客（Whisper 转录）等。部分渠道零配置即可用；需要登录态的渠道由 Agent 引导用户完成配置，例如通过 Cookie-Editor 手工导出 Cookie，或复用桌面浏览器已有的登录会话。 安全与隐私：Cookie/Token 保存在本地 `~/.agent-reach/config.yaml`（文件权限 600），不上传、不外传；代码与依赖工具均开源可审查。项目明确提醒：使用 Cookie 登录的平台存在被平台检测并封号的风险，建议使用专用小号而非主账号。`agent-reach uninstall` 可清除本地配置、各 Agent 的 skill 文件及 MCP 配置，支持 `--dry-run` 预览和 `--keep-config` 保留配置以便重装。 设计定位上，Agent Reach 是一个“能力层”而非又一个具体工具：底层读取由 Agent 直接调用上游工具完成，Agent Reach 负责选型、安装、体检、路由，以应对平台接口、反爬策略和 CLI 工具持续变化的情况。