Cómo funciona
Cuando se establecelockdown: true en una solicitud a /v2/scrape:
- Sin tráfico saliente. Firecrawl nunca se conecta a la URL de destino. Todas las vías de salida (motores HTTP, recuperación de robots.txt, escrituras en el índice de búsqueda, transformaciones de audio, etc.) quedan deshabilitadas.
- Lecturas solo desde caché. La solicitud se sirve desde el índice de Firecrawl si existe una entrada coincidente. El valor
maxAgepredeterminado se amplía a 2 años para que las páginas ya almacenadas en caché puedan usarse independientemente de su antigüedad. - Si no hay datos en caché, se devuelve un error. Si no hay datos en caché disponibles, Firecrawl devuelve un
404con el código de errorSCRAPE_LOCKDOWN_CACHE_MISS. La URL nunca se registra si no hay coincidencia en caché. - Retención de datos cero. Las solicitudes con lockdown se tratan como ZDR: no se conserva ninguna URL, no se escribe ningún blob de respuesta en el almacenamiento a largo plazo y el trabajo de scraping se elimina después de la entrega.
Cuándo usar esto
Ideal para:- Sectores regulados (salud, finanzas, jurídico) donde las solicitudes salientes requieren auditoría o aprobación
- Entornos aislados de la red o con restricciones de cumplimiento donde la propia URL es sensible
- Reproducir páginas ya indexadas sin volver a consultar los orígenes
- Contenido nuevo que nunca se haya extraído antes — el modo de bloqueo devuelve un error si no hay coincidencia en caché
- Datos en tiempo real o sensibles al factor tiempo
Uso
Añadelockdown: true a tu solicitud de scraping.
Respuesta ante un fallo de caché
Si la URL no se ha extraído ni almacenado en caché previamente, la respuesta es:Facturación
La retención de datos cero no implica un cargo adicional para las solicitudes de lockdown: el costo de ZDR no se cobra porque el modo de bloqueo ya es ZDR de forma predeterminada.
Coincidencia de caché
Lockdown usa las mismas reglas de coincidencia de caché que los scrapes normales. Para que haya un acierto de caché, estos parámetros deben coincidir con la entrada en caché:url, mobile, location, waitFor, blockAds, screenshot (habilitada/deshabilitada y de página completa) y el modo de proxy mejorado. Puedes verificar este comportamiento mediante metadata.cacheState en la respuesta: será "hit" en una respuesta entregada.
Disponibilidad
El modo de bloqueo es compatible con el endpoint/v2/scrape y está expuesto en todas las superficies que lo invocan:
- SDKs — Python, Node.js, Go, Rust, Java, .NET, Ruby, PHP y Elixir (
lockdown: trueen las opciones de scraping). - CLI — pasa
--lockdownafirecrawl scrape. - MCP Server — incluye
"lockdown": trueen los argumentos de la herramientafirecrawl_scrape.
crawl, map, extract ni search.
¿Eres un agente de IA y necesitas una clave de API de Firecrawl? Consulta firecrawl.dev/agent-onboarding/SKILL.md para obtener instrucciones de incorporación automatizadas.

