Qué hace /agent de Firecrawl
/agent es un endpoint de la API de Firecrawl (POST https://api.firecrawl.dev/v2/agent) que Firecrawl describe como investigación profunda para datos. Usted envía un prompt (de hasta 10.000 caracteres) que describe lo que necesita, por ejemplo una lista de empresas con sus fundadores y sitios web, y el agente busca en la web, navega por los sitios, gestiona páginas con JavaScript, paginación y desplazamiento infinito, y devuelve JSON. Puede pasar un esquema JSON (Pydantic en Python, Zod en Node) para obtener una salida tipada, y una lista opcional de urls para enfocar la ejecución; strictConstrainToURLs la limita únicamente a esas páginas. Firecrawl indica que /agent reemplaza a su anterior endpoint /extract, que está dejando de usar, y que para una única URL conocida su modo JSON en /scrape es más económico.
Cada ejecución utiliza ahora el modelo Spark 2 de Firecrawl (los nombres anteriores Spark 1 Mini y Pro siguen funcionando, pero se redirigen a Spark 2), con un ajuste opcional effort de low, medium o high. Los trabajos se ejecutan de forma asíncrona: se consulta el estado por ID de trabajo o se reciben webhooks, los resultados permanecen disponibles a través de la API durante 24 horas, y un ID de hilo permite enviar prompts de seguimiento que continúan una ejecución. Otras opciones incluyen un country de proxy para toda la ejecución, filtrado SafeSearch, Zero Data Retention (facturado al doble, 2x) y acceso a proveedores de datos de pago de Alexandria con un paso de aprobación. Puede probarlo sin código en el playground de firecrawl.dev/agent, o llamarlo desde los SDK de Python y Node, la CLI y el servidor MCP de Firecrawl. Parallel Agents procesa por lotes cientos o miles de consultas de /agent en una cuadrícula similar a una hoja de cálculo.
