wigolo 是什麼？

如果你正在用 Claude Code、Cursor、Codex 等 AI 程式設計 Agent 寫程式，你會發現一個致命缺陷：它們預設不能上網。當你的 Agent 需要查詢最新文件、搜尋某個 API 用法、或者閱讀一篇技術部落格時，它只能依靠訓練資料中的舊知識 —— 這對於快速迭代的技術生態來說遠遠不夠。

wigolo 就是為了解決這個問題而生的開源工具。它是一個 本地優先（local-first）的網路智慧 MCP 伺服器，可以讓任何 AI Agent 擁有搜尋、擷取、爬取、提取和研究網際網路的能力，而且 不需要 API Key，完全免費。

專案 資訊
GitHub KnockOutEZ/wigolo
Stars 1,750+（GitHub Trending 上榜）
語言 TypeScript (Node.js ≥ 20)
協定 MIT 開源
支援平台 macOS / Linux / Windows

wigolo 能做什麼？

wigolo 提供了 10 個核心 MCP 工具函式，涵蓋了 AI Agent 所需的全部網路能力：

  • search — 搜尋引擎查詢（無需 API Key，本地執行）
  • fetch — 取得網頁內容並提取正文
  • crawl — 整站爬取，遍歷多個頁面
  • extract — 從網頁中結構化提取資料
  • cache — 本地持久快取，避免重複請求
  • find-similar — 找到與給定內容相似的頁面
  • research — 自主研究迴圈，彙總多來源資訊（需要 LLM）
  • gather — 自動蒐集迴圈，按主題蒐集資料
  • doctor — 健康檢查，診斷設定問題
  • status — 檢視執行狀態和統計

所有核心功能完全離線執行在 ~/.wigolo/ 目錄下，資料不會離開你的電腦。

安裝與快速上手

環境需求

  • Node.js ≥ 20
  • 約 1.5 GB 磁碟空間

一鍵安裝

wigolo 的安裝極其簡單，只需一條指令：

npx wigolo init --agents=claude-code

這條指令會自動完成： 1. 下載瀏覽器引擎和本地模型 2. 執行健康檢查 3. 為你寫入 MCP 設定檔

--agents 參數支援自動設定以下 Agent： - claude-code — Claude Code - cursor — Cursor IDE - codex — ChatGPT Codex - gemini-cli — Gemini CLI - vscode — VS Code - windsurf — Windsurf IDE - zed — Zed IDE - antigravity — Antigravity

安裝完成後，可以用以下指令隨時檢查狀態：

npx wigolo doctor

如果一切正常，你會看到所有元件的綠色狀態報告。

與其他 Agent 整合

如果你用的是不在自動設定列表中的 MCP 客戶端（比如 LangChain、CrewAI、n8n），可以手動註冊：

# 不指定 --agents，手動設定
npx wigolo init

然後在你的 MCP 設定檔中加入：

{
  "mcpServers": {
    "wigolo": {
      "command": "npx",
      "args": ["-y", "wigolo", "stdio"]
    }
  }
}

完全解除安裝

如果不需要了，一鍵清理乾淨：

npx wigolo config --uninstall --yes

進階用法

啟用 LLM 驅動的研究功能

wigolo 的搜尋、擷取等核心功能完全不需要 API Key。但如果你想啟用更強大的 research 和 gather 功能（這些功能需要 LLM 來綜合多個資訊來源），只需要一個免費的 Gemini API Key：

export WIGOLO_LLM_PROVIDER=gemini
export GEMINI_API_KEY="your-free-key"

在 Google AI Studio 免費申請 Key 即可。免費額度完全夠用。

也支援其他 LLM 提供商： - anthropic — Claude API - openai — OpenAI API - groq — Groq API - ollama — 本地 Ollama（完全離線）

作為 REST API 服務執行

如果你想讓遠端 Agent（比如部署在 VPS 上的 n8n 自動化）也能使用 wigolo，可以啟動 serve 模式：

npx wigolo serve --port 3000

然後用 curl 呼叫：

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"latest Rust async best practices"}}}'

結合 Claude Code 實戰

wigolo 與 Claude Code 配合使用時效果最好。以下是一個真實工作流程：

情境：查詢某個新函式庫的最新用法

你告訴 Claude Code：

用 wigolo 搜尋 "Rust tokio 2026 best practices"，幫我總結最新寫法

Claude Code 會自動呼叫 wigolo 的 search 工具取得搜尋結果，然後綜合多個頁面的資訊給你一份準確、最新的總結。

與同類工具比較

功能 wigolo 瀏覽器搜尋外掛 傳統 MCP 搜尋工具
是否需要 API Key ❌ 不需要 ❌ 不需要 ✅ 通常需要
是否收費 ✅ 免費 可能收費 按呼叫收費
資料隱私 ✅ 全部本機儲存 資料傳到第三方 資料傳到第三方
是否支援 Agent ✅ 原生 MCP 支援 僅瀏覽器外掛 部分支援
本地快取 ✅ 內建 ❌ 無 通常無
自主研究迴圈 ✅ research 工具 ❌ 無 ❌ 無

wigolo 最大的優勢是 本地優先 — 你的所有搜尋歷史、快取資料、研究結果都儲存在 ~/.wigolo/ 目錄下，不會上傳到任何雲端服務。

自部署方案

對於團隊使用情境，你可以將 wigolo 部署在 VPS 上，讓多個開發者的 Agent 共享同一個搜尋執行個體。

Docker 部署

FROM node:20-slim
RUN npm install -g wigolo
EXPOSE 3000
CMD ["npx", "wigolo", "serve", "--port", "3000"]

Nginx 反向代理

server {
    listen 443 ssl;
    server_name wigolo.yourdomain.com;

    location /mcp {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
    }
}

常見問題

wigolo 安全嗎？會洩露我的資料嗎？

不會。wigolo 是本地優先的工具，所有資料儲存在 ~/.wigolo/ 目錄。它不會將你的搜尋歷史或快取資料傳送到任何外部伺服器。詳細隱私說明見 privacy & security 文件。

我的 Agent 呼叫 wigolo 太慢怎麼辦？

可以用 npx wigolo doctor 診斷。如果本地模型下載未完成，首次搜尋會比較慢。完成一次搜尋後結果會快取，後續查詢會顯著加速。

wigolo 支援哪些搜尋引擎？

wigolo 內建了多種搜尋引擎和擷取能力，無需外部 API。你也可以透過外掛系統新增自訂搜尋引擎和內容提取器。

總結

wigolo 是目前最成熟的開源本地網路智慧 MCP 伺服器，填補了 AI 程式設計 Agent「不能上網」的關鍵空白。它的核心價值在於：

  1. 零成本 — 核心功能完全免費，無需 API Key
  2. 隱私優先 — 所有資料本機儲存
  3. 開箱即用 — 一行指令完成安裝和 Agent 整合
  4. 功能全面 — 搜尋、擷取、爬取、研究、快取全覆蓋
  5. 高度擴充 — 支援外掛、SDK、REST API、Docker 部署

如果你的 AI 程式設計工作流程還缺少「上網搜尋」這一環，wigolo 是目前最佳的選擇。

📌 相關連結 - wigolo GitHub - wigolo 文件 - wigolo MCP 市場頁