wigolo とは？

Claude Code、Cursor、Codex といった AI プログラミングエージェントでコードを書いていると、ある致命的な欠点に気づくはずです。それらはデフォルトではインターネットに接続できないということです。エージェントが最新のドキュメントを調べたり、特定の API の使い方を検索したり、技術ブログを読んだりしたいとき、エージェントはトレーニングデータに含まれる古い知識に頼るしかありません。これは技術エコシステムが急速に進化する中で、明らかに不十分です。

wigolo はまさにこの問題を解決するために生まれたオープンソースツールです。wigolo はローカル優先のネットワークインテリジェント MCP サーバーであり、あらゆる AI エージェントにインターネットの検索、クロール、スクレイピング、抽出、リサーチの能力を与えます。しかもAPI キー不要で完全無料です。

項目 情報
GitHub KnockOutEZ/wigolo
スター数 1,750+（GitHub Trending にもランクイン）
言語 TypeScript (Node.js ≥ 20)
ライセンス MIT オープンソース
対応プラットフォーム macOS / Linux / Windows

wigolo で何ができる？

wigolo は AI エージェントに必要なネットワーク機能を網羅する 10 個の主要な MCP ツール関数を提供しています：

  • search — 検索エンジンクエリ（API キー不要、ローカル実行）
  • fetch — Web ページのコンテンツ取得と本文抽出
  • crawl — サイト全体のクロール、複数ページを巡回
  • extract — Web ページからの構造化データ抽出
  • cache — ローカル永続キャッシュ、重複リクエストを回避
  • find-similar — 指定したコンテンツと類似したページを発見
  • research — 自律的なリサーチループ、複数ソースからの情報要約（LLM が必要）
  • gather — 自動収集ループ、テーマ別に資料を収集
  • doctor — ヘルスチェック、設定の問題を診断
  • status — 実行状態と統計情報の確認

すべてのコア機能は ~/.wigolo/ ディレクトリ内で完全にオフライン実行され、データはあなたのパソコンから外に出ることはありません。

インストールとクイックスタート

環境要件

  • Node.js ≥ 20
  • 約 1.5 GB のディスク容量

ワンコマンドでインストール

wigolo のインストールは驚くほど簡単。コマンドはたったひとつです：

BASH 
npx wigolo init --agents=claude-code

このコマンドだけで自動的に以下の処理が完了します： 1. ブラウザエンジンとローカルモデルのダウンロード 2. ヘルスチェックの実行 3. MCP 設定ファイルの書き込み

--agents パラメータには以下のエージェントの自動設定がサポートされています： - 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

インストール完了後、いつでも以下のコマンドで状態を確認できます：

BASH 
npx wigolo doctor

すべて正常であれば、全コンポーネントのグリーンの状態レポートが表示されます。

他のエージェントとの統合

自動設定リストにない MCP クライアント（LangChain、CrewAI、n8n など）を使っている場合は、手動で登録できます：

BASH 
# --agents を指定せず、手動で設定
npx wigolo init

その後、MCP 設定ファイルに以下を追記します：

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

完全アンインストール

不要になったときは、きれいに一括削除：

BASH 
npx wigolo config --uninstall --yes

上級者向け使い方

LLM 駆動のリサーチ機能を有効にする

wigolo の検索やクロールといったコア機能に API キーはまったく不要です。ただし、より強力な research と gather 機能（これらは複数の情報源を LLM で統合する機能）を有効にするには、無料の Gemini API キーがひとつあれば十分です：

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

Google AI Studio で無料でキーを発行できます。無料枠で十分に実用可能です。

他の LLM プロバイダーもサポートされています： - anthropic — Claude API - openai — OpenAI API - groq — Groq API - ollama — ローカル Ollama（完全オフライン）

REST API サービスとして起動

VPS 上にデプロイしたリモートエージェント（n8n の自動化など）から wigolo を使いたい場合は、serve モードで起動します：

BASH 
npx wigolo serve --port 3000

curl で呼び出せます：

BASH 
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 キーが必要か ❌ 不要 ❌ 不要 ✅ 通常必要
料金 ✅ 無料 有料の場合あり 呼び出しごとに課金
データプライバシー ✅ すべてローカル保存 サードパーティに送信 サードパーティに送信
エージェント対応 ✅ ネイティブ MCP 対応 ブラウザプラグインのみ 一部対応
ローカルキャッシュ ✅ 内蔵 ❌ なし 通常なし
自律リサーチループ ✅ research ツール ❌ なし ❌ なし

wigolo の最大の優位性はローカル優先であること。すべての検索履歴、キャッシュデータ、リサーチ結果は ~/.wigolo/ ディレクトリに保存され、クラウドサービスにアップロードされることはありません。

自前デプロイ方法

チームでの利用シーンでは、wigolo を VPS 上にデプロイして、複数の開発者のエージェントで同じ検索インスタンスを共有できます。

Docker デプロイ

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

Nginx リバースプロキシ

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 ドキュメント を参照してください。

wigolo の呼び出しが遅い場合は？

npx wigolo doctor で診断できます。ローカルモデルのダウンロードが完了していない場合、初回の検索は時間がかかります。一度検索が完了すれば結果はキャッシュされるため、後続のクエリは大幅に高速化されます。

wigolo はどの検索エンジンをサポートしていますか？

wigolo は複数の検索エンジンとクローリング機能を内蔵しており、外部 API は不要です。プラグインシステム を使ってカスタム検索エンジンやコンテンツエクストラクターを追加することもできます。

まとめ

wigolo は現在最も成熟したオープンソースのローカルネットワークインテリジェント MCP サーバーであり、AI プログラミングエージェントが「インターネットに接続できない」という重要なギャップを埋めるものです。そのコアバリューは以下の通り：

  1. ゼロコスト — コア機能は完全無料、API キー不要
  2. プライバシー優先 — すべてのデータはローカルに保存
  3. すぐに使える — ワンコマンドでインストールとエージェント統合が完了
  4. 機能満載 — 検索、クロール、スクレイピング、リサーチ、キャッシュをすべてカバー
  5. 高い拡張性 — プラグイン、SDK、REST API、Docker デプロイに対応

AI プログラミングワークフローに「インターネット検索」の一环が欠けているなら、wigolo が今のところ最良の選択肢です。

📌 関連リンク - wigolo GitHub - wigolo ドキュメント - wigolo MCP マーケットプレイス