Agent-Reach 智能体触达框架

Agent Reach 简介

Agent Reach 是一个面向 AI Agent 的网络访问能力层，负责为各类网站平台选型、安装、体检、路由。它本身不实现具体的抓取逻辑，而是作为编排层，让 Agent 能直接调用上游工具完成读取与搜索。当某个接入方式失效时（例如 yt-dlp 被 B站风控封死），项目会切换到备选后端，用户无需关心底层变动。

为什么需要 Agent Reach

AI Agent 已经能写代码、管文档，但让它访问外部网络时会遇到各种障碍：YouTube 字幕拿不到、Twitter API 需要付费、Reddit 匿名接口返回 403、小红书必须登录、B站被通用工具风控、全网搜索缺乏免费方案等。每个平台都有自己的门槛，逐个排查成本很高。

Agent Reach 将上述流程压缩成两句话发给 Agent：

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

Agent 会自动完成 CLI 安装、依赖检查、MCP 接入、SKILL.md 注册等步骤。

核心特性

• 完全免费：所有工具开源、API 免费；仅服务器部署可能需要约 1 美元/月的代理
• 隐私安全：Cookie 仅存储于本地 ~/.agent-reach/config.yaml（权限 600），不上传不外传
• 多后端路由：每个平台维护「首选 + 备选」有序列表，失效自动切换
• 兼容主流 Agent：Claude Code、Cursor、Windsurf、OpenClaw 等任何能执行命令行的 Agent 都可使用
• 内置诊断：agent-reach doctor 一条命令展示每个渠道的连通状态与当前使用的后端

支持的平台

技术架构

每个平台对应一个 channel 文件，按序真实探测各候选后端（而非仅检查命令是否存在），首个完整可用的当选：

channels/
├── web.py         → Jina Reader
├── twitter.py     → twitter-cli ▸ OpenCLI ▸ bird
├── bilibili.py    → bili-cli ▸ OpenCLI ▸ 搜索 API
├── reddit.py      → OpenCLI ▸ rdt-cli
├── xiaohongshu.py → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli
├── exa_search.py  → Exa via mcporter
└── ...

当前关键选型：网页读取用 Jina Reader、全网搜索用 Exa（经 mcporter 接入）、GitHub 用 gh CLI、YouTube 用 yt-dlp、RSS 用 feedparser、LinkedIn 用 mcp-server-linkedin。

安装与卸载

# 默认安全检查（仅检查环境，不修改系统）
agent-reach install --env=auto

# 显式安装系统依赖与 MCP 接入
agent-reach install --env=auto --system

# 仅预览操作
agent-reach install --env=auto --dry-run

卸载命令：

agent-reach uninstall              # 清除配置、skill 文件、MCP 接入
agent-reach uninstall --dry-run    # 仅预览
agent-reach uninstall --keep-config  # 保留 token 配置
pip uninstall agent-reach          # 卸载 Python 包本身

安全提示

使用 Cookie 登录的平台（Twitter、小红书等）存在被平台检测并封号的风险，建议使用专用小号而非主账号。默认情况下 agent-reach install 不会自动安装系统包或写入配置，必须显式传入 --system 才会修改系统。