wigolo

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

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

开源 free 智能体
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 5387
维护状态 活跃
是否开源 是
定价模式 free

项目数据

分类智能体
开发团队KnockOutEZ
所属国家
定价模式free
价格说明本地优先的AI编码代理搜索工具,无需API密钥,无云依赖,每查询0美元,公开测试版免费使用。
访问状态
是否开源是
开源协议NOASSERTION
主要语言TypeScript
技术栈/模型agent,ai,ai-agent,claude,cli,developer-tools,local-first,mcp,mcp-server,metasearch,model-context-protocol,nodejs,privacy,rag,search,search-engine,typescript,web-crawler,web-scraping,web-search
GitHub 星标★ 5387
30天Star增速
HF 下载量
上线时间2026-04-12 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数5

使用教程

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

环境要求

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

安装与启动步骤

  1. 1确认环境条件

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

  2. 2初始化本地引擎

    运行 init 会下载浏览器引擎和本地模型、执行健康检查并逐项报告组件状态,默认无人值守。

    npx wigolo init
  3. 3一步接入常用智能体

    在初始化同时用 --agents 指定要接入的智能体,逗号分隔,wigolo 会写入对应 MCP 配置。

    npx wigolo init --agents=claude-code,cursor
  4. 4检查运行健康度

    随时用 doctor 查看各组件是否就绪,出现问题时按提示修复后再让智能体调用。

    npx wigolo doctor
  5. 5Docker 方式运行

    如在容器中使用,可通过 stdio 方式运行镜像,用数据卷 wigolo-data 持久化本地数据。

    docker run -i --rm -v wigolo-data:/data ghcr.io/knockoutez/wigolo
  6. 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,并按示例挂载数据卷。

核心亮点

  • 无需 API 密钥和云服务,彻底消除每查询成本,隐私性更强
  • 通过 MCP 协议无缝集成 Claude 等主流 AI 代理,即插即用
  • 支持元搜索、抓取、爬虫和研究多种模式,覆盖信息获取全流程

不足之处

  • 本地运行依赖用户设备性能,大规模爬取可能受限于网络和硬件
  • 文档/社区待观察

适用场景

  • AI 编程代理需要实时查阅文档或 Stack Overflow 时
  • 隐私敏感场景下,希望避免数据经过第三方云服务
  • 自动化研究任务,如批量收集网页信息并生成摘要

替代项目

Firecrawl、Tavily、Exa

项目介绍

wigolo 是智能体领域的开源项目,由 KnockOutEZ 开发,是 2026 年新上线的项目。

在全站 13,014 个收录项目中,它的 GitHub 星标数(5,387)位列前 9%,在智能体分类的 2,499 个项目里位列前 9%。

近 44 天,它的 GitHub 星标从 4,442 增加到 5,387,净增 945。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。本地优先的AI编码代理搜索工具,无需API密钥,无云依赖,每查询0美元,公开测试版免费使用。从国内网络环境看,可直接访问。

它主要面向的使用场景是:AI编程代理需要实时查阅文档或StackOverflow时。同类可对比的替代方案包括 Firecrawl、Tavily、Exa。

上一篇:agenta

下一篇:awesome-openclaw-usecases-zh

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 195 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 233327 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187492 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3351 2026-09-12