Comment cela fonctionne
Lorsquelockdown: true est défini sur une requête /v2/scrape :
- Aucun trafic sortant. Firecrawl ne se connecte jamais à l’URL cible. Toutes les voies de sortie (moteurs HTTP, récupération de robots.txt, écritures dans l’index de recherche, transformations audio, etc.) sont bloquées.
- Lecture depuis le cache uniquement. La requête est traitée à partir de l’index de Firecrawl si une entrée correspondante existe. La valeur
maxAgepar défaut est portée à 2 ans afin que les pages déjà mises en cache restent éligibles, quel que soit leur âge. - En cas de défaut de cache, une erreur est renvoyée. Si aucune donnée en cache n’est disponible, Firecrawl renvoie une
404avec le code d’erreurSCRAPE_LOCKDOWN_CACHE_MISS. En cas de défaut de cache, l’URL n’est jamais consignée dans les journaux. - Aucune conservation des données. Les requêtes Lockdown sont traitées comme du ZDR : aucune URL n’est conservée, aucun blob de réponse n’est écrit dans le stockage à long terme, et la tâche de scraping est supprimée après livraison.
Quand l’utiliser
Idéal pour :- Les secteurs réglementés (santé, finance, juridique) où les requêtes sortantes nécessitent un audit ou une approbation
- Les environnements isolés du réseau ou soumis à des contraintes de conformité, où l’URL elle-même est sensible
- Rejouer des pages déjà indexées sans réinterroger les sources d’origine
- Du contenu récent qui n’a jamais fait l’objet d’un scraping auparavant — le mode lockdown renvoie une erreur en cas de défaut de cache
- Les données en temps réel ou sensibles au facteur temps
Utilisation
Ajoutezlockdown: true à votre requête de scraping.
Réponse en cas de défaut de cache
Si l’URL n’a pas encore fait l’objet d’un scraping ni été mise en cache, la réponse est :Facturation
Aucune conservation des données n’entraîne pas de frais supplémentaires pour les requêtes lockdown — le coût du ZDR n’est pas facturé, car le mode lockdown est déjà en ZDR par défaut.
Correspondance des hits du cache
Lockdown utilise les mêmes règles de correspondance du cache que les scrapings classiques. Pour obtenir un hit du cache, les paramètres suivants doivent correspondre à l’entrée en cache :url, mobile, location, waitFor, blockAds, screenshot (activé/désactivé et pleine page), ainsi que le mode proxy avancé. Vous pouvez vérifier ce comportement via metadata.cacheState dans la réponse : sa valeur sera "hit" lorsqu’une réponse est servie depuis le cache.
Disponibilité
Le mode lockdown est pris en charge sur le point de terminaison/v2/scrape et est disponible sur toutes les interfaces qui l’utilisent :
- SDKs — Python, Node.js, Go, Rust, Java, .NET, Ruby, PHP et Elixir (
lockdown: truedans les options de scraping). - CLI — passez
--lockdownàfirecrawl scrape. - serveur MCP — incluez
"lockdown": truedans les arguments de l’outilfirecrawl_scrape.
crawl, map, extract ou search.
Vous êtes un agent IA et avez besoin d’une clé API Firecrawl ? Consultez firecrawl.dev/agent-onboarding/SKILL.md pour les instructions d’intégration automatisée.

