Migración de v1 a v2

• Más rápido de forma predeterminada: Las solicitudes se almacenan en caché con maxAge establecido por defecto en 2 días, y están habilitados valores predeterminados sensatos como blockAds, skipTlsVerification y removeBase64Images.
• Nuevo formato de resumen: Ahora puedes especificar "summary" como formato para recibir directamente un resumen conciso del contenido de la página.
• Extracción JSON actualizada: La extracción en JSON y el seguimiento de cambios ahora usan un formato de objeto: { type: "json", prompt, schema }. El antiguo formato "extract" pasó a llamarse "json".
• Opciones de captura de pantalla mejoradas: Usa el formato de objeto: { type: "screenshot", fullPage, quality, viewport }.
• Nuevas fuentes de búsqueda: Busca en "news" e "images", además de los resultados web, configurando el parámetro sources.
• Rastreo inteligente con prompts: Pasa un prompt en lenguaje natural para el rastreo y el sistema derivará rutas y límites automáticamente. Usa el nuevo punto de conexión /crawl/params-preview para inspeccionar las opciones derivadas antes de iniciar un trabajo.

• Reemplaza el uso del cliente v1 por los clientes v2:
  • JS: const firecrawl = new Firecrawl({ apiKey: 'fc-YOUR-API-KEY' })
  • Python: firecrawl = Firecrawl(api_key='fc-YOUR-API-KEY')
  • API: usa los nuevos puntos de conexión https://api.firecrawl.dev/v2/.
• Actualiza los formatos:
  • Usa "summary" cuando sea necesario
  • modo JSON: usa { type: "json", prompt, schema } para la extracción en modo JSON
  • Screenshot y Screenshot@fullPage: usa el formato de objeto de captura de pantalla al especificar opciones
• Adopta flujos asíncronos estandarizados en los SDK:
  • Crawls: startCrawl + getCrawlStatus (o el “waiter” crawl)
  • Batch: startBatchScrape + getBatchScrapeStatus (o el “waiter” batchScrape)
  • Extract: startExtract + getExtractStatus (o el “waiter” extract)
• Mapeo de opciones de crawl (ver abajo)
• Verifica el prompt de crawl con /crawl/params-preview

​

Cambios en los nombres de métodos (migración v1 → v2)

• AsyncFirecrawl ofrece los mismos métodos (todos awaitable).

• Usa formatos de texto para lo básico: "markdown", "html", "rawHtml", "links", "summary", "images".
• En lugar de parsePDF, usa parsers: [ { "type": "pdf" } | "pdf" ].
• Usa formatos de objeto para JSON, seguimiento de cambios y capturas de pantalla:

const formats = [ {
  "type": "json",
  "prompt": "Extrae la misión de la empresa de la página."
}];

doc = firecrawl.scrape(url, { formats });

formats = [ { "type": "json", "prompt": "Extrae la misión de la empresa de la página." } ];

doc = firecrawl.scrape(url, formats=formats);

curl -X POST https://api.firecrawl.dev/v2/scrape \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -d '{
      "url": "https://docs.firecrawl.dev/",
      "formats": [{
        "type": "json",
        "prompt": "Extrae la misión de la empresa de la página."
      }]
    }'

// Formato de captura de pantalla (JS)
const formats = [ { "type": "screenshot", "fullPage": true, "quality": 80, "viewport": { "width": 1280, "height": 800 } } ];

doc = firecrawl.scrape(url, { formats });

# Formato de captura de pantalla (Python)
formats = [ { "type": "screenshot", "fullPage": true, "quality": 80, "viewport": { "width": 1280, "height": 800 } } ];
doc = firecrawl.scrape(url, formats=formats);

# Formato de captura de pantalla (cURL)
curl -X POST https://api.firecrawl.dev/v2/scrape \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -d '{
      "url": "https://docs.firecrawl.dev/",
      "formats": [{
        "type": "screenshot",
        "fullPage": true,
        "quality": 80,
        "viewport": { "width": 1280, "height": 800 }
      }]
    }'

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

const params = await firecrawl.crawlParamsPreview('https://docs.firecrawl.dev', 'Extract docs and blog');
console.log(params);

from firecrawl import Firecrawl

firecrawl = Firecrawl(api_key='fc-YOUR-API-KEY')
preview = firecrawl.crawl_params_preview(url='https://docs.firecrawl.dev', prompt='Extract docs and blog')
print(preview)

curl -X POST https://api.firecrawl.dev/v2/crawl/params-preview \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -d '{
      "url": "https://docs.firecrawl.dev",
      "prompt": "Extract docs and blog"
    }'