メインコンテンツへスキップ
Firecrawl Browser Sandbox は、エージェントに安全でフルマネージドなブラウザー環境を提供します。ローカルでのセットアップは不要で、Chromium のインストールやドライバーの互換性問題も発生しません。agent-browser と Playwright はあらかじめインストール済みです。各セッションは分離された破棄可能なサンドボックス内で実行され、インフラを管理することなくスケールします。 API、CLI（Bash / agent-browser、Python、Node）、Node SDK、Python SDK、Vercel AI SDK、および MCP Server 経由で利用できます。 AI コーディングエージェント（Claude Code、Codex、Open Code、Cursor など）にブラウザー対応を追加するには、Firecrawl スキルをインストールします： 
npx -y firecrawl-cli@latest init --all --browser
また、上記のコマンドを使って Firecrawl CLI を自分でインストールすることも、エージェントにインストールさせることもできます。 
npm install -g firecrawl-cli

​
クイックスタート

セッションを作成し、コードを実行して終了します。 
// npm install @mendable/firecrawl-js
import Firecrawl from '@mendable/firecrawl-js';

const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

// 1. セッションを起動
const session = await firecrawl.browser();
console.log(session.cdpUrl); // wss://cdp-proxy.firecrawl.dev/cdp/...

// 2. Execute code
const result = await firecrawl.browserExecute(session.id, {
  code: `
    await page.goto("https://news.ycombinator.com");
    const title = await page.title();
    console.log(title);
  `,
  language: "node",
});
console.log(result.result); // "Hacker News"

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

​
セッションを開始する

セッションID、CDP URL、ライブビューのURLを返します。 
import Firecrawl from '@mendable/firecrawl-js';

const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

const session = await firecrawl.browser({
  ttl: 120,
  activityTtl: 60,
});

console.log(session.id);
console.log(session.cdpUrl);      // wss://cdp-proxy.firecrawl.dev/cdp/...
console.log(session.liveViewUrl); // https://liveview.firecrawl.dev/...
Response
{
  "success": true,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cdpUrl": "wss://cdp-proxy.firecrawl.dev/cdp/550e8400-e29b-41d4-a716-446655440000",
  "liveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000"
}

​
コードの実行

import Firecrawl from '@mendable/firecrawl-js';

const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

const result = await firecrawl.browserExecute("YOUR_SESSION_ID", {
  code: 'await page.goto("https://example.com"); const title = await page.title(); console.log(title);',
  language: "node",
});

console.log(result);
Response
{
  "success": true,
  "result": "Example Domain"
}

​
agent-browser（Bash モード）

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"

​
CLI

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

​
API と SDK

API または SDK を使って agent-browser コマンドを実行するには、language: "bash" を指定します： 
curl -X POST "https://api.firecrawl.dev/v2/browser/YOUR_SESSION_ID/execute" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "agent-browser snapshot",
    "language": "bash"
  }'

​
セッション管理

​
セッション一覧を取得する

import Firecrawl from '@mendable/firecrawl-js';

const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

const { sessions } = await firecrawl.listBrowsers();
console.log(sessions);

// ステータスでフィルター
const { sessions: active } = await firecrawl.listBrowsers({ status: "active" });
console.log(active);
Response
{
  "success": true,
  "sessions": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "active",
      "cdpUrl": "wss://cdp-proxy.firecrawl.dev/cdp/550e8400-e29b-41d4-a716-446655440000",
      "liveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2025-01-15T10:30:00Z",
      "lastActivity": "2025-01-15T10:35:00Z"
    }
  ]
}

​
TTL 設定

セッションには 2 種類の TTL 設定があります:
ParameterDefaultDescription
ttl300s (5 min)セッションの最大存続時間 (30-3600s)
activityTtl120s (2 min)非アクティブ時の自動クローズまでの時間 (10-3600s)

​
セッションを終了する

import Firecrawl from '@mendable/firecrawl-js';

const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

await firecrawl.deleteBrowser("YOUR_SESSION_ID");

​
ライブビュー

各セッションのレスポンスには liveViewUrl が含まれており、これを埋め込むことでブラウザーの状態をリアルタイムで確認できます。デバッグ、デモ、ブラウザー駆動型 UI の構築などに便利です。
Response
{
  "success": true,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cdpUrl": "wss://cdp-proxy.firecrawl.dev/cdp/550e8400-...",
  "liveViewUrl": "https://liveview.firecrawl.dev/550e8400-..."
}

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

​
CDP 経由での接続

すべてのセッションは CDP WebSocket URL を提供します。execute API と --bash フラグでほとんどのユースケースはカバーできますが、完全にローカルで制御したい場合は、直接接続することもできます。 
import Firecrawl from '@mendable/firecrawl-js';
import { chromium } from "playwright-core";

const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });
const session = await firecrawl.browser();

const browser = await chromium.connectOverCDP(session.cdpUrl);
const context = browser.contexts()[0];
const page = context.pages()[0] || (await context.newPage());

await page.goto("https://example.com");
console.log(await page.title());

await browser.close();
await firecrawl.deleteBrowser(session.id);

​
Browser を使うべきタイミング

ユースケース適切なツール
既知の URL からコンテンツを抽出するScrape
Web を検索して結果を取得するSearch
ページネーションの操作、フォーム入力、クリックを伴うフローの操作Browser
インタラクションを伴うマルチステップのワークフローBrowser
複数のサイトを並列にブラウジングするBrowser（各セッションは分離されている）

​
ユースケース

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

​
料金

料金体系はシンプルで、ブラウザの稼働1分あたり2クレジットです。無料プランでは最大5時間まで無料で利用できます。

​
レート制限

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

​
API リファレンス

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