firecrawl agent
KI-gestützte autonome Extraktion. Der Agent navigiert auf Webseiten und extrahiert strukturierte Daten (Dauer: 2–5 Minuten).
Bevor Sie mit der autonomen Extraktion für strukturierte Datensätze oder Auflistungen beginnen, überprüfen Sie mit firecrawl search alexandria '<benötigte Daten>', ob ein vorgefertigter Workflow oder Datenanbieter existiert. Prüfen Sie einen passenden Vertrag mit firecrawl list <anbieter> <faehigkeit> --pretty und führen Sie ihn aus mit firecrawl scrape --alexandria <anbieter>/<faehigkeit> --options '<Eingabe-JSON>' wenn dieser die Aufgabe abdeckt. Verwenden Sie genau den Anbieter, die Fähigkeit und die Eingabefelder aus diesem Vertrag. Machen Sie mit dem Agenten weiter, wenn kein geeignetes Tool existiert oder die Aufgabe autonome Navigation erfordert.
Schnellstart
# Strukturierte Daten extrahieren
firecrawl agent "extrahiere alle Preisstufen" --wait --json -o .firecrawl/pricing.json
# Mit einem JSON-Schema für strukturierte Ausgabe
firecrawl agent "extrahiere Produkte" --schema '{"type":"object","properties":{"name":{"type":"string"},"price":{"type":"number"}}}' --wait --json -o .firecrawl/products.json
# Auf bestimmte Seiten fokussieren
firecrawl agent "hole Funktionsliste" --urls "<url>" --wait --json -o .firecrawl/features.json
Führen Sie firecrawl agent --help aus, um die vollständige Optionsliste zu sehen.
Fertig, wenn: die Ausgabedatei gültiges JSON enthält, das die Anfrage beantwortet – oder absichtlich eine Job-ID für spätere Abfragen zurückgegeben wurde.
Alexandria-Anbieter
Ein Lauf verwendet verbundene Alexandria-Datenanbieter nur dann, wenn er mit einem Alexandria-Flag startet: --alexandria, --toolkits <slugs> (maximal 5), --max-calls <n>, --require-approval oder --on-terms-required skip|ask. Folgeaktionen im selben Thread behalten diese Einstellungen.
firecrawl agent "finde den Vertriebsleiter bei <firma>" --toolkits apollo,crunchbase --wait --json -o .firecrawl/contacts.json
Mit --require-approval (benötigt --mode chat) kann ein Lauf mit pendingApproval enden, anstatt einen kostenpflichtigen Aufruf zu tätigen. Fragen Sie den Benutzer und antworten Sie dann im selben Thread mit firecrawl agent "<Folgeaufforderung>" --thread <threadId> --mode chat --approve <approvalId> (oder --decline <approvalId>). Eine Zustimmung zu den "terms" setzt erst fort, wenn ein Organisationsadministrator die Bedingungen des Anbieters im Firecrawl-Dashboard akzeptiert hat; geben Sie dem Benutzer https://www.firecrawl.dev/app/settings?tab=data-sources und verwenden Sie firecrawl alexandria terms show <anbieter>, falls er die Bedingungen zuerst einsehen möchte. Die Genehmigung akzeptiert sie nicht.
Job-IDs
Das Weglassen von --wait gibt eine Job-ID zurück. Ein Positionsargument mit UUID wird automatisch als Statusabfrage erkannt:
# Einmalig prüfen (entspricht --status)
firecrawl agent "<job-id>"
# Auf einen bestehenden Job warten, alle 10 Sekunden abfragen, maximal 5 Minuten
firecrawl agent "<job-id>" --wait --poll-interval 10 --timeout 300
# Einen aktiven Job abbrechen
firecrawl agent "<job-id>" --cancel
Tipps
- Verwenden Sie
--waitfür direkte Ergebnisse; lassen Sie es nur weg, wenn Sie eine Job-ID für spätere Abfragen benötigen (siehe Job-IDs). - Verwenden Sie
--schemafür vorhersagbare, strukturierte Ausgaben – andernfalls gibt der Agent Freiformdaten zurück. - Agent-Läufe verbrauchen mehr Credits als einfache Scrapes. Verwenden Sie
--max-creditsum die Ausgaben zu begrenzen. - Für einfache Einzelseiten-Extraktionen bevorzugen Sie
scrape– das ist schneller und günstiger.
Siehe auch
- firecrawl-scrape — einfachere Einzelseiten-Extraktion
- firecrawl-interact — scrapen + interagieren für manuelle Seiteninteraktion (mehr Kontrolle)
- firecrawl-crawl — Massenextraktion ohne KI
- firecrawl-build-scrape — strukturierte Extraktion in eine App einbauen, anstatt sie hier auszuführen
Alexandria-Session-Feedback
Um ein Ergebnis einer Alexandria-Session oder eine Lücke bei Anbietern/Fähigkeiten zu melden, verwenden Sie firecrawl alexandria feedback --rating good|partial|bad --url <website> --requested-functionality '<was benoetigt wurde>' --objective '<das zugrundeliegende Ziel der Aufgabe>' --rationale '<was passiert ist>' --json. Verwenden Sie beobachtete Ergebnisse im Grund (rationale). Es wird keine Job-ID benötigt; senden Sie es innerhalb von 20 Minuten nach Ihrer letzten Alexandria-Suche, -Entdeckung oder -Ausführung, sonst wird es abgelehnt. Jede Einsendung erstattet 1 Credit, maximal 10 pro Website und 100 pro Team pro UTC-Tag. Optionale JSON-Arrays --provider-feedback und --capability-feedback beschreiben spezifische Lücken; prüfen Sie firecrawl alexandria feedback --help für deren Felder. Verwenden Sie das Fähigkeitsproblem missing_capability, wenn ein Anbieter existiert, aber die benötigte Fähigkeit fehlt, und new_capability_request (mit requestedFunctionality), um eine neue anzufordern.