wigolo 是什么？
如果你正在用 Claude Code、Cursor、Codex 等 AI 编程 Agent 写代码，你会发现一个致命缺陷：它们默认不能上网。当你的 Agent 需要查找最新文档、搜索某个 API 用法、或者阅读一篇技术博客时，它只能依靠训练数据中的旧知识 —— 这对于快速迭代的技术生态来说远远不够。
wigolo 就是为了解决这个问题而生的开源工具。它是一个 本地优先（local-first）的网络智能 MCP 服务器，可以让任何 AI Agent 拥有搜索、抓取、爬取、提取和研究互联网的能力，而且 不需要 API Key，完全免费。
| 项目 | 信息 |
|---|---|
| GitHub | KnockOutEZ/wigolo |
| Stars | 1,750+（GitHub Trending 上榜） |
| 语言 | TypeScript (Node.js ≥ 20) |
| 协议 | MIT 开源 |
| 支持平台 | macOS / Linux / Windows |
wigolo 能做什么？
wigolo 提供了 10 个核心 MCP 工具函数，覆盖了 AI Agent 所需的全部网络能力：
- search — 搜索引擎查询（无需 API Key，本地执行）
- fetch — 获取网页内容并提取正文
- crawl — 整站爬取，遍历多个页面
- extract — 从网页中结构化提取数据
- cache — 本地持久缓存，避免重复请求
- find-similar — 找到与给定内容相似的页面
- research — 自主研究循环，汇总多来源信息（需要 LLM）
- gather — 自动收集循环，按主题搜集资料
- doctor — 健康检查，诊断配置问题
- status — 查看运行状态和统计
所有核心功能完全离线运行在 ~/.wigolo/ 目录下，数据不会离开你的电脑。
安装与快速上手
环境要求
- Node.js ≥ 20
- 约 1.5 GB 磁盘空间
一键安装
wigolo 的安装极其简单，只需一条命令：
npx wigolo init --agents=claude-code
这条命令会自动完成： 1. 下载浏览器引擎和本地模型 2. 运行健康检查 3. 为你写入 MCP 配置文件
--agents 参数支持自动配置以下 Agent：
- claude-code — Claude Code
- cursor — Cursor IDE
- codex — ChatGPT Codex
- gemini-cli — Gemini CLI
- vscode — VS Code
- windsurf — Windsurf IDE
- zed — Zed IDE
- antigravity — Antigravity
安装完成后，可以用以下命令随时检查状态：
npx wigolo doctor
如果一切正常，你会看到所有组件的绿色状态报告。
与其他 Agent 集成
如果你用的是不在自动配置列表中的 MCP 客户端（比如 LangChain、CrewAI、n8n），可以手动注册：
# 不指定 --agents，手动配置
npx wigolo init
然后在你的 MCP 配置文件中加入：
{
"mcpServers": {
"wigolo": {
"command": "npx",
"args": ["-y", "wigolo", "stdio"]
}
}
}
完全卸载
如果不需要了，一键清理干净：
npx wigolo config --uninstall --yes
进阶用法
启用 LLM 驱动的研究功能
wigolo 的搜索、抓取等核心功能完全不需要 API Key。但如果你想启用更强大的 research 和 gather 功能（这些功能需要 LLM 来综合多个信息源），只需要一个免费的 Gemini API Key：
export WIGOLO_LLM_PROVIDER=gemini
export GEMINI_API_KEY="your-free-key"
在 Google AI Studio 免费申请 Key 即可。免费额度完全够用。
也支持其他 LLM 提供商：
- anthropic — Claude API
- openai — OpenAI API
- groq — Groq API
- ollama — 本地 Ollama（完全离线）
作为 REST API 服务运行
如果你想让远程 Agent（比如部署在 VPS 上的 n8n 自动化）也能使用 wigolo，可以启动 serve 模式：
npx wigolo serve --port 3000
然后用 curl 调用：
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"latest Rust async best practices"}}}'
结合 Claude Code 实战
wigolo 与 Claude Code 配合使用时效果最好。以下是一个真实工作流：
场景：查找某个新库的最新用法
你告诉 Claude Code：
用 wigolo 搜索 "Rust tokio 2026 best practices"，帮我总结最新写法
Claude Code 会自动调用 wigolo 的 search 工具获取搜索结果，然后综合多个页面的信息给你一份准确、最新的总结。
与同类工具对比
| 功能 | wigolo | 浏览器搜索插件 | 传统 MCP 搜索工具 |
|---|---|---|---|
| 是否需要 API Key | ❌ 不需要 | ❌ 不需要 | ✅ 通常需要 |
| 是否收费 | ✅ 免费 | 可能收费 | 按调用收费 |
| 数据隐私 | ✅ 全部本地存储 | 数据传到第三方 | 数据传到第三方 |
| 是否支持 Agent | ✅ 原生 MCP 支持 | 仅浏览器插件 | 部分支持 |
| 本地缓存 | ✅ 内置 | ❌ 无 | 通常无 |
| 自主研究循环 | ✅ research 工具 | ❌ 无 | ❌ 无 |
wigolo 最大的优势是 本地优先 — 你的所有搜索历史、缓存数据、研究结果都存储在 ~/.wigolo/ 目录下，不会上传到任何云端服务。
自部署方案
对于团队使用场景，你可以将 wigolo 部署在 VPS 上，让多个开发者的 Agent 共享同一个搜索实例。
Docker 部署
FROM node:20-slim
RUN npm install -g wigolo
EXPOSE 3000
CMD ["npx", "wigolo", "serve", "--port", "3000"]
Nginx 反向代理
server {
listen 443 ssl;
server_name wigolo.yourdomain.com;
location /mcp {
proxy_pass http://localhost:3000;
proxy_set_header Host $host;
}
}
常见问题
wigolo 安全吗？会泄露我的数据吗？
不会。wigolo 是本地优先的工具，所有数据存储在 ~/.wigolo/ 目录。它不会将你的搜索历史或缓存数据发送到任何外部服务器。详细隐私说明见 privacy & security 文档。
我的 Agent 调用 wigolo 太慢怎么办？
可以用 npx wigolo doctor 诊断。如果本地模型下载未完成，首次搜索会比较慢。完成一次搜索后结果会缓存，后续查询会显著加速。
wigolo 支持哪些搜索引擎？
wigolo 内置了多种搜索引擎和抓取能力，无需外部 API。你也可以通过 插件系统 添加自定义搜索引擎和内容提取器。
总结
wigolo 是目前最成熟的开源本地网络智能 MCP 服务器，填补了 AI 编程 Agent「不能上网」的关键空白。它的核心价值在于：
- 零成本 — 核心功能完全免费，无需 API Key
- 隐私优先 — 所有数据本地存储
- 开箱即用 — 一行命令完成安装和 Agent 集成
- 功能全面 — 搜索、抓取、爬取、研究、缓存全覆盖
- 高度扩展 — 支持插件、SDK、REST API、Docker 部署
如果你的 AI 编程工作流还缺少「上网搜索」这一环，wigolo 是目前最佳的选择。
📌 相关链接 - wigolo GitHub - wigolo 文档 - wigolo MCP 市场页