Ce que fait /agent de Firecrawl
/agent est un endpoint de l'API Firecrawl (POST https://api.firecrawl.dev/v2/agent) que Firecrawl décrit comme de la recherche approfondie pour les données. Vous envoyez un prompt (jusqu'à 10.000 caractères) décrivant votre besoin, par exemple une liste d'entreprises avec leurs fondateurs et leurs sites web ; l'agent effectue des recherches sur le web, navigue sur les sites, gère les pages JavaScript, la pagination et le défilement infini, puis renvoie du JSON. Vous pouvez fournir un schéma JSON (Pydantic en Python, Zod en Node) pour obtenir une sortie typée, ainsi qu'une liste facultative d'urls pour cibler l'exécution ; strictConstrainToURLs la limite à ces seules pages. Firecrawl indique que /agent remplace son ancien endpoint /extract, qu'il est en train d'abandonner, et que pour une seule URL connue, son mode JSON sur /scrape est moins coûteux.
Chaque exécution utilise désormais le modèle Spark 2 de Firecrawl (les anciens noms Spark 1 Mini et Pro fonctionnent toujours mais redirigent vers Spark 2), avec un paramètre effort facultatif : low, medium ou high. Les tâches s'exécutent de manière asynchrone : vous interrogez l'état par ID de tâche ou recevez des webhooks, les résultats restent disponibles via l'API pendant 24 heures, et un ID de fil permet d'envoyer des consignes de suivi qui poursuivent une exécution. Parmi les autres options figurent un country de proxy pour toute l'exécution, le filtrage SafeSearch, Zero Data Retention (facturé 2x) et l'accès à des fournisseurs de données Alexandria payants avec une étape d'approbation. Vous pouvez l'essayer sans code dans le playground sur firecrawl.dev/agent, ou l'appeler depuis les SDK Python et Node, la CLI et le serveur MCP de Firecrawl. Parallel Agents exécute par lots des centaines ou des milliers de requêtes /agent sous forme de grille de type tableur.
