O que o /agent da Firecrawl faz
/agent é um endpoint da API da Firecrawl (POST https://api.firecrawl.dev/v2/agent) que a Firecrawl descreve como pesquisa aprofundada para dados. Você envia um prompt (até 10.000 caracteres) descrevendo o que precisa, como uma lista de empresas com fundadores e sites, e o agente pesquisa na web, navega pelos sites, lida com páginas em JavaScript, paginação e rolagem infinita, e retorna JSON. Você pode passar um esquema JSON (Pydantic em Python, Zod em Node) para obter uma saída tipada, e uma lista opcional de urls para direcionar a execução; strictConstrainToURLs a mantém somente nessas páginas. A Firecrawl afirma que o /agent substitui o endpoint /extract mais antigo, que está sendo descontinuado, e que, para uma única URL conhecida, o modo JSON do /scrape é mais barato.
Todas as execuções agora usam o modelo Spark 2 da Firecrawl (os nomes anteriores Spark 1 Mini e Pro ainda funcionam, mas são encaminhados para o Spark 2), com uma configuração opcional de effort baixo, médio ou alto. Os jobs são executados de forma assíncrona: você consulta o status pelo ID do job ou recebe webhooks, os resultados permanecem disponíveis pela API por 24 horas, e um ID de thread permite enviar prompts de acompanhamento que continuam uma execução. Outras opções incluem um country de proxy para toda a execução, filtragem SafeSearch, Zero Data Retention (cobrado a 2x) e acesso a provedores de dados pagos Alexandria com uma etapa de aprovação. Você pode testá-lo sem código no playground em firecrawl.dev/agent, ou chamá-lo pelos SDKs de Python e Node, pela CLI e pelo servidor MCP da Firecrawl. O Parallel Agents executa em lote centenas ou milhares de consultas do /agent em uma grade no estilo de planilha.
