Firecrawl CLI: Agenten im Terminal um Scraping und Suche ergänzen

Für wen

Dieser Leitfaden richtet sich an alle, die im lokalen Terminal Websuche, Scraping, Seiteninteraktion, Site-Crawling, Sitemaps oder Agentenaufgaben brauchen. Offiziell ist er zugleich ein Kommandozeileneinstieg und eine Agentenfähigkeit, die sich in erkannte Programmeditoren einspielen lässt.

Wenn Ihre Arbeit zuerst öffentliche Seiten liest und dann entscheidet, ob Code geändert wird — statt selbst einen Scraping-Dienst zu bauen — passt dieser Weg besser. Die offizielle Beschreibung erwähnt auch die Suche in Papieren und Entwicklermaterial. Er eignet sich nicht für Menschen, die nur ein paar Klicks in einer grafischen Oberfläche wollen und keine Terminalbefehle ausführen können: der empfohlene Weg installiert ein CLI-Werkzeug, schließt die Anmeldung ab und schreibt Fähigkeiten in erkannte Editoren.

Das offizielle Repository ist

https://github.com/firecrawl/cli

Folgen Sie nur der aktuellen Formulierung auf dieser Seite. Wechseln Sie nicht zu einem Installer oder Fähigkeitsverzeichnis, das dort nicht vorkommt.

Erster Versuch in 3 Minuten

Nehmen Sie nur den einen offiziell empfohlenen Weg.

Voraussetzungen: Das Terminal kann npx ausführen, und ein Firecrawl-Zugang ist vorbereitet. Offiziell kann auch die Umgebungsvariable FIRECRAWL_API_KEY gesetzt werden; init mit --browser nutzt die Browseranmeldung. Prüfen Sie vor dem Ausführen, dass Sie sich mit Ihrem eigenen Konto anmelden, und achten Sie darauf, dass standardmäßig in alle erkannten Programmeditoren geschrieben wird, nicht in ein temporäres Verzeichnis.

Installationsort: Fähigkeiten landen standardmäßig global in erkannten Editoren. Soll nur einer bedient werden, lautet die offizielle Form --agent <agent>.

Kopieren und ausführen:

npx -y firecrawl-cli@latest init -y --browser

Erfolgssignal: Der Befehl endet normal, dieser Rechner kann firecrawl aufrufen, und in den erkannten Editoren erscheint eine neue Fähigkeit. Crawlen Sie noch keine ganze Site. Als Nächstes eine umkehrbare Prüfung: firecrawl setup core ausführen. Offiziell liefert diese Gruppe die Primitive scrape, search, crawl und interact sowie indexartige Fähigkeiten; skills ist der Alias. Wurde der Befehl angenommen, stellen Sie dem installierten Agenten eine schreibgeschützte Anfrage, zum Beispiel „Suche mit Firecrawl einen öffentlichen Dokumenttitel, zeige nur die Ergebnisse und schreibe keine Dateien.“ Sichtbare Ergebnisse bedeuten, dass die Fähigkeit gefunden wurde.

Wenn Sie Anwendungsintegrationsfähigkeiten brauchen, die die Firecrawl API ansprechen, führen Sie danach firecrawl setup build aus. Wenn Sie Ende-zu-Ende-Rezepte wie Leadgewinnung oder Tiefenrecherche brauchen, führen Sie danach firecrawl setup workflows aus. Beim ersten Mal nur core installieren, damit nicht alle Rezepte auf einmal geschrieben werden.

Anwendungsbeispiele

Beispiel 1: Dem aktuellen Agenten Such- und Scraping-Primitive hinzufügen. Die offizielle Aktion ist firecrawl setup core und installiert die Primitive scrape, search, crawl und interact sowie Indexfähigkeiten. Das passt, wenn Sie bereits in einem erkannten Editor arbeiten und der Agent zuerst öffentliche Seiten suchen oder scrapen soll, bevor Sie das Repository ändern. Zuerst das init oben abschließen, dann nur core installieren. Bei Erfolg sollte ein Gespräch eine Suche oder ein Scraping auslösen und eine Ergebniszusammenfassung zeigen. Offizielle Materialien nennen keinen Pfad zum Fähigkeitsordner; erfinden Sie kein Verzeichnis, das nie vorkommt.

Beispiel 2: Fertige Rezepte statt einzelner Primitive. Die offizielle Aktion ist firecrawl setup workflows; in den Materialien stehen Leadgewinnung und Tiefenrecherche. Das passt, wenn core bereits läuft und Sie jetzt rezeptbasiert recherchieren wollen. Erst den Erfolg von init prüfen, dann den Befehl ausführen; für nur einen Editor --agent <agent> anhängen. Erfolgssignal: Diese Fähigkeitsgruppe erscheint im Ziel-Editor. Innere Rezeptschritte sind nicht ausgeführt; vorhandenes Material bestätigt nur, dass workflows installiert ist, und fehlende Unterschritte lassen sich nicht ergänzen.

Grenzen

Vorhandenes Material endet bei Terminalbefehlen, Browseranmeldung oder FIRECRAWL_API_KEY sowie den drei Installationsgruppen core, build und workflows. Es schreibt keine Pflichtsprache vor und macht aus „erkannte Editoren“ keine Ausschlussliste; schließen Sie aus dem Standardumfang nicht, dass nur wenige Clients funktionieren.

Wenden Sie dieses npx-Init nicht auf Umgebungen an, die nur das manuelle Kopieren von Fähigkeitsdateien erlauben und keine allgemeine Kommandozeile haben. Das Material nennt weder eine Adresse eines Zweitmarkts noch ein Beispielgeheimnis.

init und setup schreiben Fähigkeiten in erkannte Editoren und haben Nebenwirkungen. Bestätigen Sie zuerst den Ziel-Editor; prüfen Sie danach nur, ob die Fähigkeiten erschienen sind — crawlen Sie nicht sofort eine nicht autorisierte Site. Scraping, Interaktion und Crawling erreichen externe Sites; prüfen Sie zuerst mit einer öffentlichen Seite, die sich erneut öffnen lässt.

FIRECRAWL_API_KEY ist ein Umgebungsvariablenname, kein Beispielgeheimnis für den Text. Erfinden Sie keine Unterbefehle, Fähigkeitsnamen oder Installationspfade, die nie vorkommen. Weitere Hinweise folgen dem offiziellen Repository:

https://github.com/firecrawl/cli