Raspagem mais rápida

O Firecrawl mantém em cache páginas já raspadas e, por padrão, retorna uma cópia recente quando disponível.

• Frescura padrão: maxAge = 172800000 ms (2 dias). Se a cópia em cache for mais recente que isso, ela é retornada instantaneamente; caso contrário, o Firecrawl faz uma nova raspagem e atualiza o cache.
• Forçar conteúdo novo: Defina maxAge: 0 para sempre raspar. Esteja ciente de que isso ignora completamente o cache, o que significa que toda requisição passa por todo o pipeline de raspagem, fazendo com que a requisição leve mais tempo para ser concluída e seja mais propensa a falhas. Use um maxAge diferente de zero se você não precisar de conteúdo em tempo real em toda requisição.
• Pular cache: Defina storeInCache: false se você não quiser armazenar os resultados de uma requisição.

Obtenha seus resultados até 500% mais rápido quando você não precisar dos dados absolutamente mais atuais. Controle a frescura via maxAge:

1. Retorno instantâneo se tivermos uma versão recente da página
2. Raspar novamente apenas se nossa versão for mais antiga do que a idade especificada por você
3. Economize tempo — os resultados chegam em milissegundos em vez de segundos

Ideal para:

• Documentação, artigos, páginas de produto
• Processamento em lote
• Desenvolvimento e testes
• Criação de bases de conhecimento

Evite se precisar de:

• Dados em tempo real (cotações, placares ao vivo, notícias de última hora)
• Conteúdo atualizado com frequência
• Aplicativos sensíveis ao tempo

Adicione maxAge à sua solicitação de scrape. Os valores são em milissegundos (por exemplo, 3600000 = 1 hora).

Aqui estão alguns valores de referência úteis:

• 5 minutos: 300000 - Para conteúdo semidinâmico
• 1 hora: 3600000 - Para conteúdo que é atualizado a cada hora
• 1 dia: 86400000 - Para conteúdo atualizado diariamente
• 1 semana: 604800000 - Para conteúdo relativamente estático

Com maxAge ativado:

• Tempos de resposta 500% mais rápidos para conteúdo recente
• Resultados instantâneos em vez de aguardar novas coletas

• Padrão: maxAge é 172800000 (2 dias)
• Atual quando necessário: Se nossos dados forem mais antigos que maxAge, fazemos uma nova coleta automaticamente
• Sem dados desatualizados: Você nunca receberá dados mais antigos do que o maxAge especificado
• Créditos: Resultados em cache ainda consomem 1 crédito por página. O cache melhora a velocidade e a latência, não o consumo de créditos.

O cache é automaticamente ignorado quando sua requisição inclui qualquer um dos seguintes itens:

• headers personalizados
• actions (etapas de automação do navegador)
• Um profile de navegador
• Formato changeTracking
• Configurações personalizadas de viewport ou de qualidade da screenshot

Para que haja um acerto de cache, estes parâmetros devem corresponder exatamente entre as requisições original e subsequentes: url, mobile, location, waitFor, blockAds, screenshot (captura de tela ativada/desativada e de página inteira) e o modo de proxy aprimorado.

Você pode verificar o comportamento do cache consultando metadata.cacheState na resposta — será "hit" ou "miss".

Os mesmos ganhos de velocidade se aplicam ao rastrear várias páginas. Use maxAge em scrapeOptions para obter resultados em cache de páginas que vimos recentemente.

Ao rastrear com maxAge, cada página do seu rastreamento aproveitará a melhoria de velocidade de 500% se tivermos dados recentes em cache para essa página.

Comece a usar maxAge hoje para fazer scraping e rastreamentos muito mais rápidos!

Você é um agente de IA e precisa de uma chave de API do Firecrawl? Consulte firecrawl.dev/agent-onboarding/SKILL.md para ver instruções automatizadas de onboarding.