wigolo — 本地优先的AI代理搜索抓取研究工具，免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
• 诚实输出 — 过期缓存、失败抓取、降级引擎、截断都会在结果中标注，不会伪装成成功数据
• 解释性评分 — 每个结果附带交叉编码器/词汇/引擎共识的评分分解

安装（一行命令）

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 · 公开测试中