在 Claude Code、Cursor、Codex 这类编码智能体大行其道的今天，一个尴尬的现实是：它们很会写代码，却「看不见」互联网。想查一份报错、一份 API 文档、一个竞品定价，往往得开发者自己复制粘贴喂给模型。Wigolo 要做的，就是给 AI 智能体装上一双「眼睛和手」——一个本地优先、无需 API Key、按查询 0 计费的统一「上网」引擎。
🦉 项目简介
Wigolo 是 KnockOutEZ 开源的 AI 编程智能体本地优先「上网」引擎：以 MCP 服务器（或 REST / SDK）的形式运行在智能体身边，统一提供 搜索、抓取、爬取、提取、缓存、相似发现、研究、自主收集 等全套 Web 能力。核心理念是 no keys, no cloud, no metered bill——核心工具无需任何 API Key，所有数据留在本地 ~/.wigolo/，用得越多账单也不会涨。
💻 安装要求与过程
环境要求：Node.js ≥ 20，约 1.5 GB 空闲磁盘（首次运行会下载浏览器引擎等本地组件）。核心搜索 / 抓取 / 爬取无需任何外部 Key 即可使用；如需 research、agent 等高级研究能力，可选择性配置一个 LLM Provider（如 Gemini）。
快速安装：
# 初始化本地引擎（任意系统）
npx wigolo init
# 初始化并一键接入日常 agent（如 Claude Code + Cursor）
npx wigolo init --agents=claude-code,cursor
# 以 Docker 方式作为 stdio MCP 服务运行
docker run -i --rm -v wigolo-data:/data ghcr.io/knockoutez/wigolo
# 在自托管 box 上暴露 HTTP 服务（默认 127.0.0.1:3333）
wigolo serve
# 在你的应用里用 SDK 嵌入
npm install wigolo-sdk # TypeScript
pip install wigolo # Python常用运维命令：npx wigolo verify（健康检测）、npx wigolo warmup --all（重下引擎）、npx wigolo docto --fix（修复环境）。
⚙️ 核心功能
- 🔍 多引擎搜索 search：内置 18 个直连适配器，ML 重排 + 可解释评分，让智能体拿到「为什么是这条结果」。
- 🔗 抓取 & 爬取 fetch / crawl：分层路由获取单页并清洗为 markdown（含 PDF / 鉴权页处理）；BFS / DFS / sitemap 多页爬取并自带限流保护。
- 🧩 提取 & 缓存 & 相似 extract / cache / find_similar：从页面抽取表格 / JSON-LD / Schema 等结构化数据；本地缓存已见内容，二次查询毫秒即回；关键词 + 语义 + 实时发现相似页面。
- 🤖 自主研究 research / agent：把一个问题自动分解成子查询、扇出检索、综合成报告；
agent工具则跑 search→fetch→extract→synthesize 的自主收集循环。 - 🔔 变更追踪 diff / watch：检测页面变化并推送 webhook，把「定时盯网页」变成可编排的事件。
🚀 典型使用场景
- 场景一 · 编码时实时联网：在 Claude Code / Cursor 里改代码时，智能体直接调用
search/fetch查文档、查报错、查第三方 API，开发者不再手动复制粘贴；所有命中缓存在~/.wigolo/，隐私不出本机。 - 场景二 · 自托管 Agent 的「联网大脑」：在自托管服务器上
wigolo serve暴露 REST / MCP 端点，LangChain、CrewAI、n8n 等编排框架或任意 MCP client 统一调用，把分散在各处的抓取逻辑收敛成一个服务。 - 场景三 · 持续竞品 / 文档监控：用
watch盯住竞品定价页或文档页，diff 出变化并推 webhook 到飞书 / Slack / 自有系统，第一时间感知变更。
💡 推荐理由
我特别看好 Wigolo 的一点，是它真正把「本地优先」做到了极致：零 API Key、零按量账单，直接戳中「想让 agent 上网，却要为每家搜索引擎单独接 key、还要担心账单爆掉」的痛点。统一的 MCP 接口对 Claude Code / Cursor / Codex / Gemini CLI / VS Code / Zed 通吃，接入几乎零心智负担；数据默认留在本地，对重视隐私的开发者很友好；AGPL-3.0 开源、可完全自托管。如果你正想给自己的 coding agent 装上一双「眼睛和手」，Wigolo 是目前最省心的一站式方案。
🔗 下载地址
- 官网文档：https://knockoutez.github.io/wigolo/
- GitHub 仓库：https://github.com/KnockOutEZ/wigolo（⭐ 3,036+）
- npm：npmjs.com/package/wigolo
- PyPI：pypi.org/project/wigolo/
- Docker：
ghcr.io/knockoutez/wigolo - 许可证：GNU AGPL-3.0-only
发表回复