Bin-Huang/camoufox-cli

何を解決するか

camoufox-cli は、AIエージェントがボットとして検出されずにウェブを閲覧できるようにする、アンチディテクトブラウザのコマンドラインインターフェースを提供します。このツールは、C++レベルでハードウェアおよびソフトウェアのフィンガープリント（canvas、WebGL、音声など）を偽装することで、ボット検出の問題を解決し、ブラウザが本物のユーザーのように見えるようにします。

動作方法

このツールは、Unixソケットを介してPythonデーモンと通信するCLIとして動作します。このデーモンはPlaywrightを介してCamoufox（Firefoxベース）ブラウザインスタンスを管理します。エージェントは、要素に参照ID（例：@e1）を割り当てた簡略化されたアクセシビリティツリーのスナップショットシステムを使ってページと対話できます。これにより、クリック、フォーム入力、テキスト抽出が容易になります。

対象ユーザー

AIエージェント（Claude Code、Cursor、OpenClawなど）および、フィンガープリントやボット検出システムを回避しながらブラウザタスクを自動化したい開発者。

特徴

• C++レベルのフィンガープリント偽装: canvas、WebGL、音声、画面メトリクス、フォントを偽装して検出を回避。
• 恒久的なアイデンティティ: プロファイルパスにフィンガープリント、OS、ロケールを保存し、異なるセッション間でも同一のアイデンティティを維持。
• エージェントフレンドリーな操作: @refによる要素ターゲティングを用いたアクセシビリティツリーのスナップショットで、ナビゲーションと操作が簡単。
• セッションとタブの分離: 複数の名前付きセッション（別々のブラウザプロセス）と名前付きタブ（共有ブラウザプロセス）をサポートし、並列処理が可能。
• クッキー管理: JSON形式でクッキーのインポート・エクスポートが可能で、セッションの永続化を実現。
• プロキシおよびGeoIPサポート: 統合されたプロキシサポートと、プロキシIPに基づく自動GeoIP偽装。