Bin-Huang/camoufox-cli

解決する課題

AIエージェントが検知を回避しながらWebを閲覧する方法を提供します。多くのWebサイトはフィンガープリントを使用して自動化されたボットを識別・ブロックしていますが、このツールを使用することで、エージェントはハードウェアやソフトウェアの署名を偽装し、永続的なIDを維持し、簡素化されたコマンドラインインターフェースを通じてページと対話することで、本物の人間のように振る舞うことができます。

仕組み

このツールは Camoufox ブラウザのCLIラッパーとして機能します。Playwrightを介してブラウザと通信するPythonデーモンを使用します。AIエージェントがCLIにシェルコマンドを送信すると、それがデーモンに渡され、URLへの移動、要素のクリック、スクリーンショットの撮影などのアクションが実行されます。検知を防ぐため、C++レベルのフィンガープリント（canvas、WebGL、オーディオなど）を偽装し、これらのIDをディスクに保存できるため、エージェントは同じ「デバイス」としてサイトに再訪できます。

対象ユーザー

Web自動化、データ抽出、または厳格なボット対策が施されたサイトとの対話が必要なAIエージェント（Claude Code、Cursor、OpenClawなどのフレームワークを使用）を構築する開発者。

主な特徴

• アンチ検知： canvas、WebGL、オーディオ、画面メトリクス、フォントを偽装し、ボット検知を回避します。
• エージェントフレンドリーな対話： 一意の要素参照 (@ref) を持つアクセシビリティツリーのスナップショットを使用し、エージェントが簡単に要素をターゲットにしてクリックできるようにします。
• ID管理： 永続的なフィンガープリントとCookieをサポートし、エージェントが起動をまたいで安定したセッションを維持できるようにします。
• セッション分離： 異なるフィンガープリントとプロキシを持つ複数の分離されたブラウザプロセスを有効にし、マルチアカウント管理を可能にします。
• json 出力： --json フラグにより構造化されたデータ抽出を提供し、エージェントが結果を解析しやすくします。