wigolo 是一个专为 AI 编程代理（AI coding agent）打造的本地优先（local-first）网页智能引擎。它不是传统浏览器，也不是云端搜索 API——而是一个可一键启动、完全离线运行的轻量级服务，让 Claude Code、Cursor、VS Code、Zed 等支持 MCP（Model Context Protocol）协议的 AI 工具，能像调用本地函数一样安全、免费、高速地完成网页搜索、内容抓取、深度爬取、语义去重和自主研究任务。彻底告别 API 配额限制、按次计费、隐私泄露和网络依赖。
核心功能
- 本地化全栈网页搜索：内置高性能元搜索引擎（metasearch），无需连接 Google/Bing，直接在本地索引中完成关键词检索与结果聚合
- 一键式网页获取与结构化提取：支持自动识别正文、代码块、表格、引用链接，并输出 clean JSON，适配 RAG 场景
- 增量式智能爬虫：可配置深度与范围，自动发现相关页面、去重、缓存并建立本地知识图谱，支持“研究循环”（research loop）自动化
- 语义相似性查找：基于嵌入模型（Embedding）实现文档级相似度比对，帮你快速定位同类技术方案或替代实现
- 零配置 MCP Server 支持：开箱即用兼容 Model Context Protocol，无缝对接 LangChain、CrewAI、LlamaIndex、Vercel AI SDK 等主流 AI 框架
- 完全离线 & 隐私优先：所有数据处理均在本地完成，不上传任何内容，不依赖外部云服务，连网络断开也能继续工作
适合哪些人用
如果你是以下角色之一，wigolo 正是你缺失的关键拼图：
• AI 原生开发者：正在用 Cursor、Windsurf 或自研 Agent 构建编程助手，却苦于无法稳定获取最新文档/Stack Overflow/开源项目页；
• 本地大模型实践者：已部署 Ollama/LMStudio，但缺少可靠的网页数据接入层来增强上下文；
• 隐私敏感型工程师：拒绝将代码片段、内部 API 文档、客户需求描述发往第三方云服务；
• 自动化研究员：需要让 AI 自主完成“查资料→读文档→对比方案→生成建议”的闭环，而非手动复制粘贴。
快速上手
只需两步即可启用：
1. 全局安装（需 Node.js ≥ 20）：npm install -g wigolo
2. 启动服务：wigolo serve（默认监听 http://localhost:3000）
然后在你的 AI 工具设置中将 MCP Server 地址指向该地址即可。支持 CLI 直接调用（wigolo search "React Server Components"）、REST API 调用，也提供 VS Code 插件预览版。详细示例见官方 Examples 目录。
项目信息
The go-to web for your AI coding agent — local-first search, fetch, crawl & research over MCP. No API keys, no cloud, $0/query. Public beta.
编程语言：TypeScript｜GitHub Star 数：1210｜开源协议：AGPL-3.0｜GitHub 项目地址
对于追求可控性、隐私性与工程效率的 AI 编程工作流来说，wigolo 不是又一个玩具工具，而是真正把“AI 懂网页”这件事，拉回开发者桌面的第一款成熟本地基础设施。
