Agent Reach - AI Agent 互联网接入层

Agent Reach 是一个开源的 AI Agent 能力层工具，为 AI Agent 提供一键式的互联网访问能力，解决各平台 API 接入复杂、反爬限制、配置繁琐等问题。

核心定位

Agent Reach 是能力层而非包装层，负责：

选型：为每个平台选择当前最稳定的接入方式
安装：自动安装所需的 CLI 工具和依赖
体检：agent-reach doctor 命令检测各平台可用性
路由：多后端自动降级，某个接入方式失效时自动切换

优势：

✅ 完全开源免费，无 API 费用
🔒 凭据本地存储，不上传不外传
🤖 兼容所有支持命令行的 Agent（Claude Code、OpenClaw、Cursor、Windsurf 等）
🔄 持续维护，平台接入方式变化时用户无感升级

支持的平台

平台	零配置可用	需要配置	后端选型
🌐 网页	✅ 阅读任意网页	-	Jina Reader
📺 YouTube	✅ 字幕提取 + 搜索	-	yt-dlp
📡 RSS	✅ 阅读任意 RSS/Atom 源	-	feedparser
🔍 全网搜索	-	✅ 语义搜索	Exa（MCP 接入免 Key）
📦 GitHub	✅ 公开仓库读取 + 搜索	✅ 私有仓库/Issue/PR	gh CLI
🐦 Twitter/X	✅ 单条推文读取	✅ 搜索/时间线	twitter-cli → OpenCLI → bird
📺 B站	✅ 搜索 + 视频详情	✅ 字幕	bili-cli → OpenCLI → 搜索 API
📖 Reddit	-	✅ 搜索/读帖	OpenCLI → rdt-cli
📕 小红书	-	✅ 搜索/阅读/评论	OpenCLI → xiaohongshu-mcp → xhs-cli
💼 LinkedIn	✅ 公开页面读取	✅ Profile/职位搜索	linkedin-mcp → Jina Reader
💻 V2EX	✅ 热门帖子/详情/回复	-	官方 API
📈 雪球	✅ 股票行情/热门帖子	-	公开 API
🎙️ 小宇宙播客	-	✅ 音频转文字	Whisper 转录

架构设计

多后端路由架构

每个平台都有「首选 + 备选」的有序后端列表，按优先级探测可用性：

channels/
├── web.py          → Jina Reader
├── twitter.py      → twitter-cli ▸ OpenCLI ▸ bird
├── youtube.py      → yt-dlp
├── github.py       → gh CLI
├── bilibili.py     → bili-cli ▸ OpenCLI ▸ 搜索 API
├── reddit.py       → OpenCLI ▸ rdt-cli
├── xiaohongshu.py  → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli
├── linkedin.py     → linkedin-mcp ▸ Jina Reader
├── rss.py          → feedparser
├── exa_search.py   → Exa via mcporter
└── __init__.py     → 渠道注册

核心组件

CLI 入口：agent_reach/cli.py - 命令行接口（install/doctor/uninstall 等）
渠道层：agent_reach/channels/ - 每个平台独立实现，继承自 BaseChannel
诊断引擎：agent_reach/doctor.py - 检测各后端可用性
集成层：agent_reach/integrations/ - MCP 服务器、第三方工具集成
Skill 配置：agent_reach/skill/ - OpenClaw Skill 定义和使用指南

快速使用

安装

# 全自动安装
pip install agent-reach
agent-reach install --env=auto
 
# 安全模式（仅列出需要安装的内容，不自动执行）
agent-reach install --env=auto --safe

OpenClaw 前置配置

Agent Reach 需要执行 shell 命令权限，OpenClaw 默认 messaging 配置需要切换到 coding 模式：

openclaw config set tools.profile "coding"
openclaw gateway restart

常用命令

# 查看所有平台状态和当前使用的后端
agent-reach doctor --json
 
# 检查更新
agent-reach check-update
 
# 卸载
agent-reach uninstall

Skill 集成

Agent Reach 提供预定义的 OpenClaw Skill，自动触发场景：

全网调研、搜索、查找类需求
涉及特定平台的关键词：小红书、Twitter、B站、Reddit、LinkedIn、YouTube、GitHub 等
用户发送任何 URL 链接

Skill 包含完整的命令路由表和使用指南，Agent 无需记忆具体命令，按指南调用即可。

安全设计

🔒 凭据本地存储在 ~/.agent-reach/config.yaml，文件权限 600
🛡️ 安全模式不自动修改系统，由用户确认后执行
👀 完全开源，代码可审查
🧩 可插拔架构，不信任的组件可单独替换
⚠️ Cookie 类平台建议使用小号，避免主账号被封风险

维度	Agent Reach	BrowserAct	Playwright
定位	内容读取层	浏览器自动化	通用浏览器测试
场景	信息获取、搜索、内容提取	网页操作、表单提交、交互	全场景浏览器自动化
使用成本	一键安装，零配置可用	需要浏览器环境，配置复杂	需编写自动化脚本
平台覆盖	13+ 专项平台优化	通用网页	通用网页
反爬应对	多后端路由，自动降级	完整浏览器环境，风控成本高	需自行处理反爬

Wiki AI

目录