ロックダウンモード

ロックダウンモードでは、/scrape エンドポイントは Firecrawl の既存のインデックスとキャッシュのみを参照し、対象 URL への外部リクエストは一切行いません。これは、コンプライアンス上の制約がある環境やエアギャップ環境向けに設計されており、スクレイピングリクエスト自体 (URL、ヘッダー、本文) がネットワーク経由で機密情報を漏えいさせるおそれがある場合に適しています。

仕組み

/v2/scrape リクエストで lockdown: true を設定すると、次のように動作します。

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

これを使う場面

適しているケース:

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

避けるべきケース:

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

使用方法

スクレイピングリクエストに lockdown: true を追加します。

from firecrawl import Firecrawl

firecrawl = Firecrawl(
  # 開始にAPI keyは不要 — より高いrate limitsを得るには追加してください:
  # api_key="fc-YOUR_API_KEY",
)

# Serve only previously cached results. No outbound request is made.
# Returns SCRAPE_LOCKDOWN_CACHE_MISS if the URL is not in the cache.
scrape_result = firecrawl.scrape(
    'https://firecrawl.dev',
    formats=['markdown'],
    lockdown=True,
)

print(scrape_result.markdown)

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({
  // 開始にAPI keyは不要です。より高いrate limitsが必要な場合は追加してください:
  // apiKey: "fc-YOUR_API_KEY",
});

// Serve only previously cached results. No outbound request is made.
// Returns SCRAPE_LOCKDOWN_CACHE_MISS if the URL is not in the cache.
const scrapeResult = await firecrawl.scrape('https://firecrawl.dev', {
  formats: ['markdown'],
  lockdown: true,
});

console.log(scrapeResult.markdown);

# 開始にAPI keyは不要です — より高いrate limitsを利用するには -H "Authorization: Bearer fc-YOUR_API_KEY" を追加してください:
curl -X POST https://api.firecrawl.dev/v2/scrape \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://firecrawl.dev",
    "formats": ["markdown"],
    "lockdown": true
  }'

# キャッシュされた結果のみを返します。外部へのリクエストは行われません。
firecrawl https://firecrawl.dev --lockdown

キャッシュミス時のレスポンス

URL がこれまで一度もスクレイピングされておらず、キャッシュも存在しない場合、レスポンスは次のとおりです。

{
  "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."
}

キャッシュを生成するには、まず URL を通常モード (ロックダウン以外) でスクレイピングします。以降のロックダウンリクエストでは、キャッシュ済みの結果が返されます。

課金

結果	クレジット
キャッシュヒット	5クレジット
キャッシュミス (`SCRAPE_LOCKDOWN_CACHE_MISS`)	1クレジット

ロックダウンリクエストでは、ゼロデータ保持に追加料金は発生しません。ロックダウンモードはデフォルトでZDRであるため、ZDRのコストは免除されます。

キャッシュヒットの一致条件

Lockdown では、通常のスクレイピングと同じキャッシュ一致ルールが使われます。キャッシュヒットと判定されるには、次のパラメータがキャッシュ済みエントリと一致している必要があります: url、mobile、location、waitFor、blockAds、screenshot (有効/無効とフルページ) 、および強化プロキシモード。動作はレスポンス内の metadata.cacheState で確認できます。レスポンスがキャッシュから返された場合、この値は "hit" になります。

提供状況

ロックダウンモードは /v2/scrape エンドポイントでサポートされており、これを呼び出すすべての手段で利用できます。

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

crawl、map、extract、search では利用できません。

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

はじめに

主要エンドポイント

その他

クイックスタート

開発者ガイド

webhook

ユースケース

その他

貢献

ロックダウンモード

仕組み

これを使う場面

使用方法

キャッシュミス時のレスポンス

課金

キャッシュヒットの一致条件

提供状況

​仕組み

​これを使う場面

​使用方法

​キャッシュミス時のレスポンス

​課金

​キャッシュヒットの一致条件

​提供状況

仕組み

これを使う場面

使用方法

キャッシュミス時のレスポンス

課金

キャッシュヒットの一致条件

提供状況