Panniantong/Agent-Reach

Overview

项目介绍

Technical Route

技术路线

Agent-Reach 采用「能力路由层+上游工具复用」架构，以 CLI 为统一入口，为 AI Agent 提供跨平台内容读取能力。核心是基于 channels 目录的多后端路由机制，每个平台配置首选+备选工具链，通过真实探测自动切换可用后端；配合本地凭据存储、环境自动检测、Agent 技能注册等模块，实现零 API 费用、低配置成本的互联网内容接入，用户无需关注底层工具迭代，只需通过自然语言指令即可让 AI 完成多平台搜索与读取。

1. 1渠道路由层：每个平台对应 channels 目录下独立文件，按序配置首选+备选后端工具链，如 B站 采用 bili-cli ▸ OpenCLI ▸ 搜索 API 的路由逻辑，会自动真实探测工具可用性，选择第一个可用后端，失效时自动切换，无需用户手动调整。
2. 2CLI 入口层：以 `agent-reach` 命令为统一操作入口，提供 install、doctor、uninstall 等核心指令，install 会自动检测环境，安装 Node.js、gh CLI 等系统基建，注册 SKILL.md 到 Agent 技能目录，让 AI 自动识别并调用对应工具；doctor 命令可检测各渠道连通状态。
3. 3凭据安全层：Cookie、Token 等敏感数据仅存储在本地 `~/.agent-reach/config.yaml`，文件权限设为 600 仅所有者可读写，支持安全模式安装，不会自动修改系统，还提供 Dry Run 预览操作功能，避免误操作，同时支持专用小号凭据建议降低封号风险。
4. 4上游工具集成层：复用开源工具实现内容读取，如用 yt-dlp 提取 YouTube 字幕、Jina Reader 读取网页、gh CLI 访问 GitHub、twitter-cli 通过 Cookie 免费访问 Twitter，无需依赖各平台付费 API，同时通过 MCP（模型上下文协议）接入 Exa 实现免费全网语义搜索。
5. 5Agent 兼容层：适配 Claude Code、Cursor、OpenClaw 等支持命令行的 AI Agent，安装时会自动注册 SKILL.md，让 AI 能根据需求自动调用对应工具；针对 OpenClaw 需提前开启 exec 权限的场景，提供明确的配置指引。
6. 6维护迭代层：采用「首选+备选」多后端策略应对平台风控变化，如 2026 年 yt-dlp 被 B站 风控封死后，自动切换为 bili-cli 作为首选后端，用户无需手动修改配置，仅需通过 `agent-reach doctor` 即可查看当前使用的后端。

Why Trending

为什么它会上榜

结合增长、最近更新与社区关注，给出一个更接近“决策参考”的上榜解读。

• 社区关注度上升：近期新增 +5364 Stars（this week），讨论热度明显提高。
• 维护活跃：最近更新于 2026/06/13，更可能持续迭代与补齐文档/生态。
• 方向聚焦：覆盖 agent-infrastructure / ai-agent / ai-search / automation 等主题，适合在该方向快速落地与对比选型。
• 定位清晰：一款命令行工具，无需API费用，可让AI代理读取搜索推特、B站、小红书等多平台内容，拓展AI的信息获取范围。

Quick Start

怎么开始

1. 确保安装Python环境；2. 克隆仓库到本地；3. 运行命令安装依赖并启动工具

使用前注意事项

暂无明显注意事项；如果要用于生产环境，建议先做依赖审计与安全检查。

Related

相关项目