Wiggle‑on‑the‑Web：wigolo の機能

概要

• wigolo はローカルファースト、デフォルトでゼロキーコストのウェブツールキットであり、AI エージェント向けです。
• 検索、取得、クロール、抽出に加え、エージェントオーケストレーター（Claude 5 Fable …）が MCP JSON‑RPC over stdio または REST 経由で呼び出せる高レベルのリサーチと自律収集ループをバンドルしています。
• すべての検索エンジン非依存のワークフロー‑‑18 エンジン融合取得‑‑ML 再ランク‑‑説明可能‑‑キャッシュ‑‑オフライン‑‑プライベート**。
• オプションの LLM 合成（Gemini、Anthropic、OpenAI、Groq、Ollama）が生の証拠を完成した回答に変換します。
• macOS、Linux、Windows 上の Node ≥ 20（約 1.5 GB ディスク）で動作；npm CLI、Docker イメージ、SDK（TS/Python）、MCP サーバーとして提供。

---

実際には何か

側面	詳細
カテゴリ	AI エージェント向けローカルファーストのウェブインテリジェンス層（検索、取得、クロール、抽出、キャッシュ、類似度、リサーチ、自律ループ）。
主要インターフェース	MCP（JSON‑RPC over stdio）– Claude Code、Cursor、Codex、Gemini CLI などのコーディングエージェントが使用するのと同じプロトコル。
二次インターフェース	REST API（wigolo serve）、TypeScript & Python SDK、Docker コンテナ、フレームワークラッパー（LangChain、CrewAI、LlamaIndex、Vercel AI SDK）。
主要な主張	• コアツール（検索/取得/クロール/…）に API キー不要；• クエリごとに $ 無料‑‑すべてのキャッシュはローカル；• バイト正確な引用と説明可能なスコアリングを備えた証拠豊富な結果；• ヘッドレスブラウザエンジンとオンデバイスモデルの初回ダウンロード後はオフラインで動作。
サポートされるエージェント	Claude Code、Cursor、Codex、Gemini CLI、OpenCode、VS Code、Windsurf、Zed、Antigravity（任意の MCP クライアントを追加可能）。
インストール	npx wigolo init（ブラウザエンジンとオンデバイスモデルをダウンロード）、オプションの --agents でエージェントを自動接続、--interactive/--wizard でガイド付きセットアップ、wigolo doctor で健全性を確認。
コアツール	search、fetch、crawl、extract、cache、find_similar、research、agent、diff、watch。
結果の形状	JSON に results（タイトル、url、抜粋、citation_id、source_span、evidence_score）、citations、鮮度シグナルを含む。
プライバシー	すべてのキャッシュ、埋め込み、モデルは ~/.wigolo/ の下に存在；LLM プロバイダーを有効にしない限り、サードパーティサービスに何も送信されません。
ライセンス	AGPL‑3.0（LICENSING.md 参照）。
ステータス	公開ベータ‑‑活発にメンテナンス中（CI バッジ、スター履歴、Discord コミュニティ）。

---

仕組み（簡略化）

1. エージェント → wigolo – AI エージェントが search {query:"…"} のような MCP/REST 呼び出しを行う。
2. ツール層 – wigolo はリクエストを多数のウェブエンジンアダプター（18 エンジン）にファンアウトし、結果をマージし、オンデバイス ML 再ランカーを実行し、透明なスコアを付与。
3. 取得ルーター – URL に対して、wigolo はまずプレーン HTTP 取得を試みる；ボットチャレンジや SPA が検出されるとヘッドレスブラウザプールにエスカレート。
4. キャッシュと埋め込み – 結果はローカルに保存（キーワード + ベクトルインデックス）されるため、繰り返しクエリは即時かつオフライン。
5. オプションの合成 – WIGOLO_LLM_PROVIDER が設定されている場合、選択された LLM が証拠を洗練された回答に書き換える；そうでなければ生の証拠が返される。
6. 応答 – エージェントは引用、バイト正確な抜粋、スコア、および任意の劣化フラグを含む構造化 JSON を受け取る。

---

いつ使用しますか？

• コーディングアシスタント（Claude Code、Cursor など）があり、API キーを公開したりクエリごとに支払ったりせずにウェブを閲覧させたい。
• 再現可能で監査可能な証拠が必要 – 各スニペットは正確なバイトオフセットに固定され、スコアリングされる。
• オンプレミスでエージェントを実行（自己ホスト LLM、プライベートデータ）し、ウェブ層をローカルに保つ必要がある。
• LangChain、CrewAI、LlamaIndex などでクラウドウェブ検索 API のドロップイン代替をゼロコストクエリで求めている。
• 初回エンジンダウンロード後にオフライン機能が必要（例：CI パイプラインやエアギャップ環境）。

---

クイックスタートチェックリスト

# 1. インストールと初期化（ブラウザとモデルをダウンロード）
npx wigolo init

# 2. 健全性を確認
npx wigolo doctor

# 3. CLI から検索を試す
wigolo search "local‑first software" --json

# 4. REST サーバーを実行（オプション）
wigolo serve   # → http://127.0.0.1:3333

# 5. Python SDK を使用（例）
python - <<'PY'
from wigolo import local_client
with local_client() as c:
    print(c.search(query='local‑first web search')['results'][0]['title'])
PY

---

制限と未解決の質問

領域	現在の状態
ウェブエンジンのカバレッジ	18 のアダプターだが、一部のニッチまたは有料 API はまだ欠けている可能性がある。
LLM 合成	オプションであり、外部キー（Gemini 無料枠、OpenAI など）が依然として必要。
ヘビーウェイトクロール	研究グレードの量向けに設計；大規模なエンタープライズクロールには専用クローラーが必要かもしれない。
プラットフォーム	Node ベース；非 Node 環境は REST/SDK ブリッジを使用する必要がある。
ライセンス	AGPL‑3.0 – 商業的再配布に影響を与える可能性がある。

---

詳細を見つける場所

• ドキュメント – docs/README.md（インストール、CLI、ツール、REST、SDK、セルフホスティング）。
• 例 – examples/README.md（実世界のエージェントスクリプト）。
• コミュニティ – Discord リンク、X @yourtowhid。
• ベンチマーク – README のセクションで wigolo を Firecrawl、Exa、Tavily と比較。

---

上記のすべての記述はリポジトリの README から直接引用したものであり、追加機能は推測されていません。