So nutzen Sie Firecrawl Local mit Claude Code und Cursor (MCP)

Eine praxisnahe Anleitung für Firecrawl Local: das Binary installieren, es mit init als MCP-Server in Claude Code und Cursor registrieren, die Firecrawl v2 API auf localhost:3002 betreiben, das SDK darauf ausrichten und die Cloud deaktivieren.

Ashley Innocent

Ashley Innocent

19 November 2026

So nutzen Sie Firecrawl Local mit Claude Code und Cursor (MCP)

Apidog für Unternehmen

On-Premises Bereitstellung

SSO & RBAC

SOC 2 konform

Apidog Enterprise entdecken

Um Firecrawl Local zu nutzen, installierst du es mit cargo install firecrawl-local, führst firecrawl-local init aus, um es als MCP-Server in Claude Code und Cursor zu registrieren, und startest anschließend beide Tools neu. Dein Agent kann jetzt Websites auf deinem eigenen Rechner scrapen, crawlen und kartieren. Für Code führst du firecrawl-local serve aus und richtest jedes Firecrawl-SDK auf http://localhost:3002 aus.

Diese Anleitung zeigt Schritt für Schritt, wie du Firecrawl Local verwendest – mit der echten Ausgabe unseres Testlaufs vom 19. November 2026 (Firecrawl Local 0.1.0 auf einem arm64-Mac), den Prompts für deinen Agenten und einer Möglichkeit, die lokale API vom Agenten mit der Apidog CLI testen zu lassen.

Was du vor dem Start brauchst

Firecrawl Local ist ein einzelnes Rust-Binary aus dem Firecrawl-Repository. Prüfe vor der Installation, ob du Folgendes hast:

  1. Rust und einen C-Compiler. Rust bekommst du von rustup.rs. Unter macOS führst du xcode-select --install aus; unter Debian oder Ubuntu installierst du build-essential.
  2. Node.js 22 oder neuer, falls du den MCP-Server nutzen möchtest. Er startet das npm-Paket firecrawl-mcp über npx.
  3. Chrome oder Chromium (optional). Firecrawl Local nutzt den bereits vorhandenen Browser für Seiten, die JavaScript benötigen. Statische Seiten funktionieren auch ohne.
  4. Claude Code, Cursor oder einen anderen MCP-Client. init kennt außerdem Claude Desktop, Windsurf, Gemini CLI und Codex.

Wenn du mit Firecrawl selbst noch nicht vertraut bist, beginne mit unserem Firecrawl-Web-Scraping-Leitfaden und komm dann zurück.

Schritt 1: Firecrawl Local installieren

Installiere das Crate von crates.io und prüfe die Version:

cargo install firecrawl-local
firecrawl-local --version
# firecrawl-local 0.1.0

Cargo kompiliert es aus dem Quellcode. Auf unserem Mac war der Release-Build nach 6 Minuten 54 Sekunden fertig, und das Binary landete in ~/.cargo/bin/firecrawl-local. Stelle sicher, dass dieser Ordner in deinem PATH liegt, oder merke dir den vollständigen Pfad: Du brauchst ihn für die manuelle MCP-Einrichtung.

Schritt 2: Deinen ersten Scrape im Terminal ausführen

Bevor du irgendetwas in einen Agenten einbindest, prüfe, ob das Abrufen funktioniert:

FIRECRAWL_CLOUD=off firecrawl-local scrape https://example.com --markdown

Es gab den Haupttext der Seite innerhalb von 1,2 Sekunden als Markdown aus. Lässt du --markdown weg, erhältst du das gleiche JSON, das die Firecrawl-API zurückgibt. Mit --format markdown,links wählst du Formate aus; lokal stehen markdown, html, rawHtml und links zur Verfügung.

Als Nächstes ein Crawl, der pro Seite eine Markdown-Datei schreibt:

FIRECRAWL_CLOUD=off firecrawl-local crawl https://docs.firecrawl.dev --limit 20 --out ./pages

Dieser Abruf holte 20 Seiten der Firecrawl-Dokumentation in 4,4 Sekunden und speicherte Dateien mit Namen wie 0005-docs.firecrawl.dev_advanced-scraping-guide.md. Nützliche Crawl-Flags aus firecrawl-local crawl --help:

Flag Funktion
-l, --limit Maximale Seitenzahl (Standard 100)
--max-depth Wie viele Linkebenen tief gefolgt wird
--include, --exclude Pfad-Regex zum Behalten oder Überspringen, mehrfach angebbar
--entire-domain Links außerhalb des Startpfads folgen
-c, --concurrency Anzahl gleichzeitig abgerufener Seiten
--ignore-robots robots.txt ignorieren (wird standardmäßig gelesen)

firecrawl-local map https://firecrawl.dev liefert jede URL zurück, die es in den Sitemaps und auf der Startseite findet – als eine JSON-Zeile.

Schritt 3: Firecrawl Local mit init zu Claude Code und Cursor hinzufügen

init findet die KI-Tools auf deinem Rechner und fügt Firecrawl Local zu jeder MCP-Konfiguration hinzu. Zeig dir das zuerst als Vorschau an:

firecrawl-local init --dry-run

Auf unserem Mac listete es jedes Tool auf, das es anfassen würde:

Firecrawl MCP server:
  Claude Code: would be added in ~/.claude.json
  Claude desktop: would be added in ~/Library/Application Support/Claude/claude_desktop_config.json
  Cursor: would be added in ~/.cursor/mcp.json
  Gemini CLI: would be added in ~/.gemini/settings.json
  Codex: would be added in ~/.codex/config.toml

Der Dry Run zeigt außerdem, was an Firecrawl Cloud geht: Suchanfragen, die URL einer Seite, die deinen Rechner blockiert hat, Alexandria-Aufrufe nach dem Login sowie eine zufällige Installations-ID und der Name deines KI-Tools. Seiten, die lokal problemlos laden, werden nie gesendet.

Wenn du nur die beiden in dieser Anleitung behandelten Tools einrichten möchtest, wiederholst du --agent:

firecrawl-local init --agent claude-code --agent cursor

Die gültigen Bezeichnungen sind claude-code, claude-desktop, cursor, windsurf, gemini und codex. init legt vor dem Schreiben eine Sicherungskopie jeder Konfigurationsdatei an. Starte Claude Code und Cursor danach neu, damit sie den neuen Server laden.

Claude Code und Cursor kommunizieren über stdio mit firecrawl-local mcp; es scrapt, crawlt und kartiert auf deinem Rechner und sendet nur Suchen und blockierte Seiten an Firecrawl Cloud, es sei denn FIRECRAWL_CLOUD=off

Firecrawl Local in Claude Code manuell einrichten

Wenn du keine Konfigurationsdateien von einem Tool bearbeiten lassen möchtest, füge den stdio-Server selbst mit dem Claude-Code-MCP-Befehl hinzu:

claude mcp add firecrawl -e FIRECRAWL_CLOUD=off -- ~/.cargo/bin/firecrawl-local mcp --public-only

Führe in Claude Code /mcp aus, um zu bestätigen, dass der Server verbunden ist.

Firecrawl Local in Cursor manuell einrichten

Cursor liest MCP-Server aus ~/.cursor/mcp.json (global) oder .cursor/mcp.json (projektbezogen). Verwende den vollständigen Pfad zum Binary:

{
  "mcpServers": {
    "firecrawl": {
      "command": "/Users/you/.cargo/bin/firecrawl-local",
      "args": ["mcp", "--public-only"],
      "env": { "FIRECRAWL_CLOUD": "off" }
    }
  }
}

--public-only sorgt dafür, dass der Server localhost- und private Netzwerkadressen ablehnt. Lass es eingeschaltet, wenn dein Agent Seiten liest, denen du nicht vertraust: Versteckte Anweisungen auf einer Seite könnten den Agenten sonst in Richtung einer internen URL lenken.

Schritt 4: Prompts für deinen Agenten

firecrawl-local mcp startet die lokale API auf einem Loopback-Port und führt das Paket firecrawl-mcp dagegen aus. Dein Agent sieht die standardmäßigen Firecrawl-MCP-Tools; Scrape, Crawl, Map und Batch Scrape laufen auf deinem Rechner. Wenn du den gehosteten Firecrawl-MCP-Server verwendet hast, sind die Tool-Namen identisch.

Prompts, die gut zu den lokalen Tools passen:

Map https://docs.example.com, then crawl only the /api/ pages (limit 40)
and write a summary of every endpoint into docs/vendor-api.md.
Scrape the changelog at https://example.com/changelog as markdown and list
every breaking change from the last three releases.
Batch scrape these five pricing pages and build a comparison table of
plan names and limits. Quote only what the pages say.

Verzichte auf Prompts, die eine Suche erfordern: Mit FIRECRAWL_CLOUD=off führt dieses Tool nirgendwohin. Für ein vollständig lokales Such-Setup sieh dir unseren Leitfaden zur Open-Source-Websuche für Claude an.

Schritt 5: Die Firecrawl-Local-API starten und dein SDK darauf ausrichten

Für Skripte und Pipelines startest du den API-Server:

FIRECRAWL_CLOUD=off firecrawl-local serve

Er lauscht auf 127.0.0.1:3002. Der Health-Check antwortet sofort:

curl -s localhost:3002/health
# {"status":"ok","engine":"firecrawl-local","version":"0.1.0"}

Ein Scrape liefert die gewohnte v2-Struktur mit zwei lokalen Markern: "engine": "local-fetch" und "source": "local", sowie creditsUsed: 0.

curl -s localhost:3002/v2/scrape -H 'content-type: application/json' \
  -d '{"url":"https://example.com","formats":["markdown","links"]}'

Richte die Firecrawl-SDKs ohne API-Schlüssel darauf aus. Python:

from firecrawl import Firecrawl

app = Firecrawl(api_url="http://localhost:3002")
print(app.scrape("https://example.com").markdown)

Node:

import { Firecrawl } from "firecrawl";

const app = new Firecrawl({ apiUrl: "http://localhost:3002" });
const doc = await app.scrape("https://example.com");
console.log(doc.markdown);

init schlägt außerdem eine Abkürzung vor: Setze FIRECRAWL_API_URL=http://127.0.0.1:3002, und dein bestehender Firecrawl-Code läuft lokal. Die Firecrawl CLI teilt ihren gespeicherten Login mit Firecrawl Local, sodass das login des einen Tools für beide funktioniert.

Crawls laufen asynchron. POST /v2/crawl gab sofort eine Job-ID zurück, und GET /v2/crawl/{id} meldete wenige Sekunden später status: completed, total: 10, creditsUsed: 0 und expiresInSeconds: 3587. Jobs leben im Speicher, verfallen eine Stunde nach ihrem Start und verschwinden, wenn serve stoppt – speichere Ergebnisse also, sobald ein Crawl abgeschlossen ist.

Der Serverprozess belegte im Leerlauf etwa 10 MB residenten Speicher und direkt nach diesem Crawl über 10 Seiten 43 MB, gemessen mit ps. Firecrawls Launch-Post behauptet 37x schneller und 230x weniger Speicher als selbst gehostetes Firecrawl; die README veröffentlicht keine Methodik, behandle diese Zahlen also als Firecrawl-Angaben.

Firecrawl Local mit FIRECRAWL_CLOUD vollständig lokal halten

Standardmäßig (auto) gehen drei Dinge an Firecrawl Cloud: Suchen, Seiten, die deinen Rechner blockieren, und Alexandria-Datenanbieter (die ein kostenloses Konto über firecrawl-local login erfordern). FIRECRAWL_CLOUD steuert die Übergabe:

Wert Wirkung
auto (Standard) Suche, Fallback für blockierte Seiten und Alexandria funktionieren alle
search Nur Suchen geht an Firecrawl Cloud
off Nichts geht an Firecrawl Cloud

Ein nicht erkannter Wert wird als off behandelt. Bei deaktivierter Cloud antwortet POST /v2/search mit "code":"CLOUD_ONLY" und einer Meldung, die dich auffordert, FIRECRAWL_API_KEY oder FIRECRAWL_CLOUD=auto zu setzen. Eine Seite, die die Cloud für dich abgerufen hat, trägt "source": "firecrawl-cloud", sodass du immer erkennen kannst, woher ein Ergebnis stammt.

serve lehnt localhost- und private Ziele ab, es sei denn, du übergibst --allow-private, und das Binden an einen nicht-Loopback---host erfordert --token. Cloud-Metadaten und Link-Local-Adressen werden in jedem Modus blockiert.

Lass deinen Coding-Agenten die Firecrawl-Local-API mit der Apidog CLI testen

Der Crawl-Endpunkt ist am ehesten geeignet, eine Pipeline zu brechen: Er ist asynchron, der Job verfällt, und ein gestoppter Server verliert ihn. Statt manuell zu pollen, lässt du deinen Coding-Agenten einen Test mit Apidog CLI erstellen und ausführen.

Einmal einrichten:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install

Dann gibst du Claude Code oder Cursor einen Prompt:

firecrawl-local serve is running on http://localhost:3002. In Apidog project <id>,
import an OpenAPI file for POST /v2/scrape, POST /v2/crawl and GET /v2/crawl/{id},
create an environment for that base URL, and build a test scenario that starts a
crawl of https://docs.firecrawl.dev with limit 10, saves the returned id, polls
GET /v2/crawl/{id} until status is "completed", and asserts total equals completed
and every page has non-empty markdown. Run it and summarize any failures.
Ablauf des vom Agenten erstellten Tests: Apidog CLI sendet POST /v2/crawl an firecrawl-local serve, pollt GET /v2/crawl/{id} bis zum Abschluss, prüft die Assertions und schreibt einen cli-, json- oder junit-Bericht

Der Agent liest jedes Payload-Schema, validiert es und führt Befehle wie diese aus, alle aus apidog <cmd> --help in CLI 2.2.12 übernommen:

apidog import --project <id> --format openapi --file ./firecrawl-local-v2.yaml
apidog environment create firecrawl-local --project <id> --base-url http://localhost:3002
apidog cli-schema get test-scenario-create
apidog cli-schema validate test-scenario-create --file scenario.json
apidog test-scenario create --project <id> --file ./scenario.json
apidog run -t <scenarioId> --project <id> -e <envId> -r cli,json

Apidog CLI sendet Anfragen von deinem Rechner, sodass localhost:3002 erreichbar ist. Wechsle zu -r junit, um denselben Lauf in deine CI einzubinden; unsere Leitfäden zu Apidog CLI in Claude Code und Apidog CLI in Cursor behandeln die Agenten-Seite. Der Free-Plan von Apidog deckt Teams mit bis zu 4 Nutzern ab.

Fehlerbehebung bei Firecrawl Local

Symptom Lösung
404 mit NOT_FOUND auf /v1/scrape Es wird nur v2 bereitgestellt; stelle deinen Client auf /v2/... um
CLOUD_ONLY auf /v2/search Erwartet bei FIRECRAWL_CLOUD=off; verwende auto oder search
Agent listet keine Firecrawl-Tools auf Starte das Tool nach init neu; prüfe Node.js 22+
JavaScript-Seite kommt spärlich zurück Installiere Chrome oder setze --browser always
json- oder summary-Format fehlt Lokal nicht unterstützt; du erhältst stattdessen eine Warnung
Crawl-ID nicht gefunden Der Job ist nach einer Stunde abgelaufen oder serve wurde neu gestartet

FAQ

Ist Firecrawl Local kostenlos? Lokales Scrapen, Crawlen und Kartieren sendet nichts an Firecrawl und verbrauchte in unseren Tests 0 Credits. Der Code steht unter AGPL-3.0, die SDKs unter MIT. Suche und Alexandria laufen über Firecrawl Cloud.

Brauche ich einen API-Schlüssel für Firecrawl Local? Nein, nicht für lokale Routen. Du benötigst einen Schlüssel – über firecrawl-local login oder FIRECRAWL_API_KEY – nur für Alexandria-Datenanbieter.

Funktioniert Firecrawl Local mit Windsurf, Codex und Gemini CLI? Ja. init kennt windsurf, codex und gemini ebenso wie Claude Code, Claude Desktop und Cursor.

Kann mein bestehender Firecrawl-Code unverändert dagegen laufen? Für v2 Scrape, Map, Crawl und Batch Scrape ja: Ändere die API-URL auf http://localhost:3002. v0- und v1-Routen werden nicht bereitgestellt, und Browser-actions werden ignoriert.

Respektiert Firecrawl Local robots.txt? Ja. Es liest beim Crawlen robots.txt und identifiziert sich im User-Agent, sodass Seiteninhaber es als FirecrawlLocal ansprechen können. --ignore-robots schaltet das ab; verwende es nur auf Websites, die dir gehören.

Praktizieren Sie API Design-First in Apidog

Entdecken Sie eine einfachere Möglichkeit, APIs zu erstellen und zu nutzen