mcpField
C
camofox-browser

camofox-browser

github.com/yelbanエージェントワークフロー16401 回インストール37 週間前に更新
リポジトリ

camofox-browser について

camofox-browserはFirefox派生版Camoufoxを使うブラウザー自動化スキルです。ボット検知のあるサイトを扱うエージェント向けに、指紋偽装とコマンドラインでの操作を提供します。

主な機能

  1. 01タブの移動と制御
  2. 02要素参照付きアクセシビリティスナップショット
  3. 03ページ要素のクリックとテキスト入力
  4. 04スクリーンショットと検索マクロ
  5. 05セッション分離とサーバー管理

活用シーン

  1. 01ボット検知のあるサイトの操作自動化
  2. 02Webフォームの確認と入力
  3. 03対応サイトでの検索

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/yelban/camofox-browser-skills --skill camofox-browser

インストール後、Claude Code で/camofox-browserを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
anti-detection.md
api-reference.md
macros-and-search.md
scripts/
camofox.sh
setup.sh
templates/
multi-session.sh
stealth-scrape.sh

詳細

Camofox Browser - 検出回避ブラウザー自動化

Camoufox（Firefox のフォーク）を使用したステルスブラウザー自動化です。C++ レベルのフィンガープリント偽装により、JavaScript ベースのボットチェックで検出されません。curl を使用する REST API ラッパーです。

インストール

初回使用時に Camoufox ブラウザー（約300MB）が自動でダウンロード、インストールされます。手動でのセットアップは不要です。camofox コマンドを実行するだけで使えます。

クイックスタート

camofox open https://example.com          # Open URL (auto-starts server)
camofox snapshot                          # Get page elements with @refs
camofox click @e1                         # Click element
camofox type @e2 "hello"                  # Type text
camofox screenshot                        # Take screenshot
camofox close                             # Close tab

基本的なワークフロー

  1. 移動：camofox open <url> — タブを開いて移動します
  2. スナップショット：camofox snapshot — @e1、@e2 の参照を含むアクセシビリティツリーを返します
  3. 操作：参照を使ってクリック、入力、選択を行います
  4. 再スナップショット：移動後または DOM の変更後に、新しい参照を取得します
  5. 繰り返し：コマンドの実行中もサーバーは起動したままです
camofox open https://example.com/login
camofox snapshot
# @e1 [input] Email  @e2 [input] Password  @e3 [button] Sign In

camofox type @e1 "[email protected]"
camofox type @e2 "password123"
camofox click @e3
camofox snapshot  # Re-snapshot after navigation

コマンド

ナビゲーション
camofox open <url>                   # Create tab + navigate (aliases: goto)
camofox navigate <url>               # Navigate current tab
camofox back                         # Go back
camofox forward                      # Go forward
camofox refresh                      # Reload page
camofox scroll down                  # Scroll down (also: up, left, right)
ページの状態
camofox snapshot                     # Accessibility snapshot with @refs
camofox screenshot                   # Screenshot to /tmp/camofox-screenshots/
camofox screenshot output.png        # Screenshot to specific path
camofox tabs                         # List all open tabs
操作（スナップショットの @refs を使用）
camofox click @e1                    # Click element
camofox type @e1 "text"              # Type into element
検索マクロ
camofox search google "query"        # Google search
camofox search youtube "query"       # YouTube search
camofox search amazon "query"        # Amazon search
camofox search reddit "query"        # Reddit search

利用可能なマクロは13種類です。references/macros-and-search.md をご覧ください。

セッション管理
camofox --session work open <url>    # Isolated session
camofox --session work snapshot      # Use specific session
camofox close                        # Close current tab
camofox close-all                    # Close all tabs in session
サーバー制御
camofox start                        # Start server (usually auto)
camofox stop                         # Stop server
camofox health                       # Health check

参照のライフサイクル（重要）

ページが変更されると、参照（@e1、@e2）は無効になります。次の操作の後は、必ず再度スナップショットを取得してください。

  • ページ遷移を伴うリンクやボタンのクリック
  • フォームの送信
  • 動的コンテンツの読み込み
camofox click @e3                    # Navigates to new page
camofox snapshot                     # MUST re-snapshot
camofox click @e1                    # Use new refs

camofox-browser と agent-browser の使い分け

シナリオツール
ボット検出のない通常のウェブサイトagent-browser（より高速）
Cloudflare / Akamai で保護されたサイトcamofox-browser
Chromium による自動化をブロックするサイトcamofox-browser
フィンガープリント対策が必要な場合camofox-browser
iOS / モバイルのシミュレーションが必要な場合agent-browser
動画録画が必要な場合agent-browser

検出回避機能

  • C++ レベルのフィンガープリント偽装（canvas、WebGL、AudioContext、フォント）
  • Firefox ベース（Chromium ではないため、検出される対象が異なります）
  • 人間らしい操作タイミング（humanize パラメーター）
  • WebRTC の情報漏えい防止
  • navigator.webdriver フラグなし

詳細は references/anti-detection.md をご覧ください。

環境変数

変数デフォルト説明
CAMOFOX_PORT9377サーバーポート
CAMOFOX_SESSIONdefaultデフォルトのセッション名
CAMOFOX_HEADLESStrueヘッドレスモード
HTTPS_PROXY—プロキシサーバー

詳細ドキュメント

リファレンス使用する場面
references/api-reference.mdREST API エンドポイントの全ドキュメント
references/anti-detection.mdフィンガープリント偽装の詳細
references/macros-and-search.md13種類の検索マクロ

すぐに使えるテンプレート

テンプレート説明
templates/stealth-scrape.sh検出回避スクレイピングのワークフロー
templates/multi-session.sh複数セッションの分離

トラブルシューティング

サーバーが起動しない場合

camofox health                        # Check if running
camofox stop && camofox start         # Restart

まだブロックされる場合

# Enable proxy
HTTPS_PROXY=socks5://127.0.0.1:1080 camofox open <url>

ボット検出テスト

camofox open https://bot.sannysoft.com/
camofox screenshot bot-test.png

クリーンアップ

完了したら、必ず閉じてください。

camofox close-all
camofox stop

コメント

Markdown 対応