Was /agent von Firecrawl leistet
/agent ist ein Endpunkt der Firecrawl API (POST https://api.firecrawl.dev/v2/agent), den Firecrawl als Deep Research für Daten beschreibt. Sie senden einen prompt (bis zu 10.000 Zeichen), der beschreibt, was Sie benötigen, etwa eine Liste von Unternehmen mit Gründern und Websites. Der Agent durchsucht das Web, navigiert durch Websites, verarbeitet JavaScript-Seiten, Paginierung und Infinite Scroll und gibt JSON zurück. Sie können ein JSON-Schema übergeben (Pydantic in Python, Zod in Node), um typisierte Ausgaben zu erhalten, sowie eine optionale Liste von urls, um den Run einzugrenzen; strictConstrainToURLs beschränkt ihn ausschließlich auf diese Seiten. Laut Firecrawl ersetzt /agent den älteren Endpunkt /extract, der eingestellt wird, und für eine einzelne bekannte URL ist der JSON-Modus von /scrape günstiger.
Jeder Run nutzt jetzt das Modell Spark 2 von Firecrawl (die älteren Bezeichnungen Spark 1 Mini und Pro funktionieren weiterhin, werden aber an Spark 2 weitergeleitet), mit einer optionalen effort-Einstellung von low, medium oder high. Jobs laufen asynchron: Sie fragen per Job-ID ab oder erhalten Webhooks, die Ergebnisse bleiben 24 Stunden über die API verfügbar, und mit einer Thread-ID können Sie Folge-Prompts senden, die einen Run fortsetzen. Weitere Optionen sind ein Proxy-country für den gesamten Run, SafeSearch-Filterung, Zero Data Retention (mit 2x abgerechnet) sowie der Zugriff auf kostenpflichtige Alexandria-Datenanbieter mit einem Freigabeschritt. Sie können es ohne Code im Playground unter firecrawl.dev/agent ausprobieren oder über die Python- und Node-SDKs, die CLI und den MCP-Server von Firecrawl aufrufen. Parallel Agents verarbeitet Hunderte oder Tausende von /agent-Anfragen als Raster im Tabellenstil.
