> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ja/llms.txt

# FirecrawlBrowser クラス

`FirecrawlBrowser` クラスは、[Firecrawl Browser Sandbox](https://docs.firecrawl.dev/features/browser) を利用したブラウザー自動化を提供します。Firecrawl API を通じてリモートブラウザーセッションをプロビジョニングし、Chrome DevTools Protocol（CDP）経由で接続します。

`FirecrawlBrowser` は [`AgentBrowser`](https://mastra.zisheng.pro/ja/reference/browser/agent-browser) を拡張し、同じ決定論的な Tool セットを公開します。ローカルに Chromium をインストールせず、ホストされたブラウザーセッションを使用する場合に利用してください。ローカルでの自動化については [`AgentBrowser`](https://mastra.zisheng.pro/ja/reference/browser/agent-browser) を参照してください。自然言語を使用した AI による操作については [`StagehandBrowser`](https://mastra.zisheng.pro/ja/reference/browser/stagehand-browser) を参照してください。

## 使用例

```typescript
import { Agent } from '@mastra/core/agent'
import { FirecrawlBrowser } from '@mastra/browser-firecrawl'

const browser = new FirecrawlBrowser({
  apiKey: process.env.FIRECRAWL_API_KEY,
  firecrawl: {
    ttl: 600,
  },
})

export const browserAgent = new Agent({
  id: 'browser-agent',
  name: 'Browser Agent',
  instructions: `You can browse the web. Use browser_snapshot to see the page structure,
then interact with elements using their refs (e.g., @e5).`,
  model: 'openai/gpt-5.6-sol',
  browser,
})
```

## コンストラクターのパラメーター

`FirecrawlBrowser` は、すべての [`AgentBrowser` コンストラクターのパラメーター](https://mastra.zisheng.pro/ja/reference/browser/agent-browser)に加えて、次のパラメーターを受け取ります。

**apiKey** (`string`): Firecrawl API キー。指定されていない場合は FIRECRAWL\_API\_KEY 環境変数を使用します。どちらも設定されていない場合、コンストラクターは例外をスローします。

**apiUrl** (`string`): セルフホスト型 Firecrawl API のベース URL。

**firecrawl** (`FirecrawlBrowserSessionOptions`): Sandbox セッションの作成時に Firecrawl browser() API に渡すセッションオプション。

**firecrawl.ttl** (`number`): セッションの最大有効期間（秒）。

**firecrawl.activityTtl** (`number`): Sandbox がセッションを再利用するまでのアイドルタイムアウト（秒）。

**firecrawl.streamWebView** (`boolean`): true の場合、Firecrawl はリモートセッションの WebView フレームをストリーミングすることがあります。

**firecrawl.profile** (`{ name: string; saveChanges?: boolean }`): 名前付きの Firecrawl Sandbox プロファイル。セッション終了時に Cookie とログイン状態を永続化するには、saveChanges: true を設定します。プロファイルに名前を付けるだけでは、変更は保存されません。ローカルの Playwright ユーザーデータディレクトリのパスを指定する、最上位の AgentBrowser profile オプションとは異なります。

**firecrawl.integration** (`string`): Firecrawl の分析とルーティングに使用する統合ラベル。

**firecrawl.origin** (`string`): Firecrawl ブラウザーセッションに渡すオリジンのヒント。

## セッションのライフサイクル

セッションのプロビジョニング方法は、`AgentBrowser` から継承した `scope` オプションによって異なります。

- `'thread'`（デフォルト）: 会話スレッドごとに専用の Firecrawl Sandbox セッションが割り当てられます。セッションは初回使用時に作成され、スレッドのブラウザーセッションが破棄されると削除されます。
- `'shared'`: ブラウザーの起動時に Firecrawl Sandbox セッションを1つ作成し、すべてのスレッドで共有します。ブラウザーを閉じるとセッションは削除されます。

どちらの場合も、`FirecrawlBrowser` はブラウザーを閉じる際にリモートの Firecrawl セッションを削除します。セッションの作成や接続が途中で失敗した場合も同様です。

## Tool

`FirecrawlBrowser` は、`browser_goto`、`browser_snapshot`、`browser_click`、`browser_type`、`browser_screenshot` など、`AgentBrowser` と同じ Tool セットを提供します。完全な一覧と Tool のパラメーターについては、[`AgentBrowser` Tool リファレンス](https://mastra.zisheng.pro/ja/reference/browser/agent-browser)を参照してください。

## 関連項目

- [Firecrawl ドキュメント](https://mastra.zisheng.pro/ja/docs/browser/firecrawl)
- [`AgentBrowser` リファレンス](https://mastra.zisheng.pro/ja/reference/browser/agent-browser)
- [Browser の概要](https://mastra.zisheng.pro/ja/docs/browser/overview)