> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# スクレイピングしたページを操作する
> スクレイピングジョブに紐付けられたブラウザセッションで、コードまたは AI プロンプトを実行します。
このエンドポイントを使用すると、以前のスクレイピングから初期化されたのと同じブラウザ状態で、引き続き操作できます。`code` または `prompt` のいずれか一方を指定する必要があります。両方は指定できません。
`POST /v2/scrape/{jobId}/interact` はライフサイクル全体を処理します。
1. このスクレイピングジョブ用のブラウザセッションがまだ存在しない場合、Firecrawl は元のスクレイピングと同じページ状態でブラウザセッションを作成します。
2. `code` が指定されている場合、Firecrawl はそれをブラウザサンドボックスで実行します。`prompt` が指定されている場合は、AI エージェントが自然言語を使ってタスクを自動化します。
3. 同じ `jobId` に対する後続の `POST /interact` 呼び出しでは、同じライブのブラウザ状態が再利用されます。
完了したら、`DELETE /v2/scrape/{jobId}/interact` を呼び出してセッションを停止します。
## パスパラメータ
| パラメータ | 型 | 必須 | 説明 |
| ------- | ------------- | -- | ----------------------------------------------------------- |
| `jobId` | string (UUID) | はい | スクレイピングのレスポンス内の `data.metadata.scrapeId` に含まれるスクレイピングジョブ ID |
## リクエストボディ
| パラメータ | 型 | 必須 | デフォルト | 説明 |
| ---------- | ------ | --- | -------- | ------------------------------------------------------------ |
| `code` | string | いいえ | — | ブラウザサンドボックスで実行するコード (1～100,000文字) 。`prompt`が設定されていない場合は必須です。 |
| `prompt` | string | いいえ | — | AIエージェント向けの自然言語タスク (1～10,000文字) 。`code`が設定されていない場合は必須です。 |
| `language` | string | いいえ | `"node"` | `"python"`、`"node"`、`"bash"` のいずれか。`code`を使用する場合にのみ使われます。 |
| `timeout` | number | いいえ | `30` | 実行タイムアウト (秒) (1～300) 。 |
| `origin` | string | いいえ | — | テレメトリに使用される任意のオリジンラベル。 |
## レスポンス
| フィールド | 型 | 説明 |
| ------------------------ | ------- | ------------------------------------------------------------------------------------------------------------ |
| `success` | boolean | 実行がエラーなく完了したかどうか |
| `cdpUrl` | string | ブラウザセッション用の Chrome DevTools Protocol (CDP) の生の WebSocket URL。Playwright、Puppeteer、または任意の CDP クライアントで直接接続できます |
| `liveViewUrl` | string | ブラウザセッション用の読み取り専用ライブビューURL |
| `interactiveLiveViewUrl` | string | インタラクティブ ライブビューURL (閲覧者がブラウザを操作可能) |
| `output` | string | AIエージェントの最終レスポンス (`prompt` を使用した場合のみ存在) |
| `stdout` | string | コード実行の標準出力 |
| `result` | string | 戻り値 — Node.js では最後の式の値、`prompt` では最終ページのスナップショット |
| `stderr` | string | 標準エラー出力 |
| `exitCode` | number | 実行の終了コード (`0` = 成功) |
| `killed` | boolean | タイムアウトにより実行が終了したかどうか |
| `error` | string | エラーメッセージ (失敗時のみ存在) |
### リクエスト例 (コード)
```bash theme={null}
curl -X POST "https://api.firecrawl.dev/v2/scrape/550e8400-e29b-41d4-a716-446655440000/interact" \
-H "Authorization: Bearer $FIRECRAWL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"code": "const title = await page.title(); JSON.stringify({ title });",
"language": "node",
"timeout": 30
}'
```
### レスポンス例 (コード)
```json theme={null}
{
"success": true,
"cdpUrl": "wss://browser.firecrawl.dev/...",
"liveViewUrl": "https://liveview.firecrawl.dev/...",
"interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...",
"stdout": "",
"result": "{\"title\":\"Example Domain\"}",
"stderr": "",
"exitCode": 0,
"killed": false
}
```
### リクエスト例 (Prompt)
```bash theme={null}
curl -X POST "https://api.firecrawl.dev/v2/scrape/550e8400-e29b-41d4-a716-446655440000/interact" \
-H "Authorization: Bearer $FIRECRAWL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Find the pricing section and tell me the price of the Pro plan",
"timeout": 60
}'
```
### レスポンス例 (Prompt)
```json theme={null}
{
"success": true,
"cdpUrl": "wss://browser.firecrawl.dev/...",
"liveViewUrl": "https://liveview.firecrawl.dev/...",
"interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...",
"output": "The Pro plan costs $49/month and includes unlimited scrapes, priority support, and custom integrations.",
"stdout": "...",
"result": "...",
"stderr": "",
"exitCode": 0,
"killed": false
}
```
### エラーコード
| ステータス | 説明 |
| ----- | --------------------------------------------- |
| `402` | ブラウザセッションのクレジットが不足しています |
| `403` | スクレイピングジョブは別のチームに属しています |
| `404` | スクレイピングジョブが見つかりません |
| `409` | リプレイコンテキストを利用できません — スクレイピングを再実行してもう一度お試しください |
| `410` | ブラウザセッションはすでに破棄されています |
| `429` | 同時ブラウザセッション数の上限に達しました |
| `502` | ブラウザサービスまたはAIエージェントの実行に失敗しました |
| `503` | ブラウザ機能が設定されていません (セルフホスト環境のみ) |
詳細な使用方法と例については、[Interact機能ガイド](/ja/features/interact)を参照してください。
## OpenAPI
````yaml ja/api-reference/v2-openapi.json POST /scrape/{jobId}/interact
openapi: 3.0.0
info:
contact:
email: support@firecrawl.dev
name: Firecrawl Support
url: https://firecrawl.dev/support
description: Firecrawlのサービスを利用して、Webスクレイピングやクロールを行うためのAPIです。
title: Firecrawl API
version: v2
servers:
- url: https://api.firecrawl.dev/v2
security:
- bearerAuth: []
paths:
/scrape/{jobId}/interact:
post:
tags:
- Scraping
summary: スクレイピングジョブに関連付けられたブラウザセッションを操作します
operationId: interactWithScrapeBrowserSession
parameters:
- description: スクレイピングジョブの job ID
in: path
name: jobId
required: true
schema:
format: uuid
type: string
requestBody:
content:
application/json:
schema:
properties:
code:
description: スクレイピングに紐付けられたブラウザサンドボックスで実行するコード
maxLength: 100000
minLength: 1
type: string
language:
default: node
description: >-
実行するコードの言語。JavaScript には `node`、agent-browser の CLI コマンドには
`bash` を使用します。
enum:
- python
- node
- bash
type: string
origin:
description: 実行テレメトリーで使用する任意のオリジンラベル
type: string
timeout:
default: 30
description: 実行タイムアウト（秒）
maximum: 300
minimum: 1
type: integer
required:
- code
type: object
required: true
responses:
'200':
content:
application/json:
schema:
properties:
cdpUrl:
description: >-
ブラウザセッション用の生の Chrome DevTools Protocol（CDP）WebSocket
URL。これを使用して、Playwright、Puppeteer、または任意の CDP
クライアントから直接接続できます。
nullable: true
type: string
error:
description: コードで例外が発生した場合のエラーメッセージ
nullable: true
type: string
exitCode:
description: 実行されたプロセスの終了コード
nullable: true
type: integer
interactiveLiveViewUrl:
description: インタラクティブ ライブビュー URL（閲覧者がブラウザを操作できます）
nullable: true
type: string
killed:
description: タイムアウトによりプロセスが強制終了されたかどうか
type: boolean
liveViewUrl:
description: ブラウザセッション用の読み取り専用ライブビュー URL
nullable: true
type: string
output:
description: AI agent の最終レスポンス（prompt を使用した場合にのみ含まれます）
nullable: true
type: string
result:
description: 標準出力（stdout の別名）
nullable: true
type: string
stderr:
description: コード実行時の標準エラー出力
nullable: true
type: string
stdout:
description: コード実行時の標準出力
nullable: true
type: string
success:
type: boolean
type: object
description: コードは正常に実行されました
'400':
content:
application/json:
schema:
properties:
error:
example: Invalid job ID format.
type: string
success:
example: false
type: boolean
type: object
description: 無効な job ID
'402':
content:
application/json:
schema:
properties:
error:
example: Payment required to access this resource.
type: string
success:
example: false
type: boolean
type: object
description: 支払いが必要です
'403':
content:
application/json:
schema:
properties:
error:
example: Forbidden.
type: string
success:
example: false
type: boolean
type: object
description: アクセスが拒否されました
'404':
content:
application/json:
schema:
properties:
error:
example: Job not found.
type: string
success:
example: false
type: boolean
type: object
description: スクレイピングジョブが見つかりません
'409':
content:
application/json:
schema:
properties:
error:
example: >-
Replay context is unavailable for this scrape job. Please
rerun the scrape.
type: string
success:
example: false
type: boolean
type: object
description: スクレイピングのリプレイコンテキストを利用できないか、セッションを初期化できませんでした
'410':
content:
application/json:
schema:
properties:
error:
example: Browser session has been destroyed.
type: string
success:
example: false
type: boolean
type: object
description: スクレイピングのブラウザセッションはすでに破棄されています
'429':
content:
application/json:
schema:
properties:
error:
example: >-
You have reached the maximum number of active browser
sessions.
type: string
success:
example: false
type: boolean
type: object
description: アクティブなブラウザセッションが多すぎます
'502':
content:
application/json:
schema:
properties:
error:
example: Failed to execute code in browser session.
type: string
success:
example: false
type: boolean
type: object
description: ブラウザサービスとの通信に失敗しました
security:
- bearerAuth: []
components:
securitySchemes:
bearerAuth:
scheme: bearer
type: http
````