适合谁
- 重视隐私和本地优先处理的开发者
- 需要无按查询计费 Web 工具的 AI 代理
- 需要搜索、抓取、缓存和研究组合能力的团队
- 能够提供约 1.5 GB 磁盘空间的 macOS、Linux 或 Windows 用户
W
57FMRS · C
资料显示，wigolo 是由 KnockOutEZ/wigolo 维护的公开测试版、本地优先 Web 情报 MCP 服务器。它支持 stdio MCP，并可通过同一服务提供 SSE 远程 MCP；核心搜索、获取、抓取、提取、缓存和相似查找功能无需 API 密钥。README 同时说明研究和自主代理功能可选使用 LLM 综合。
wigolo 是一个运行在本地的 MCP 与 REST Web 情报服务器，为 AI 代理提供搜索、抓取、页面获取、结构化提取、缓存、相似页面查找、研究和自主信息收集能力。核心工具无需 API 密钥，数据、缓存、嵌入和模型默认保存在 ~/.wigolo/。项目处于公开测试阶段，要求 Node.js 20 或更高版本，并需要约 1.5 GB 可用磁盘空间。
工具能力
search
通过多个搜索引擎进行并行搜索、排序融合和结果重排，并返回可解释评分。
fetch
获取单个 URL，必要时升级到无头浏览器，并返回清理后的 Markdown、元数据和链接。
crawl
按 BFS、DFS、站点地图或仅映射模式进行多页面抓取，并遵守 robots.txt 和域名速率限制。
extract
从页面提取表格、元数据、JSON-LD、品牌信息、命名模式或自定义 JSON Schema 数据。
cache
查询已访问内容，支持关键词或混合语义搜索、统计、清理和变更检测。
find_similar
基于 URL 或概念查找相似页面，融合关键词、语义和实时 Web 结果。
research
拆解问题、扩展子查询、获取来源并生成带引用的报告或结构化简报。
agent
执行自主的信息收集循环，包括规划、搜索、获取、提取和综合，并提供步骤日志和时间预算。
diff
比较页面自上次访问以来的变化。
watch
按需重新检查页面，并可通过 Webhook 推送变化。
安装接入
安装 Node.js 20 或更高版本后运行 npx wigolo init。该命令设置本地引擎、下载浏览器引擎和设备端模型并执行健康检查；可使用 --agents=claude-code,cursor 等参数同时写入对应代理配置。其他 MCP 客户端可将 npx -y wigolo 注册到自身 MCP 配置中。使用 npx wigolo doctor 检查状态。
选型与风险
不适合谁
- 需要云端托管服务且不希望本地下载浏览器或模型的用户
- 必须保证访问所有反爬或挑战保护页面的工作流
- 不接受公开 Web 抓取限制或可选第三方 LLM 调用的场景
- 需要将修改后的网络服务版本闭源的使用者
所需权限
- 需要访问本机文件系统以保存 ~/.wigolo/ 下的缓存、配置、嵌入和模型。
- 需要访问公共 Web 以执行搜索、页面获取和抓取。
- 浏览器模式可能需要启动本地浏览器引擎；Linux 上可能需要安装操作系统库。
- 研究、代理和 answer 格式搜索可选使用 Gemini、Anthropic、OpenAI、Groq 或其他兼容服务；使用这些服务时需配置相应密钥或地址。
- 访问需要认证的页面或执行页面操作时，可能需要提供相应会话信息。
风险与副作用
- 公共搜索引擎或目标网站可能失败、过时、限流或阻止请求；wigolo 会在结果中报告部分降级和挑战失败。
- 自托管数据中心 IP 的声誉可能导致挑战保护网站无法访问。
- 启用第三方 LLM 综合会将相关请求发送到所选服务；完全本地运行可使用 Ollama 或兼容地址。
- 本地浏览器和模型下载约需 1.5 GB 磁盘空间。
- 项目采用 AGPL-3.0-only；修改后作为网络服务运行时需要发布修改后的源代码。
常见排障
- 运行 npx wigolo doctor 检查组件状态。
- 下载失败时运行 wigolo warmup --all，或使用 --browser、--embeddings、--reranker。
- Linux 浏览器无法启动时运行 wigolo warmup --browser 并安装提示的系统库。
- 原生构建错误或 Node.js 版本异常时使用 Node 20、22 或 24 LTS。
- 代理环境设置 USE_PROXY=true 和 PROXY_URL；TLS 检查代理可能还需要 NODE_EXTRA_CA_CERTS。
- 使用 --no-warmup 可将下载延后到首次使用。
使用场景
为 AI 编程代理提供本地 Web 搜索和资料获取
对网页进行抓取、结构化提取和变更检测
构建本地 RAG、研究流程或自主信息收集代理
通过 REST、SDK 或 MCP 集成自托管代理
支持客户端
Claude Code完整支持
Cursor完整支持
Codex完整支持
Gemini CLI完整支持
VS Code完整支持
Windsurf完整支持
Zed完整支持
Antigravity完整支持
Any MCP client完整支持