netreach

# 👁️ NetReach — no-login 版 > 给你的 AI Agent 一键装上互联网「只读 + 搜索」能力 —— 只收录**无需登录、爬虫风险低**的公开数据源。 --- ## 支持的平台（全部零配置，无需登录） | 平台 | 能力 | 后端 | |------|------|------| | 🌐 网页 | 读任意网页 → Markdown | Jina Reader（`curl r.jina.ai/URL`） | | 📺 YouTube | 字幕提取 + 视频搜索 | yt-dlp | | 📡 RSS | 解析任意 RSS/Atom 源 | feedparser | | 📦 GitHub | 公开仓库 + 代码搜索 | gh CLI（公开数据无需登录） | | 💻 V2EX | 热门/节点/帖子详情+回复/用户 | 公开 API | | 📺 B站 | 搜索 + 视频详情（无需登录） | bili-cli ▸ 搜索 API | | 🔍 全网搜索 | AI 语义搜索 | Exa（mcporter MCP，免费无需 Key） | > ⚠️ 注意：B站**字幕**需要浏览器登录态，不在本版本范围内（不登录只能搜视频、看详情）。 --- ## 设计理念 **NetReach 是一个能力层（capability layer），不是又一个工具。** 它负责**选型、安装、体检、路由**，不负责底层读取本身。读取由 Agent 直接调用上游工具（yt-dlp、gh、feedparser、bili-cli 等）完成，没有包装层。 每个平台 = **首选 + 备选的有序后端列表**。换接入方式 = 调整列表顺序，不是重写代码。`agent-reach doctor` 会告诉你每个平台**当前在用哪个后端**。 ``` channels/ ├── web.py → Jina Reader ├── youtube.py → yt-dlp ├── rss.py → feedparser ├── github.py → gh CLI ├── v2ex.py → V2EX 公开 API（直接 HTTP 实现） ├── bilibili.py → bili-cli ▸ B站搜索 API ├── exa_search.py → Exa via mcporter └── __init__.py → 渠道注册 ``` 每个渠道文件按序**真实探测**各候选后端（不只是看命令存不存在），第一个完整可用的当选；坏掉的会给出修复处方。 --- ## 快速上手 ```bash # 安装（默认安全检查，只读不改系统） agent-reach install --env=auto # 显式授权安装系统依赖 + 注册 skill agent-reach install --env=auto --system # 体检：一条命令看每个渠道通不通、走哪个后端 agent-reach doctor ``` 安装完直接告诉 Agent 就行，不用记命令： - "看看这个链接" → `curl https://r.jina.ai/URL` - "这个 GitHub 仓库是干嘛的" → `gh repo view owner/repo` - "这个 YouTube 视频讲了什么" → `yt-dlp` 提取字幕 - "B站搜一下 AI 教程" → `bili search "AI 教程"` - "全网搜 LLM 框架对比" → Exa 语义搜索 - "订阅这个 RSS" → `feedparser` Agent 读取 SKILL.md 后自己知道该调什么。 --- ## 安装的系统依赖 `install --system` 会安装以下外部工具（`--safe`/默认模式只检查、不安装）： | 工具 | 用途 | |------|------| | gh CLI | GitHub 读取/搜索 | | Node.js | yt-dlp JS runtime + mcporter | | mcporter + Exa | 全网语义搜索 | | bili-cli | B站搜索/详情（可选） | --- ## 安全性 | 措施 | 说明 | |------|------| | 🔒 **无凭据** | 本版本不需要 Cookie/Token，配置仅存一个可选的网络代理 | | 🛡️ **默认安全** | `install` 默认只检查不改系统；显式 `--system` 才安装工具 | | 👀 **完全开源** | 代码透明，随时可审查 | | 🔍 **Dry Run** | `install --dry-run` 预览所有操作，不做任何改动 | | 🧩 **可插拔** | 不信任某个组件？换掉对应 channel 文件即可 | --- ## 命令参考 ```bash agent-reach install --env=auto [--system | --safe] [--dry-run] [--proxy=...] agent-reach doctor [--json] agent-reach version ``` --- ## License [MIT](LICENSE) --- ## 致谢 [yt-dlp](https://github.com/yt-dlp/yt-dlp) · [Jina Reader](https://github.com/jina-ai/reader) · [feedparser](https://github.com/kurtmckee/feedparser) · [gh CLI](https://cli.github.com) · [bili-cli](https://github.com/public-clis/bilibili-cli) · [Exa](https://exa.ai) · [mcporter](https://github.com/nicobailon/mcporter)