📌 项目地址：KnockOutEZ/wigolo | ⭐ 1,109 颗星 | 🔧 TypeScript | 📜 未标注
为什么你需要一个本地化的网页信息工具
当前AI编码代理（如Claude Code、Cursor、Codex等）常需要访问网页——搜索最新文档、抓取API参考、爬取完整站点等。但现有方案要么依赖第三方API（SerpAPI、Tavily等）产生按查询计费的账单，要么需要自己搭建云服务并管理密钥。wigolo解决的是这个矛盾：它把所有网页功能（搜索、抓取、爬取、提取、缓存、找相似、自主研究）打包成一个MCP服务器，在你的机器上本地运行，不向任何外部服务发送请求（除了搜索引擎本身的可选增强），且不产生任何按量账单。
项目定位是“AI agent的本地优先web intelligence”。对于在无网络、内网或隐私敏感环境中使用AI代理的开发者，它提供了一个零依赖外部服务的方案。
快速上手：一行命令接入AI编码代理
前提条件：Node.js ≥ 20，约1.5GB空闲磁盘。支持macOS、Linux、Windows。
执行以下命令即可完成完整初始化（无人值守，适用于脚本和CI）：
npx wigolo init --agents=claude-code,cursor
--agents后面可以填写一个或多个客户端，用逗号分隔：claude-code、cursor、codex、gemini-cli、vscode、windsurf、zed、antigravity。wigolo会自动为这些工具写入MCP配置和指令文件。- 如果想使用提示向导模式，添加
--interactive（纯文本交互）或--wizard（全终端TUI）。 - 如果不想立即下载浏览器引擎和模型，添加
--no-warmup，首次调用时才会下载。 - 对于其他MCP客户端，省略
--agents，然后手动在客户端中注册npx -y wigolo作为MCP服务器即可。
初始化完成后，可以验证一切是否健康：
npx wigolo doctor
卸载同样方便：
npx wigolo config --uninstall --yes
核心工具一览：搜索、抓取、爬取、缓存、研究
wigolo提供了一系列MCP工具，其中最基础的部分（搜索、抓取、爬取、提取、缓存、找相似）不需要任何API密钥。以下是根据README列出的主要工具（具体调用语法参考官方文档 docs/README.md）：
- 搜索 – 通过本地搜索引擎索引结果，无需SerpAPI等付费服务。
- 抓取（Fetch） – 获取单个网页的纯文本或结构化内容。
- 爬取（Crawl） – 递归爬取站点，提取链接和内容。
- 提取（Extract） – 从页面中抽取特定信息，如标题、正文、关键字段。
- 缓存（Cache） – 本地持久化已获取的内容，避免重复请求。
- 找相似（Find Similar） – 基于已缓存或已获取的内容查找语义相似的页面。
- 研究（Research） – 对给定主题进行多步自动调研，整合多个来源。此功能建议使用免费密钥来启用增强模式，但基础版仍可使用。
- 代理（Agent） – 自主循环工具，可让agent自行决定搜索、抓取、爬取等操作组合。
与其他方案的区别：零账单、全本地、无密钥
大多数现有的AI代理网页工具要么是付费API（比如Tavily按查询计费，一个查询几美分），要么需要你自建索引服务（如searxng等）。wigolo将浏览器引擎（Playwright）和轻量级模型捆绑在本地，所有数据存储在 ~/.wigolo/ 目录下，不向云端发送任何内容。初始下载约1.5GB，之后完全离线运行。这意味着：
- 隐私：代理的网页访问记录不会离开你的机器。
- 成本：除了初次下载的带宽和磁盘，后续使用零成本。
- 可用性：即使在无网络环境（内网开发、离线工作站）也能工作。
- 集成：作为MCP服务器可被所有主流AI代理客户端原生支持，无需改造。
需要注意的边界和限制
- 资源需求：需要Node 20+和~1.5GB磁盘空间用于存储浏览器引擎和模型。初次初始化会下载这些组件，可能需要几分钟时间（取决于网络）。如果磁盘空间不足或网络受限，建议使用
--no-warmup推迟下载。 - 搜索引擎依赖：搜索功能默认使用本地索引，但README中提到“research”和“agent”工具建议使用免费密钥以增强效果（可能是接入Bing或其他公共搜索API的增强）。基础搜索、抓取等依然完全离线无密钥。
- 仍属于公开测试版：项目标明“Public beta”，可能存在不稳定或功能变更。GitHub上star数1109，社区较小但更新活跃。
- 不支持所有代理客户端：虽然支持列表里有“Antigravity”等，但实际常用的是Claude Code、Cursor、Codex等。如果使用其他客户端，需要手动配置MCP端点。
适合谁，不适合谁
如果你是以下类型的开发者，wigolo很值得尝试：
– 深度使用Claude Code、Cursor等AI编码代理，需要频繁检索网页文档但不想支付API费用。
– 在隐私敏感或内网环境下使用AI代理，必须避免数据外传。
– 希望为自部署的AI代理（如LangChain、CrewAI、n8n）提供一个本地的网页情报层。
如果你需要大规模的网页搜索（如每天数千次查询）或依赖特定搜索引擎的高级过滤，可能需要同时启用免费密钥或考虑混合方案。另外，如果你的机器磁盘空间严重不足（<2GB），首次初始化可能会失败。
总的来说，wigolo以极低的门槛为AI代理提供了可靠、免费的网页能力，对于追求效率与隐私的开发者来说是一个很有吸引力的选择。