# wigolo — 本地优先的AI代理搜索抓取研究工具，免API Key

> 给AI编码代理（Claude Code/Cursor/Codex等）用的本地搜索+抓取+研究工具，不需要API Key不花钱，搜索结果可解释评分，数据不出本机

## wigolo — 本地优先的AI编码代理搜索/抓取/研究工具

**一句话总结：** 跑在你自己电脑上的网页搜索+抓取+研究工具，给AI编码代理（Claude Code、Cursor、Codex等）提供网页能力，不需要API Key，不花钱，数据不出本机。

### 它能做什么

| 工具 | 功能 |
|------|------|
| 🔎 `search` | 多引擎网页搜索（18个直接适配器），ML交叉编码器重排序，可解释的逐结果评分 |
| 📄 `fetch` | 加载URL：HTTP → TLS伪装 → 无头浏览器，自动升级对抗反爬。输出干净Markdown |
| 🕸️ `crawl` | 多页面爬取：BFS/DFS/sitemap，限速，robots.txt |
| 🧩 `extract` | 结构化数据提取：表格、元数据、JSON-LD、Article/Recipe/Product等 |
| 💾 `cache` | 本地缓存查询（BM25关键词 + 向量），重查询即时返回 |
| 🧲 `find_similar` | 找相似页面：关键词+语义+实时网页三路融合 |
| 🧠 `research` | 分解问题 → 多路搜索 → 综合带引用的报告 |
| 🤖 `agent` | 自主收集循环：规划→搜索→抓取→提取→综合 |

### 核心卖点

- **给AI代理用的，不是给人用的** — 一次MCP调用并行搜索多个引擎，代理的工具循环做不到
- **$0/次查询，免费重复查询** — 搜索走公开引擎直连适配器，重排序和嵌入在本地跑
- **数据不出本机** — 缓存、嵌入、模型、配置全在 `~/.wigolo/`，除非你主动配置LLM
- **诚实输出** — 过期缓存、失败抓取、降级引擎、截断都会在结果中标注，不会伪装成成功数据
- **解释性评分** — 每个结果附带交叉编码器/词汇/引擎共识的评分分解

### 安装（一行命令）

```bash
npx wigolo init --non-interactive --agents=claude-code
```

支持的代理：Claude Code · Cursor · Codex · Gemini CLI · VS Code · Windsurf · Zed · Antigravity

### 对比付费服务

|  | wigolo | Firecrawl | Exa | Tavily |
|--|:------:|:---------:|:---:|:------:|
| 多引擎搜索 | ✅ | ✅ | ✅ | ✅ |
| 抓取+结构化提取 | ✅ | ✅ | ✅ | ✅ |
| 全站爬取 | ✅ | ✅ | — | ✅ |
| 逐字节引用原文 | ✅ | — | — | — |
| 可解释评分分解 | ✅ | — | — | — |
| 本地持久缓存 | ✅ | — | — | — |
| 数据留在本机 | ✅ | — | — | — |
| 需要API Key | ❌ | 需要 | 需要 | 需要 |
| 每次查询费用 | $0 | 计费 | 计费 | 计费 |

### 技术栈

- 单Node进程，MCP协议（JSON-RPC over stdio）
- SQLite + FTS5 + sqlite-vec（本地存储+向量）
- BGE-small 384维嵌入 + MiniLM交叉编码器重排序
- Playwright多浏览器池（Chromium/Firefox/WebKit）
- TLS指纹伪装 + 域名级自适应路由

**⭐ 718 Stars · TypeScript · AGPL-3.0 · 公开测试中**

---

**分类**：其它
**标签**：搜索 · 代理 · 本地
**作者**：Xiao.Xi
**链接**：https://octohz.com/p/1928