Skip to content
Firecrawl Docs
Firecrawl Docs
Interact エンドポイント

Interactセッションの作成

POST/interact

コードで操作できるスタンドアロンのInteractブラウザセッションを開始します(事前のスクレイピングは不要です)。

ヘッダー
AuthorizationBearer <API_KEY>
Content-Typeapplication/json
ParameterTypeRequiredDefaultDescription
ttlnumberNo600セッション全体の有効期間(秒)(30〜3600)
activityTtlnumberNo300セッションが破棄されるまでの非アクティブ状態の継続時間(秒)(10〜3600)
profileobjectNoセッション間での永続的なストレージを有効化します。後述を参照してください。
profile.namestringYes*プロファイルの名前(1〜128文字)。同じ名前のセッションはストレージを共有します。
profile.saveChangesbooleanNotruetrue の場合、ブラウザの状態は終了時にプロファイルへ保存されます。既存データの読み込みのみを行いたい場合は false を設定してください。保存処理を行えるセッションは同時に 1 つだけです。
フィールド説明
successbooleanセッションが作成されたかどうか
idstringセッションの一意の識別子
cdpUrlstringCDP 接続用の WebSocket URL
liveViewUrlstringセッションをリアルタイムで閲覧するための URL
interactiveLiveViewUrlstringセッションをリアルタイムで操作(クリック、入力、スクロール)するための URL
expiresAtstringTTL に基づいてセッションの有効期限が切れる時刻
curl -X POST "https://api.firecrawl.dev/v2/interact" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ttl": 120
  }'
{
  "success": true,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cdpUrl": "wss://cdp-proxy.firecrawl.dev/cdp/550e8400-e29b-41d4-a716-446655440000",
  "liveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000",
  "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000?interactive=true"
}

Firecrawl APIキーが必要なAI agentですか?自動オンボーディング手順については、firecrawl.dev/agent-onboarding/SKILL.md を参照してください。

Was this page helpful?Suggest editsRaise issue