ブラウザサンドボックス

Firecrawl ブラウザサンドボックス は、API および SDK のユーザーに、エージェントが Web とやり取りできる安全なブラウザ環境を提供します。フォームへの入力、ボタンのクリック、認証などを実行できます。 ローカルでのセットアップは不要で、Chromium のインストールやドライバーの互換性の問題もありません。agent browser と playwright はプリインストール済みです。

API、Node SDK、Python SDK、および Vercel AI SDK 経由で利用できます。非表示の firecrawl browser CLI コマンドはレガシーです。CLI と MCP のエージェントフローでは、代わりに scrape + interact を使用してください。

AI コーディングエージェント (Claude Code、Codex、Open Code、Cursor など) に Interact 対応を追加するには、Firecrawl スキルをインストールします。

npx -y firecrawl-cli@latest init --all --browser

各セッションは、インフラを管理することなくスケールする、分離された使い捨てまたは永続的なサンドボックス内で実行されます。

セッションを作成し、コードを実行して終了します。

• ドライバーのインストール不要 - Chromium バイナリ不要、playwright install 不要、ドライバー互換性の問題なし
• Python、JavaScript、Bash 対応 - API、CLI、または SDK 経由でコードを送信して結果を取得。3 つの言語すべてがサンドボックス環境上でリモート実行されます
• agent-browser - 60 以上のコマンドがプリインストール済みの CLI。AI エージェントは Playwright コードではなくシンプルな bash コマンドを書くことで操作できます
• Playwright ロード済み - サンドボックス環境には Playwright がプリインストール済み。必要であればエージェントは Playwright コードを記述することもできます
• CDP へのアクセス - 完全な制御が必要なときは、独自の Playwright インスタンスを WebSocket 経由で接続可能
• ライブビュー - 埋め込み可能なストリーム URL を使って、セッションをリアルタイムで監視可能
• インタラクティブ ライブビュー - 埋め込み可能なインタラクティブなストリームを通じて、ユーザーがブラウザを直接操作できるようにします

セッションID、CDP URL、ライブビューのURLを返します。

{  "success": true,  "id": "550e8400-e29b-41d4-a716-446655440000",  "cdpUrl": "wss://browser.firecrawl.dev/cdp/550e8400...?token=abc123...",  "liveViewUrl": "https://liveview.firecrawl.dev/...",  "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...",  "expiresAt": "2025-01-15T10:40:00Z"}

セッション内で Python、JavaScript、または bash のコードを実行します。Output は stdout 経由で返されます。Node.js では、最後の式の値も result として利用できます。

{  "success": true,  "stdout": "",  "result": "Example Domain",  "stderr": "",  "exitCode": 0,  "killed": false}

セッション内でダウンロードされたファイルはキャプチャして、base64 として返すことができます。execute エンドポイントから Playwright の download API を使用します。

import base64async with page.expect_download() as download_info:    await page.click('a#download-link')  # ダウンロードをトリガーする要素をクリックdownload = download_info.valuepath = await download.path()# 必要に応じて既知のパスに保存# await download.save_as('/tmp/myfile.pdf')# ファイル内容を読み取り、base64 として出力with open(path, "rb") as f:    content = base64.b64encode(f.read()).decode()    print(content)

agent-browser は、すべてのサンドボックスにプリインストールされているヘッドレスブラウザ CLI です。Playwright のコードを書く代わりに、エージェントはシンプルな bash コマンドを送信します。CLI は自動的に --cdp フラグを付与し、agent-browser がアクティブなセッションに自動で接続できるようにします。

browser コマンドを使う最速の方法です。省略記法も execute も、どちらも自動的に agent-browser にコマンドを送信します。省略記法は単に execute を省略し、必要に応じてセッションを自動的に開始します。

firecrawl browser "open https://example.com"firecrawl browser "snapshot"firecrawl browser "click @e5"

明示的な形では execute を使用します。コマンドは自動的に agent-browser に送信されるので、agent-browser と入力したり、--bash を付けたりする必要はありません。

firecrawl browser execute "open https://example.com"firecrawl browser execute "snapshot"

API または SDK を使って agent-browser コマンドを実行するには、language: "bash" を指定します：

curl -X POST "https://api.firecrawl.dev/v2/interact/YOUR_SESSION_ID/execute" \  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "code": "agent-browser snapshot",    "language": "bash"  }'

デフォルトでは、各ブラウザセッションは常にまっさらな状態から始まります。profile を使うと、セッション間でブラウザの状態を保存し再利用できます。ログイン状態の維持や設定の保持に役立ちます。

プロファイルを保存または選択するには、セッション作成時に profile パラメータを使用します。

ブラウザセッションの状態は、セッションがクローズされたときにのみ保存されます。そのため、再利用できるよう、使い終わったらブラウザセッションをクローズすることを推奨します。セッションがクローズされると、そのセッション ID は無効になり、再利用できなくなります。代わりに、同じプロファイル名で新しいセッションを作成し、レスポンスで返される新しいセッション ID を使用してください。保存してクローズするには:

{  "success": true,  "sessions": [    {      "id": "550e8400-e29b-41d4-a716-446655440000",      "status": "active",      "cdpUrl": "wss://browser.firecrawl.dev/cdp/550e8400...?token=abc123...",      "liveViewUrl": "https://liveview.firecrawl.dev/...",      "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...",      "createdAt": "2025-01-15T10:30:00Z",      "lastActivity": "2025-01-15T10:35:00Z"    }  ]}

セッションには 2 種類の TTL 設定があります:

各セッションのレスポンスには liveViewUrl が含まれており、これを埋め込むことでブラウザーの状態をリアルタイムで確認できます。デバッグ、デモ、ブラウザー駆動型 UI の構築などに便利です。

{  "success": true,  "id": "550e8400-e29b-41d4-a716-446655440000",  "cdpUrl": "wss://browser.firecrawl.dev/cdp/550e8400...?token=abc123...",  "liveViewUrl": "https://liveview.firecrawl.dev/...",  "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...",  "expiresAt": "2025-01-15T10:40:00Z"}

<iframe src="LIVE_VIEW_URL" width="100%" height="600" />

レスポンスには interactiveLiveViewUrl も含まれます。閲覧専用の標準的な Live View と異なり、インタラクティブ Live View では、埋め込みストリームを通じてユーザーがブラウザセッションを直接操作できます (クリックや文字入力など) 。これは、ユーザー向けのブラウザ UI の構築、共同でのデバッグ、あるいは閲覧者がブラウザを操作する必要があるあらゆるシナリオに有用です。

<iframe src="INTERACTIVE_LIVE_VIEW_URL" width="100%" height="600" />

すべてのセッションは CDP WebSocket URL を提供します。execute API と --bash フラグでほとんどのユースケースはカバーできますが、完全にローカルで制御したい場合は、直接接続することもできます。

# セッションのレスポンスで返される cdpUrl を使用agent-browser open https://example.com --cdp "$CDP_URL"agent-browser snapshot --cdp "$CDP_URL"

• 競合分析 - 競合サイトを閲覧し、検索フォームやフィルターを操作して、価格や機能を構造化データとして抽出する
• ナレッジベースの取り込み - クリック操作、ページネーション、認証が必要なヘルプセンター、ドキュメント、サポートポータルを辿る
• 市場調査 - 複数のブラウザーセッションを並列で起動し、求人サイト、不動産リスティング、法的データベースなどからデータセットを構築する

料金はセッションの操作方法によって異なります。セッションで prompt を使用する場合はブラウザ 1 分あたり 7 credits、使用しない場合 (Playwright の code のみ) はブラウザ 1 分あたり 2 credits です。課金はブラウザ利用時間 1 分単位で、最低利用時間は 1 分です。Free ユーザーは 5 時間分を無料で利用できます。

初期リリースでは、すべてのプランで最大 20 個のブラウザーセッションを同時に稼働させることができます。

• ブラウザセッションを作成
• ブラウザコードを実行
• ブラウザセッションの一覧を取得
• ブラウザセッションを削除

ご意見やご不明な点がありましたら、help@firecrawl.com までメールいただくか、Discord でご連絡ください。

Firecrawl API key が必要な AI agent の方は、firecrawl.dev/agent-onboarding/SKILL.md の自動オンボーディング手順をご覧ください。