wigolo

本地运行，零成本，让 AI 代理自由搜索和抓取网页。

开源 🏷️完全免费 ✅ 目前可打开智能体 🍴 复刻 458 🐛 待处理 28 👀 关注 18

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 5533

维护状态活跃

是否开源开源

定价模式 🏷️完全免费本地优先的AI编码代理搜索工具，无需API密钥，无云依赖，每查询0美元，公开测试版免费使用。

项目预览

项目数据

分类智能体

开发团队KnockOutEZ

官网地址https://wigolo.app

GitHubhttps://github.com/KnockOutEZ/wigolo

定价模式🏷️完全免费

价格说明本地优先的AI编码代理搜索工具，无需API密钥，无云依赖，每查询0美元，公开测试版免费使用。

访问状态✅ 目前可打开

是否开源是

开源协议NOASSERTION

主要语言TypeScript

技术栈/模型agent,ai,ai-agent,claude,developer-tools,exa-alternative,firecrawl-alternative,local-first,mcp,mcp-server,metasearch,model-context-protocol,privacy,rag,search,search-engine,tavily-alternative,web-crawler,web-scraping,web-search

GitHub 星标★ 5533

上线时间2026-04-12 00:00:00

代码更新2026-11-08

仓库体积43.0 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

wigolo 是一个面向 AI 编程代理的本地优先搜索与检索工具，通过 MCP 协议为 Claude 等智能体提供网络搜索、网页抓取、爬虫和研究能力。它解决了 AI 代理在访问实时信息时依赖云端 API、需要 API 密钥且产生费用的问题，实现了零成本、无云依赖的本地查询。核心能力包括元搜索聚合、网页内容提取、递归爬取和结构化研究输出，所有操作均在本地执行，保护用户隐私。项目采用 TypeScript 开发，提供 CLI 和 MCP 服务器，易于集成到现有 AI 工作流中。当前处于公开测试阶段，星标增长迅速，适合开发者、研究者和自动化流程构建者使用。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5533

技术标签

agent ai ai-agent claude developer-tools

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Node.js ≥ 20
约 1.5 GB 可用磁盘空间
macOS、Linux 或 Windows 系统
Docker（仅在使用 Docker 方式时需要）

安装与启动步骤

1确认环境条件

先确认本机已安装 Node ≥ 20，并预留约 1.5 GB 磁盘空间用于下载浏览器引擎与端上模型。
2初始化本地引擎

运行 init 会下载浏览器引擎和本地模型、执行健康检查并逐项报告组件状态，默认无人值守。
```
npx wigolo init
```
3一步接入常用智能体

在初始化同时用 --agents 指定要接入的智能体，逗号分隔，wigolo 会写入对应 MCP 配置。
```
npx wigolo init --agents=claude-code,cursor
```
4检查运行健康度

随时用 doctor 查看各组件是否就绪，出现问题时按提示修复后再让智能体调用。
```
npx wigolo doctor
```
5Docker 方式运行

如在容器中使用，可通过 stdio 方式运行镜像，用数据卷 wigolo-data 持久化本地数据。
```
docker run -i --rm -v wigolo-data:/data ghcr.io/knockoutez/wigolo
```
6完全卸载清理

需要移除时执行该命令，可干净地删除已下载的引擎、模型及相关配置。
```
npx wigolo config --uninstall --yes
```

如何确认成功

执行 npx wigolo doctor，逐项检查组件报告全部就绪即表示本地引擎可用。

常见问题

Q：使用 wigolo 需要 API 密钥或付费吗？

A：不需要。搜索、抓取、爬取、提取、缓存和相似查找均无需 API 密钥，也不依赖云端服务，不产生计量费用。

Q：init 过程中会下载什么？

A：会下载浏览器引擎和端上模型，随后运行健康检查并报告每个组件；加 --no-warmup 可推迟到首次使用时再下载。

Q：如果某个组件下载失败会怎样？

A：下载失败不会导致安装整体失败，init 会报告未就绪的组件并给出具体修复方法，且仍然完成初始化。

Q：怎么接入 README 未列出名字的客户端？

A：任意 MCP 客户端、智能体框架或自托管智能体，在其自身的 MCP 配置里注册 npx -y wigolo 即可。

Q：不想交互，能放到脚本或 CI 里跑吗？

A：可以。init 默认无人值守，适合脚本和 CI；如需交互可用 --interactive（纯文本）或 --wizard（终端 TUI）。

注意事项

需要 Node ≥ 20 与约 1.5 GB 空闲磁盘空间，支持 macOS、Linux、Windows。
--agents 支持 claude-code、cursor、codex、gemini-cli、opencode、vscode、windsurf、zed、antigravity，逗号分隔。
干净安装即可开箱使用，README 提到有三项设置可提升输出质量，具体项请查阅官方配置文档。
Docker 方式请把 MCP 客户端中的命令配置为 docker，并按示例挂载数据卷。