メインコンテンツへ移動

FirecrawlBrowser クラス

FirecrawlBrowser クラスは、Firecrawl Browser Sandbox を利用したブラウザー自動化を提供します。Firecrawl API を通じてリモートブラウザーセッションをプロビジョニングし、Chrome DevTools Protocol（CDP）経由で接続します。

FirecrawlBrowser は AgentBrowser を拡張し、同じ決定論的な Tool セットを公開します。ローカルに Chromium をインストールせず、ホストされたブラウザーセッションを使用する場合に利用してください。ローカルでの自動化については AgentBrowser を参照してください。自然言語を使用した AI による操作については StagehandBrowser を参照してください。

使用例
使用例への直接リンク

src/mastra/agents/index.ts
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 コンストラクターのパラメーターに加えて、次のパラメーターを受け取ります。

apiKey?:

string
Firecrawl API キー。指定されていない場合は FIRECRAWL_API_KEY 環境変数を使用します。どちらも設定されていない場合、コンストラクターは例外をスローします。

apiUrl?:

string
セルフホスト型 Firecrawl API のベース URL。

firecrawl?:

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

ttl?:

number
セッションの最大有効期間（秒）。

activityTtl?:

number
Sandbox がセッションを再利用するまでのアイドルタイムアウト（秒）。

streamWebView?:

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

profile?:

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

integration?:

string
Firecrawl の分析とルーティングに使用する統合ラベル。

origin?:

string
Firecrawl ブラウザーセッションに渡すオリジンのヒント。

セッションのライフサイクル
セッションのライフサイクルへの直接リンク

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

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

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

Tool
Toolへの直接リンク

FirecrawlBrowser は、browser_goto、browser_snapshot、browser_click、browser_type、browser_screenshot など、AgentBrowser と同じ Tool セットを提供します。完全な一覧と Tool のパラメーターについては、AgentBrowser Tool リファレンスを参照してください。

On this page