スクレイピングしたページを操作する
スクレイピングジョブに紐付けられたブラウザセッションで、コードまたは AI プロンプトを実行します。
code または prompt のいずれか一方を指定する必要があります。両方は指定できません。
POST /v2/scrape/{jobId}/interact はライフサイクル全体を処理します。
- このスクレイピングジョブ用のブラウザセッションがまだ存在しない場合、Firecrawl は元のスクレイピングと同じページ状態でブラウザセッションを作成します。
codeが指定されている場合、Firecrawl はそれをブラウザサンドボックスで実行します。promptが指定されている場合は、AI エージェントが自然言語を使ってタスクを自動化します。- 同じ
jobIdに対する後続のPOST /interact呼び出しでは、同じライブのブラウザ状態が再利用されます。
DELETE /v2/scrape/{jobId}/interact を呼び出してセッションを停止します。
パスパラメータ
リクエストボディ
レスポンス
リクエスト例 (コード)
レスポンス例 (コード)
リクエスト例 (Prompt)
レスポンス例 (Prompt)
エラーコード
承認
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
パスパラメータ
スクレイピングジョブの job ID
ボディ
スクレイピングに紐付けられたブラウザサンドボックスで実行するコード
1 - 100000実行するコードの言語。JavaScript には node、agent-browser の CLI コマンドには bash を使用します。
python, node, bash 実行テレメトリーで使用する任意のオリジンラベル
実行タイムアウト(秒)
1 <= x <= 300レスポンス
コードは正常に実行されました
ブラウザセッション用の生の Chrome DevTools Protocol(CDP)WebSocket URL。これを使用して、Playwright、Puppeteer、または任意の CDP クライアントから直接接続できます。
コードで例外が発生した場合のエラーメッセージ
実行されたプロセスの終了コード
インタラクティブ ライブビュー URL(閲覧者がブラウザを操作できます)
タイムアウトによりプロセスが強制終了されたかどうか
ブラウザセッション用の読み取り専用ライブビュー URL
AI agent の最終レスポンス(prompt を使用した場合にのみ含まれます)
標準出力(stdout の別名)
コード実行時の標準エラー出力
コード実行時の標準出力

