Wigolo

社区

面向 AI 编程代理的本地优先 Web 智能。

分类: 开发工具第 158 / 438
Stars: ★ 5.5k 非常热门
传输方式: stdio（本地进程） · SSE
运行环境: Node.js 20+ · Docker
凭据: 可选 API Key
许可证: 其他 / 未声明
最近提交: 30 天前
工具数: 10

57FMRS · C

资料显示，wigolo 是由 KnockOutEZ/wigolo 维护的公开测试版、本地优先 Web 情报 MCP 服务器。它支持 stdio MCP，并可通过同一服务提供 SSE 远程 MCP；核心搜索、获取、抓取、提取、缓存和相似查找功能无需 API 密钥。README 同时说明研究和自主代理功能可选使用 LLM 综合。

最强项 · 文档质量 15/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

11/20

维护活跃度

10/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: README描述了Node≥20、MCP stdio、10个工具、doctor以及错误降级机制，但服务器清单、源码和可验证的测试/CI文件均未提供；README中的7,600项测试和CI徽章不能作为静态证据。因此只能认为正常路径可行，无法确认MCP握手、工具列表一致性、依赖失败处理或关键路径覆盖，扣分明显。
安全与权限 11/20: 证据显示默认本地运行、数据存放于~/.wigolo/、LLM和聚合后端可选、非回环HTTP绑定需要令牌，并声明遵守robots.txt和域速率限制。扣分原因是该服务主动访问公共网页，支持认证会话、页面操作、代理和远程REST/MCP；未提供清单、源码或权限模型来验证凭据隔离、危险操作确认、请求范围限制、日志脱敏和网络边界。未发现提示中的红线风险，但证据不足以支持高分。
维护活跃度 10/20: README声明项目处于public beta，提供GitHub问题入口、贡献指南、AGPL-3.0-only许可证和SECURITY.md联系渠道，说明存在维护与安全响应路径。扣分原因是没有提交历史、发布记录、依赖更新、实际问题响应或安全处理证据；输入元数据还标为NOASSERTION，与README许可证声明不一致。
文档质量 15/20: README提供了分层的快速开始、客户端列表、工具概览、配置变量、REST/SDK/Docker/框架示例、故障排查、隐私安全文档链接及公开限制说明。扣分原因是本次仅有README，未提供所引用文档、工具参数、限制实现或契约文件；部分能力、基准和兼容性声明无法独立复核，且README内部存在工具数量表述不完全一致的迹象。
安装易用性 13/20: README给出了npx初始化命令、Node≥20要求、主流客户端接入选项、跨平台说明、doctor和卸载命令，步骤总体清晰。扣分原因是安装会下载浏览器和本地模型、约需1.5GB磁盘，并可能涉及原生构建、Linux系统库和首次下载失败；没有实际配置文件、CI执行证据或成功连接日志，因此不能按静态规则给予高分。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件访问网络控制浏览器

适合谁

重视隐私和本地优先处理的开发者
需要无按查询计费 Web 工具的 AI 代理
需要搜索、抓取、缓存和研究组合能力的团队
能够提供约 1.5 GB 磁盘空间的 macOS、Linux 或 Windows 用户

不适合谁

需要云端托管服务且不希望本地下载浏览器或模型的用户
必须保证访问所有反爬或挑战保护页面的工作流
不接受公开 Web 抓取限制或可选第三方 LLM 调用的场景
需要将修改后的网络服务版本闭源的使用者

所需权限

需要访问本机文件系统以保存 ~/.wigolo/ 下的缓存、配置、嵌入和模型。
需要访问公共 Web 以执行搜索、页面获取和抓取。
浏览器模式可能需要启动本地浏览器引擎；Linux 上可能需要安装操作系统库。
研究、代理和 answer 格式搜索可选使用 Gemini、Anthropic、OpenAI、Groq 或其他兼容服务；使用这些服务时需配置相应密钥或地址。
访问需要认证的页面或执行页面操作时，可能需要提供相应会话信息。

风险与副作用

公共搜索引擎或目标网站可能失败、过时、限流或阻止请求；wigolo 会在结果中报告部分降级和挑战失败。
自托管数据中心 IP 的声誉可能导致挑战保护网站无法访问。
启用第三方 LLM 综合会将相关请求发送到所选服务；完全本地运行可使用 Ollama 或兼容地址。
本地浏览器和模型下载约需 1.5 GB 磁盘空间。
项目采用 AGPL-3.0-only；修改后作为网络服务运行时需要发布修改后的源代码。

安装接入

准备工作

运行环境：Node.js 20+ · Docker

GEMINI_API_KEY 可选密钥在 aistudio.google.com/apikey 免费获取的 Gemini 密钥，可将 research/agent/search format=answer 升级为完整带引用的答案。

WIGOLO_GITHUB_TOKEN 可选密钥可选 GitHub 令牌，将 GitHub 代码搜索限流从 10 提升到 30 次/分钟。

WIGOLO_API_TOKEN 可选密钥 HTTP 服务器从非本机回环访问时必需的 Bearer 令牌（docker serve）。

其他可选配置项（6 个）

WIGOLO_LLM_PROVIDER 可选可选的合成用 LLM 提供商（gemini/anthropic/openai/groq/ollama）；设为 ollama 可完全本地无 key。

WIGOLO_SEARCH 可选设为 hybrid 以启用聚合器回退，扩大检索漏斗。

WIGOLO_TLS_TIER 可选设为 auto 启用按域名学习的抓取加固。

WIGOLO_EAGER_WARMUP 可选设为 1 可提前付出约 1 秒的模型加载，而非首次使用时懒加载。

USE_PROXY 可选设为 true 走代理；配合 PROXY_URL 使用。

PROXY_URL 可选 USE_PROXY=true 时使用的代理端点地址；TLS 检查型代理还需 NODE_EXTRA_CA_CERTS。

安装 Node.js 20 或更高版本后运行 npx wigolo init。该命令设置本地引擎、下载浏览器引擎和设备端模型并执行健康检查；可使用 --agents=claude-code,cursor 等参数同时写入对应代理配置。其他 MCP 客户端可将 npx -y wigolo 注册到自身 MCP 配置中。使用 npx wigolo doctor 检查状态。

验证是否装好

运行 `npx wigolo init`（可用 --agents=claude-code,cursor 一并接入客户端），再运行 `npx wigolo doctor` 确认各组件健康；重启客户端后，工具列表应出现 wigolo 的十个工具（search、fetch、crawl、extract、cache、find_similar、research、agent、diff、watch），无需 API key 即可通过网页搜索提问验证连接。

常见排障

运行 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 助手这样说：

搜索网络，找到最新的 PostgreSQL 逻辑复制文档，并给出带引用的原文摘录
抓取 https://example.com 并转换为干净的 markdown
按 sitemap 爬取整个文档站并提取 Article 结构化元数据
显示这个页面自上次访问以来具体改了什么

工具能力 10

search 只读

通过多个搜索引擎进行并行搜索、排序融合和结果重排，并返回可解释评分。

fetch 只读

获取单个 URL，必要时升级到无头浏览器，并返回清理后的 Markdown、元数据和链接。

crawl 只读

按 BFS、DFS、站点地图或仅映射模式进行多页面抓取，并遵守 robots.txt 和域名速率限制。

extract 只读

从页面提取表格、元数据、JSON-LD、品牌信息、命名模式或自定义 JSON Schema 数据。

cache 只读

查询已访问内容，支持关键词或混合语义搜索、统计、清理和变更检测。

find_similar 只读

基于 URL 或概念查找相似页面，融合关键词、语义和实时 Web 结果。

research 只读

拆解问题、扩展子查询、获取来源并生成带引用的报告或结构化简报。

agent 只读

执行自主的信息收集循环，包括规划、搜索、获取、提取和综合，并提供步骤日志和时间预算。

展开其余 2 个工具

diff 只读

比较页面自上次访问以来的变化。

watch 只读

按需重新检查页面，并可通过 Webhook 推送变化。

使用场景

为 AI 编程代理提供本地 Web 搜索和资料获取

对网页进行抓取、结构化提取和变更检测

构建本地 RAG、研究流程或自主信息收集代理

通过 REST、SDK 或 MCP 集成自托管代理

支持客户端

Claude Code

Cursor

Codex

Gemini CLI

VS Code

Windsurf

Zed

Antigravity

依据项目文档列出，未经本站实测。

详细介绍

wigolo 是一个运行在本地的 MCP 与 REST Web 情报服务器，为 AI 代理提供搜索、抓取、页面获取、结构化提取、缓存、相似页面查找、研究和自主信息收集能力。核心工具无需 API 密钥，数据、缓存、嵌入和模型默认保存在 ~/.wigolo/。项目处于公开测试阶段，要求 Node.js 20 或更高版本，并需要约 1.5 GB 可用磁盘空间。