Migração da v1 para a v2

• Mais rápido por padrão: As requisições são armazenadas em cache com maxAge definido para 2 dias, e padrões sensatos como blockAds, skipTlsVerification e removeBase64Images vêm habilitados.
• Novo formato de resumo: Agora você pode especificar "summary" como um formato para receber diretamente um resumo conciso do conteúdo da página.
• Extração JSON atualizada: A extração JSON e o rastreamento de alterações agora usam um formato de objeto: { type: "json", prompt, schema }. O antigo formato "extract" foi renomeado para "json".
• Opções de captura de tela aprimoradas: Use o formato de objeto: { type: "screenshot", fullPage, quality, viewport }.
• Novas fontes de pesquisa: Pesquise em "news" e "images", além dos resultados da web, definindo o parâmetro sources.
• Rastreamento inteligente com prompts: Forneça um prompt em linguagem natural para o crawl e o sistema derivará caminhos/limites automaticamente. Use o novo endpoint /crawl/params-preview para inspecionar as opções derivadas antes de iniciar um job.

• Substitua o uso do cliente v1 pelos clientes v2:
  • JS: const firecrawl = new Firecrawl({ apiKey: 'fc-YOUR-API-KEY' })
  • Python: firecrawl = Firecrawl(api_key='fc-YOUR-API-KEY')
  • API: use os novos endpoints em https://api.firecrawl.dev/v2/.
• Atualize os formatos:
  • Use “summary” quando necessário
  • modo JSON: use { type: "json", prompt, schema } para extração em JSON
  • Screenshot e Screenshot@fullPage: use o formato de objeto de screenshot ao especificar opções
• Adote fluxos assíncronos padronizados nos SDKs:
  • Crawls: startCrawl + getCrawlStatus (ou o waiter crawl)
  • Batch: startBatchScrape + getBatchScrapeStatus (ou o waiter batchScrape)
  • Extract: startExtract + getExtractStatus (ou o waiter extract)
• Mapeamento de opções de crawl (veja abaixo)
• Verifique o prompt do crawl com /crawl/params-preview

​

Mudanças nos nomes dos métodos (migração v1 → v2)

• AsyncFirecrawl oferece os mesmos métodos (todos aguardáveis).

• Use formatos de string para o básico: "markdown", "html", "rawHtml", "links", "summary", "images".
• Em vez de parsePDF, use parsers: [ { "type": "pdf" } | "pdf" ].
• Use formatos de objeto para JSON, controle de alterações e capturas de tela:

const formats = [ {
  "type": "json",
  "prompt": "Extraia a missão da empresa presente na página."
}];

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

formats = [ { "type": "json", "prompt": "Extraia a missão da empresa presente na 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": "Extraia a missão da empresa presente na página."
      }]
    }'

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

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

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

# Formato de captura de tela (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', 'Extrair docs e 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='Extrair docs e 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": "Extrair docs e blog"
    }'