ロックダウンモード

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.

• 外部への通信は行われません。 Firecrawl は対象 URL に一切接続しません。外部に出る経路 (HTTP エンジン、robots.txt の取得、検索インデックスへの書き込み、音声変換など) はすべて無効化されます。
• キャッシュのみを参照します。 一致するエントリが存在する場合、リクエストは Firecrawl のインデックスから処理されます。デフォルトの maxAge は 2 年に引き上げられるため、既存のキャッシュ済みページは経過時間にかかわらず利用対象になります。
• キャッシュミス時はエラーを返します。 利用可能なキャッシュデータがない場合、Firecrawl はエラーコード SCRAPE_LOCKDOWN_CACHE_MISS を付けて 404 を返します。キャッシュミス時も URL が記録されることはありません。
• ゼロデータ保持。 Lockdown リクエストは ZDR として扱われます。URL は永続化されず、レスポンス blob は長期ストレージに書き込まれず、スクレイピングジョブは配信後にクリーンアップされます。

• 外部へのリクエストに監査や承認が必要な、規制の厳しい業界 (医療、金融、法務)
• URL自体が機微情報にあたる、エアギャップ環境やコンプライアンス上の制約がある環境
• originに再アクセスせずに、すでにインデックス済みのページを再利用する場合

• これまで一度もスクレイピングされたことのない新規コンテンツ — ロックダウンモードでは、キャッシュミス時にエラーが返されます
• リアルタイムデータや時間に敏感なデータ

from firecrawl import Firecrawl

firecrawl = Firecrawl(api_key="fc-YOUR_API_KEY")

# キャッシュされた結果のみを返す。外部へのリクエストは行われない。
# URLがキャッシュに存在しない場合は SCRAPE_LOCKDOWN_CACHE_MISS を返す。
scrape_result = firecrawl.scrape(
    'https://firecrawl.dev',
    formats=['markdown'],
    lockdown=True,
)

print(scrape_result.markdown)

{
  "success": false,
  "code": "SCRAPE_LOCKDOWN_CACHE_MISS",
  "error": "No cached data is available for this request in lockdown mode. Lockdown mode only serves previously cached responses and never makes outbound requests. To resolve this, either disable lockdown mode to allow a fresh scrape, or try again after the URL has been scraped and cached."
}

• SDKs — Python、Node.js、Go、Rust、Java、.NET、Ruby、PHP、Elixir (スクレイピングのオプションで lockdown: true を指定) 。
• CLI — firecrawl scrape に --lockdown を渡します。
• MCP server — firecrawl_scrape ツールの引数に "lockdown": true を含めます。

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