オフラインウェブ検索：AIエージェント向けのローカルGoogle検索代替案

概要

offline-web-searchは、オフラインでのウェブ検索機能を必要とするAIエージェント向けに特別に設計された、完全にローカルで動作するGoogle検索の代替ツールです。これはClaudeのウェブツールのドロップイン代替品として作成され、LLMが複雑なプロンプトなしで使用できるようにしています。

解決される中核的な問題

開発者は、AIエージェント向けの既存のオフライン検索ソリューションには重大な制限があることを特定しました。ほとんどのツールは、生のHTMLファイルをコンテキストウィンドウにダンプするか、エージェントが特定のドキュメントを見つけることを妨げる基本的な検索機能しか備えていません。これは、エアギャップ環境、機密データの処理、完全にローカルなスタックの構築において特に問題となります。

主な技術的特徴

• 検索エンジンの挙動: テキストダンプの代わりに、BM25ランキング、タイトルブースト、同義語拡張、プレフィックスマッチング、非英語の優先度低下を使用して、コンテンツをローカルのSQLite FTS5データベースにインデックス化します。
• コンテンツソース: Kiwix ZIMアーカイブ（Stack Overflow、Pythonドキュメント、DevDocs、Wikipediaのオフラインスナップショットを含む）をネイティブでサポートし、内部Confluence、社内ドキュメント、ランダムなHTMLページなどのカスタムコンテンツ用のインデックス作成APIとクローラーを含みます。
• アーキテクチャ: HTTP APIを使用したクライアント-サーバーモデルを採用しています。「重い」コンテンツサーバーはネットワーク上で集中的に実行され、軽量なクライアントはClaude Desktop用のMCPサーバーまたはネイティブのClaude Codeスキルを介して接続します。
• 公開されるツール: 2つの標準ツールを提供します：BM25ランキング検索用のGoogle Searchと、完全なページのクリーンなMarkdownを返すvisit_pageです。

仕組み

このツールは、ClaudeのWeb-FetchおよびWeb-Searchツール、それらのシステムプロンプト、機能をリバースエンジニアリングして構築されました。検索結果はLLMに高度に関連性の高い、ランク付けされたスニペットを提供し、その後visit_pageツールを使用して完全なページのクリーンで読みやすいMarkdownバージョンにアクセスできます。

対象ユーザー

インターネットアクセスなしで信頼性の高い検索機能を必要とする、オフラインAIエージェントまたは高度にローカルなセットアップを構築する開発者向けです。