fatwang2/search2ai

解決する問題

AI エージェントとチャットクライアントは最新の検索とページコンテンツを必要としますが、単一のプロバイダーに依存すると、レート制限、タイムアウト、停止の影響を受けやすくなります。search2ai を使用すると、複数の検索および抽出サービスを設定でき、プロバイダーが失敗したときに自動的に次のプロバイダーにフォールバックするため、プロバイダーロジックをハードコードせずに一貫した結果を得られます。

仕組み

このプロジェクトは複数の統合パスを提供します：AI クライアント用のローカル MCP サーバー（stdio）、スタンドアロン HTTP サービス、JavaScript/TypeScript ライブラリ、マウント可能な Hono ルート。環境変数でプロバイダーキーまたは URL を設定し、操作（検索、ニュース、クロール）ごとにフォールバックチェーンを定義します。リクエストが来ると、ゲートウェイはプロバイダーを順に試し、最初の成功応答を返し、失敗に対して警告を報告します。結果は共通構造（タイトル、URL、スニペット、オプションの日付とコンテンツ）に正規化されます。オプションのチャットプロキシにより、ツール呼び出しをサポートするモデルプロバイダーが会話中にウェブ検索を実行できます。また、既存の SDK（Exa、Tavily、SearXNG など）が最小限の変更でこのゲートウェイを指すことができる互換性エンドポイントもあります。

対象読者

AI アシスタント、エージェント、またはウェブ検索やページ抽出を必要とするアプリを構築する開発者。プロバイダーを切り替えたり組み合わせたりしたい場合、または Claude Desktop や Cursor などの MCP 対応クライアントで動作する自己ホスト型エンドポイントが必要な場合に特に役立ちます。

ハイライト

• プロバイダー間で正規化された結果：タイトル、URL、スニペット、オプションの日付/コンテンツ。
• 設定されたプロバイダーに応じて、検索、ニュース、ページ抽出（クロール）をサポート。
• プロバイダーを自由に選択；未設定のプロバイダーは自動的に有効になりません。
• 操作ごとの順序付け、インメモリおよび Cloudflare KV キャッシュを備えたフォールバックチェーン。
• 複数の統合スタイル：MCP、HTTP API、JS/TS ライブラリ、Hono マウント。
• 既存の API クライアント向けの互換性エンドポイント（SearXNG、Exa、Tavily、Search1API、Firecrawl シングルページ）。