Johell1NS/browser-search

何を解決するか

browser-search は、Cloudflare や Akamai などのブロッキング保護に阻まれることなく、AIエージェントがウェブを検索・閲覧できるようにするツール群です。確定的な「検索を先に、回答を後に」というワークフローを採用することで、モデルの誤った生成（ホールーシュレーション）を排除することを目指しています。

動作方法

このプロジェクトは、ウェブアクセスのための三段階エスカレーションシステムを実装しています：

1. 検索フェーズ：複数のソースからURLとスニペットを迅速に取得するために、SearXNG（自己ホスト型メタ検索エンジン）を使用します。
2. 標準ブラウジング：REST API経由でアクセス可能なFirefoxベースのブラウザであるCamofoxを使用して、Readability.jsを用いてクリーンなコンテンツを抽出します。
3. ステルスブラウジング：サイトがCamofoxをブロックした場合、エージェントは自動的にCloakBrowserにエスカレートします。CloakBrowserは、高度なフィンガープリント技術とC++ソースレベルのパッチを備えたChromiumベースのブラウザで、高度なブロッキングチャレンジを回避できます。

対象ユーザー

OpenCode、Claude Code、Cursor、GitHub CopilotなどのAIエージェントの開発者やユーザーで、有料APIに依存せず、信頼性の高い、無制限の自己ホスト型ウェブリサーチを実現したい方におすすめです。

特徴

• ブロッキング回避：Cloudflare、Turnstile、DataDome、Akamaiなど、さまざまな保護を明確に回避するように設計されています。
• 自己ホスト型で無料：APIキーもサブスクリプションも不要。すべてのコンポーネントはDockerとnpmでローカルマシン上で動作します。
• ホールーシュレーション防止：エージェントがライブのウェブソースに基づいて主張を検証する厳格なワークフローを強制します。
• 自動エスカレーション：サイトの応答に基づき、エージェントが標準ブラウジングからステルスモードに切り替えるタイミングを自律的に判断します。
• セキュリティ強化：内部的にSSRF防止、スクリプトサンドボックス、リクエスト制限機能を備えています。