Skip to main content
POST
スクレイピングジョブに関連付けられたブラウザセッションを操作します
このエンドポイントを使用すると、以前のスクレイピングから初期化されたのと同じブラウザ状態で、引き続き操作できます。code または prompt のいずれか一方を指定する必要があります。両方は指定できません。 POST /v2/scrape/{jobId}/interact はライフサイクル全体を処理します。
  1. このスクレイピングジョブ用のブラウザセッションがまだ存在しない場合、Firecrawl は元のスクレイピングと同じページ状態でブラウザセッションを作成します。
  2. code が指定されている場合、Firecrawl はそれをブラウザサンドボックスで実行します。prompt が指定されている場合は、AI エージェントが自然言語を使ってタスクを自動化します。
  3. 同じ jobId に対する後続の POST /interact 呼び出しでは、同じライブのブラウザ状態が再利用されます。
完了したら、DELETE /v2/scrape/{jobId}/interact を呼び出してセッションを停止します。

パスパラメータ

リクエストボディ

レスポンス

リクエスト例 (コード)

レスポンス例 (コード)

リクエスト例 (Prompt)

レスポンス例 (Prompt)

エラーコード

詳細な使用方法と例については、Interact機能ガイドを参照してください。

承認

Authorization
string
header
必須

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

パスパラメータ

jobId
string<uuid>
必須

スクレイピングジョブの job ID

ボディ

application/json
code
string
必須

スクレイピングに紐付けられたブラウザサンドボックスで実行するコード

Required string length: 1 - 100000
language
enum<string>
デフォルト:node

実行するコードの言語。JavaScript には node、agent-browser の CLI コマンドには bash を使用します。

利用可能なオプション:
python,
node,
bash
origin
string

実行テレメトリーで使用する任意のオリジンラベル

timeout
integer
デフォルト:30

実行タイムアウト(秒)

必須範囲: 1 <= x <= 300

レスポンス

コードは正常に実行されました

cdpUrl
string | null

ブラウザセッション用の生の Chrome DevTools Protocol(CDP)WebSocket URL。これを使用して、Playwright、Puppeteer、または任意の CDP クライアントから直接接続できます。

error
string | null

コードで例外が発生した場合のエラーメッセージ

exitCode
integer | null

実行されたプロセスの終了コード

interactiveLiveViewUrl
string | null

インタラクティブ ライブビュー URL(閲覧者がブラウザを操作できます)

killed
boolean

タイムアウトによりプロセスが強制終了されたかどうか

liveViewUrl
string | null

ブラウザセッション用の読み取り専用ライブビュー URL

output
string | null

AI agent の最終レスポンス(prompt を使用した場合にのみ含まれます)

result
string | null

標準出力(stdout の別名)

stderr
string | null

コード実行時の標準エラー出力

stdout
string | null

コード実行時の標準出力

success
boolean