wigolo
AI Agent 的本地优先网络层 — 零 API Key，零成本查询
🔍 18 引擎搜索
🌐 本地优先
⭐ 4.4K Stars
💡 一句话概括：wigolo 是 AI Agent 的本地优先网络工具层，提供搜索、抓取、爬取、提取等 10 个工具，零 API Key，零成本，数据完全本地存储。
🌟 项目背景
当前的 AI Agent 生态中，网络访问工具大多依赖付费 API — Tavily、Exa、Firecrawl 等都有按查询计费的模式。随着 Agent 使用量增加，成本会线性增长。
wigolo 提供了一个不同的思路：
✅ 核心理念：将昂贵的网络工具本地化，使用你的硬件代替付费服务，实现真正的 $0/查询。
🛠️ 十大核心工具
search
18 个搜索引擎适配器，rank fusion + ML reranking
fetch
智能路由，自动降级到无头浏览器处理反爬
crawl
多页面爬取，BFS/DFS/sitemap 模式
extract
结构化数据提取，支持 JSON Schema
cache
本地缓存，关键词+向量索引
find_similar
相似页面发现，三路融合
research
自动研究，生成引用报告
agent
自主收集循环，带时间预算
diff
页面变化检测
watch
定时监控，webhook 通知
📊 项目数据
| 指标 | 数值 |
|---|---|
| ⭐ GitHub Stars | 4,452 |
| 🍴 Forks | 318 |
| 🐛 Open Issues | 50 |
| 📜 语言 | TypeScript |
| 📜 许可证 | AGPL-3.0 |
| 📦 最新版本 | v0.2.1 |
🎯 核心优势：10 个工具零 API Key，所有数据存储在本地 ~/.wigolo/，$0/查询。
✨ 为什么与众不同
1️⃣ 为 Agent 设计
一次 MCP 调用即可并行扇出多个引擎的查询，这是串行工具循环无法复制的。每个结果都带有透明的评分分解。
2️⃣ 诚实的输出
过期缓存、失败的抓取、退化的后端都会被明确标记。当遇到反爬挑战时，你会得到 blocked_by_challenge 标签，而不是把挑战页面当作内容返回。
3️⃣ $0/查询，免费重复查询
$0
按量计费
4️⃣ 默认隐私
缓存、嵌入、模型和配置都生活在 ~/.wigolo/ 下。除非你明确选择加入 LLM 进行合成，否则没有任何数据到达第三方。
🚀 快速开始
安装
# 基本安装 npx wigolo init # 一键安装并配置 Agent npx wigolo init --agents=claude-code,cursor
支持的工具
| Agent | 状态 |
|---|---|
| Claude Code | ✅ 原生支持 |
| Cursor | ✅ 原生支持 |
| Codex | ✅ 原生支持 |
| Gemini CLI | ✅ 原生支持 |
| VS Code / Windsurf / Zed | ✅ 原生支持 |
| 任何 MCP 客户端 | ✅ 通用支持 |
可选：免费 LLM Key（用于研究合成）
# 搜索、抓取、爬取、提取、缓存、找相似 — 完全免费，无需 Key # research / agent / search format=answer — 需要 LLM 合成 export WIGOLO_LLM_PROVIDER=gemini export GEMINI_API_KEY=<你的免费Key> # aistudio.google.com/apikey
🏗️ 架构设计
wigolo 的架构非常清晰：
📚 与其他工具对比
| 特性 | wigolo | Firecrawl | Exa | Tavily |
|---|---|---|---|---|
| 多引擎搜索 | ✅ | ✅ | ✅ | ✅ |
| 字节级引用 | ✅ | ❌ | ❌ | ❌ |
| 可解释评分 | ✅ | ❌ | ❌ | ❌ |
| 本地缓存 | ✅ | ❌ | ❌ | ❌ |
| 数据本地存储 | ✅ | ❌ | ❌ | ❌ |
| API Key | none | required | required | required |
| 每查询成本 | $0 | metered | metered | metered |
🐳 Docker 部署
# stdio MCP — 连接到任何 MCP 客户端 docker run -i --rm -v wigolo-data:/data ghcr.io/knockoutez/wigolo # HTTP 服务器 — 远程/多客户端使用 docker run -p 3333:3333 -v wigolo-data:/data \ -e WIGOLO_API_TOKEN=a-long-random-secret \ ghcr.io/knockoutez/wigolo serve --host 0.0.0.0
📚 框架集成
wigolo-langchain
wigolo-crewai
wigolo-llamaindex
wigolo-vercel-ai-sdk
💭 个人思考
wigolo 代表了一个重要的趋势——AI Agent 的工具链本地化。当所有 AI 公司的云服务都在追逐 API 调用量时，wigolo 提供了一个完全不同的选择：
隐私优先
所有数据留在本地
零成本
$0/查询，无隐藏费用
快速响应
本地缓存，重复查询即时
高度可定制
插件系统，可扩展
📚 相关链接
wigolo 代表了一个方向——将 AI Agent 的网络能力本地化，打破付费 API 的垄断，让每个开发者都能拥有强大的网络工具链。
🕷️
The go-to web for your AI coding agent.
无 API Key，无云服务，零成本。