Firecrawl

Firecrawl MCP Server

Ein Model Context Protocol (MCP)-Server, der Firecrawl zu MCP-kompatiblen KI-Agenten bringt – suchen, scrapen und mit dem Live-Web interagieren für sauberen, agentenbereiten Kontext.

Großer Dank an @vrknetha, @knacklabs für die ursprüngliche Implementierung!

Funktionen

• Im Web suchen und vollständigen Seiteninhalt erhalten
• In einem für Codierungsagenten erstellten Index suchen: GitHub-Issues, gemergte Pull-Requests, READMEs und Dokumentationen
• Beliebige URL in saubere, strukturierte Daten scrapen
• Mit Seiten interagieren – klicken, navigieren und bedienen
• Tiefenrecherche mit autonomem Agenten
• Automatische Wiederholungsversuche und Ratenbegrenzung
• Cloud- und Self-Hosted-Unterstützung
• SSE-Unterstützung

Probieren Sie unseren MCP-Server auf dem MCP.so-Playground oder auf Klavis AI aus.

Wann dieser Server verwendet werden sollte

• Verwenden Sie firecrawl_scrape, wenn Sie eine bekannte URL haben und deren Inhalt als Markdown oder als JSON passend zu einem von Ihnen bereitgestellten Schema möchten.
• Verwenden Sie firecrawl_map, wenn Sie URLs auf einer Website entdecken müssen, ohne deren Inhalt abzurufen.
• Verwenden Sie firecrawl_crawl, wenn Sie Inhalte von vielen Seiten unter einer Website benötigen; setzen Sie limit, includePaths/excludePaths oder maxDiscoveryDepth, um dies zu begrenzen.
• Verwenden Sie firecrawl_search, wenn Sie von einer Abfrage statt von einer URL ausgehen und rankende Webergebnisse möchten; fügen Sie scrapeOptions hinzu, wenn Sie auch Seiteninhalte im selben Aufruf abrufen möchten (der Nur-Suche-Endpunkt ruft niemals Inhalte ab).
• Verwenden Sie firecrawl_interact, wenn eine Seite eine Klick-, Eingabe- oder Navigationsaktion benötigt, bevor Sie sie lesen können – übergeben Sie eine url für eine neue Seite oder eine scrapeId, um auf einer bereits gescrapten Seite fortzufahren.
• Verwenden Sie die firecrawl_monitor_*-Tools, wenn dieselbe Seite in regelmäßigen Abständen mit Diffs und Änderungsbenachrichtigungen geprüft werden muss, anstatt nur einmal abgerufen zu werden.
• Ziehen Sie etwas anderes in Betracht, wenn Sie eine Browsersitzung über viele eigene Schritte hinweg mit eigener Wiederholungs- und Abbruchlogik offen halten müssen: Jeder firecrawl_interact-Aufruf führt eine prompt- oder code-Runde bis zum Abschluss aus und gibt die Kontrolle zurück – die Sitzung kann über Aufrufe hinweg über scrapeId bestehen bleiben und endet mit firecrawl_interact_stop, aber Sie können sie nicht interaktiv Schritt für Schritt von der Clientseite innerhalb eines einzelnen Aufrufs steuern.

Dieser Server listet 25 Tools auf, wenn das vollständige Profil mit Standardeinstellungen registriert ist (Feedback-Tools enthalten, nicht im lokalen schlüssellosen Modus). Das Setzen von FIRECRAWL_NO_SEARCH_FEEDBACK=1 und/oder FIRECRAWL_NO_ENDPOINT_FEEDBACK=1 entfernt die entsprechenden Feedback-Tools und reduziert diese Anzahl, ebenso wie der lokale schlüssellose Start. Für Clients mit einem Tool-Slot-Limit: Der gehostete schlüssellose Endpunkt (https://mcp.firecrawl.dev/v2/mcp, kein API-Schlüssel) stellt nur 3 bereit – firecrawl_scrape, firecrawl_search, firecrawl_parse – und der dedizierte Nur-Suche-Endpunkt (https://mcp.firecrawl.dev/v2/mcp-search) stellt feste 6 schreibgeschützte Tools bereit.

Installation

Gehosteter MCP (schlüssellose kostenlose Stufe)

Verbinden Sie sich ohne Einrichtung mit dem entfernten gehosteten Server:

https://mcp.firecrawl.dev/v2/mcp

Auf der schlüssellosen kostenlosen Stufe funktionieren scrape, search und parse ohne API-Schlüssel (ratenbegrenzt). Andere Tools wie crawl, map und agent benötigen weiterhin einen Schlüssel.

Bevorzugen Sie OAuth oder einen API-Schlüssel, wann immer die Person sich anmelden kann. Es entsperrt den vollständigen Tool-Satz und höhere Limits.

Für eine interaktive Kontoverbindung konfigurieren Sie Ihren MCP-Client, um diese Server-URL zu verwenden. Dies ist ein MCP-Endpunkt, keine Browserseite; verwenden Sie den Kontoverbindungsfluss des Clients und fügen Sie beim erneuten Verbinden keinen zweiten Firecrawl-Servereintrag hinzu:

https://mcp.firecrawl.dev/v2/mcp-oauth

Für eine API-Schlüssel-Verbindung (z. B. eine unbeaufsichtigte Integration) behalten Sie die Server-URL wie folgt bei:

https://mcp.firecrawl.dev/v2/mcp

Konfigurieren Sie dann die sichere Header- oder Geheimniseinstellung des Clients mit:

Authorization: Bearer <FIRECRAWL_API_KEY>

Setzen Sie niemals einen API-Schlüssel in die Server-URL. Setzen Sie niemals einen API-Schlüssel in einen Agenten-Chat. Konfigurieren Sie ihn direkt im Client oder im Geheimnisverwalter. Siehe den gehosteten MCP-Setup-Leitfaden und den Agenten-Onboarding-Leitfaden für clientspezifische Anweisungen.

Nur-Suche-Endpunkt

Eine schreibgeschützte, nur-Suche-Oberfläche ist ebenfalls gehostet unter:

https://mcp.firecrawl.dev/v2/mcp-search

Sie stellt einen festen Satz von sechs schreibgeschützten Tools bereit: firecrawl_search, firecrawl_developer_search und die vier firecrawl_research_*-Tools. Sie führt kein Seiteninhaltsabrufen durch und hat eine eigene OAuth-Identität; der vollständige Endpunkt oben bleibt unverändert. Siehe docs/search-profile.md für den vollständigen Vertrag.

Ausführen mit npx

env FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp

Manuelle Installation

npm install -g firecrawl-mcp

Ausführen auf Cursor

Cursor konfigurieren 🖥️ Hinweis: Erfordert Cursor-Version 0.45.6+ Für die aktuellsten Konfigurationsanweisungen lesen Sie bitte die offizielle Cursor-Dokumentation zum Konfigurieren von MCP-Servern: Cursor MCP-Server-Konfigurationsleitfaden

So konfigurieren Sie Firecrawl MCP in Cursor v0.48.6

1. Öffnen Sie die Cursor-Einstellungen
2. Gehen Sie zu Features > MCP-Server
3. Klicken Sie auf „+ Neuen globalen MCP-Server hinzufügen"
4. Geben Sie den folgenden Code ein:

   {
     "mcpServers": {
       "firecrawl-mcp": {
         "command": "npx",
         "args": ["-y", "firecrawl-mcp"],
         "env": {
           "FIRECRAWL_API_KEY": "YOUR-API-KEY"
         }
       }
     }
   }
   

So konfigurieren Sie Firecrawl MCP in Cursor v0.45.6

1. Öffnen Sie die Cursor-Einstellungen
2. Gehen Sie zu Features > MCP-Server
3. Klicken Sie auf „+ Neuen MCP-Server hinzufügen"
4. Geben Sie Folgendes ein:
   • Name: „firecrawl-mcp" (oder Ihr bevorzugter Name)
   • Typ: „Befehl"
   • Befehl: env FIRECRAWL_API_KEY=your-api-key npx -y firecrawl-mcp

Wenn Sie Windows verwenden und auf Probleme stoßen, versuchen Sie cmd /c "set FIRECRAWL_API_KEY=your-api-key && npx -y firecrawl-mcp"

Ersetzen Sie your-api-key durch Ihren Firecrawl-API-Schlüssel. Wenn Sie noch keinen haben, können Sie ein Konto erstellen und ihn von https://www.firecrawl.dev/app/api-keys erhalten

Nach dem Hinzufügen aktualisieren Sie die MCP-Serverliste, um die neuen Tools zu sehen. Der Composer-Agent verwendet Firecrawl MCP automatisch, wenn angemessen, aber Sie können es explizit anfordern, indem Sie Ihre Web-Scraping-Anforderungen beschreiben. Greifen Sie über Befehl+L (Mac) auf den Composer zu, wählen Sie „Agent" neben der Senden-Schaltfläche und geben Sie Ihre Abfrage ein.

Ausführen auf Windsurf

Fügen Sie dies zu Ihrer ./codeium/windsurf/model_config.json hinzu:

{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Ausführen mit Streamable HTTP im lokalen Modus

Um den Server lokal mit Streamable HTTP anstelle des Standard-stdio-Transports auszuführen:

env HTTP_STREAMABLE_SERVER=true FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp

Verwenden Sie die URL: http://localhost:3000/mcp

Installation über Smithery (Legacy)

Um Firecrawl für Claude Desktop automatisch über Smithery zu installieren:

npx -y @smithery/cli install @mendableai/mcp-server-firecrawl --client claude

Ausführen auf VS Code

Für die Ein-Klick-Installation klicken Sie auf eine der Installationsschaltflächen unten...

Für die manuelle Installation fügen Sie den folgenden JSON-Block zu Ihrer Benutzereinstellungen (JSON)-Datei in VS Code hinzu. Sie können dies tun, indem Sie Ctrl + Shift + P drücken und Preferences: Open User Settings (JSON) eingeben.

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "Firecrawl API Key",
        "password": true
      }
    ],
    "servers": {
      "firecrawl": {
        "command": "npx",
        "args": ["-y", "firecrawl-mcp"],
        "env": {
          "FIRECRAWL_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

Optional können Sie es zu einer Datei namens .vscode/mcp.json in Ihrem Arbeitsbereich hinzufügen. Dies ermöglicht es Ihnen, die Konfiguration mit anderen zu teilen:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "Firecrawl API Key",
      "password": true
    }
  ],
  "servers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "${input:apiKey}"
      }
    }
  }
}

Konfiguration

Umgebungsvariablen

Erforderlich für die Cloud-API

• FIRECRAWL_API_KEY: Ihr Firecrawl-API-Schlüssel
  • Erforderlich bei Verwendung der Cloud-API (Standard)
  • Optional bei Verwendung einer Self-Hosted-Instanz mit FIRECRAWL_API_URL
• FIRECRAWL_API_URL (Optional): Benutzerdefinierter API-Endpunkt für Self-Hosted-Instanzen
  • Beispiel: https://firecrawl.your-domain.com
  • Wenn nicht angegeben, wird die Cloud-API verwendet (erfordert API-Schlüssel)

MCP OAuth (Bearer-Zugriffstokens)

Gehostetes Firecrawl kann OAuth-Zugriffstokens (fco_…) über den Autorisierungsserver auf firecrawl.dev ausstellen. Dieser MCP-Server leitet die Anmeldeinformationen, die er auflöst, als Authorization: Bearer … an die Firecrawl-API weiter.

• HTTP-Stream-Transports (CLOUD_SERVICE=true, HTTP_STREAMABLE_SERVER=true oder SSE_LOCAL=true): Clients sollten Authorization: Bearer <fco_access_token> bei MCP-Anfragen senden. Ein OAuth-Bearer-Token hat Vorrang vor x-firecrawl-api-key / x-api-key, wenn beide vorhanden sind.
• stdio: Verwenden Sie FIRECRAWL_OAUTH_TOKEN für ein statisches Zugriffstoken oder verwenden Sie weiterhin FIRECRAWL_API_KEY für einen API-Schlüssel.

Verwenden Sie nur Zugriffstokens (fco_…). Aktualisierungstokens (fcr_…) müssen am Token-Endpunkt ausgetauscht werden, nicht an die Scrape-/Such-API übergeben werden.

Nur-Suche-Oberfläche (gehostet)

Im gehosteten Modus (CLOUD_SERVICE=true) bedient eine zweite In-Process-Instanz den Nur-Suche-Endpunkt. Der gebündelte Dienst hat einen festen Bereitstellungsvertrag: nginx leitet /v2/mcp-search an die Instanz auf lokalen Port 3001 weiter, und die OAuth-geschützte Ressourcenkennung ist https://mcp.firecrawl.dev/v2/mcp-search.

FIRECRAWL_MCP_SEARCH_ENABLED (Standard true) ist der unterstützte operative Schalter; setzen Sie ihn auf false, um zu verhindern, dass die Suchinstanz startet. Der Node-Prozess akzeptiert auch FIRECRAWL_MCP_SEARCH_PORT, FIRECRAWL_MCP_SEARCH_ENDPOINT und FIRECRAWL_MCP_SEARCH_RESOURCE_URL für isolierte Tests. Diese Überschreibungen konfigurieren die gebündelten nginx-Routen oder die Autorisierungsserver-Allowlist nicht neu und dürfen nicht unabhängig in der gehosteten Bereitstellung verwendet werden.

Die Suchinstanz erfordert Authentifizierung für jede Anfrage (einschließlich tools/list) und lehnt OAuth-Tokens ab, deren Zielgruppe nicht mit ihrer eigenen Ressource übereinstimmt.

Konfigurationsbeispiele

Für die Cloud-API-Nutzung:

export FIRECRAWL_API_KEY=your-api-key

Für eine Self-Hosted-Instanz:

# Required for self-hosted
export FIRECRAWL_API_URL=https://firecrawl.your-domain.com

# Optional authentication for self-hosted
export FIRECRAWL_API_KEY=your-api-key  # If your instance requires auth

Verwendung mit Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

So wählen Sie ein Tool

Verwenden Sie diesen Leitfaden, um das richtige Tool für Ihre Aufgabe auszuwählen:

• Wenn Sie die genaue URL kennen: verwenden Sie scrape (mit JSON-Format für strukturierte Daten)
• Wenn Sie mehrere bekannte URLs haben: rufen Sie scrape für jede URL auf. Wenn Sie speziell eine Bulk-API-Operation benötigen, verwenden Sie den Firecrawl-API-Batch-Endpunkt außerhalb von MCP.
• Wenn Sie URLs auf einer Website entdecken müssen: verwenden Sie map
• Wenn Sie im Web nach Informationen suchen möchten: verwenden Sie search
• Wenn Sie eine Programmierfrage haben (eine Bibliothek, einen API-Vertrag, eine Fehlermeldung, einen bekannten Fehler): verwenden Sie Entwicklersuche
• Wenn Sie wissenschaftliche Arbeiten benötigen (biomedizinische, lebenswissenschaftliche, klinische oder arXiv-Literatur): verwenden Sie Forschungstools – sie durchsuchen Zusammenfassungen und Volltexte von Arbeiten. search mit categories: ["research"] ist eine andere Sache: ein Website-Filter über gewöhnlichen Webergebnissen.
• Wenn Sie Multi-Quellen-Recherche benötigen, die strukturierte Daten zurückgibt, die URLs nicht kennen oder die Antwort mehrere Websites umfasst (eine Entität plus ihre Felder, eine Liste, einen Datensatz): verwenden Sie agent
• Wenn Sie eine ganze Website oder einen Abschnitt analysieren möchten: verwenden Sie crawl (mit Limits!)
• Wenn Sie interaktive Browserautomatisierung benötigen (Klicken, Eingeben, Navigieren): verwenden Sie interact mit einer URL für eine neue Seite oder scrape + interact, wenn Sie die Seite bereits gescrapt haben oder eine strengere Scrape-Kontrolle benötigen

Kurzreferenztabelle

Tool	Am besten geeignet für	Rückgabe
scrape	Einzelner Seiteninhalt	JSON (bevorzugt) oder Markdown
interact	Interaktion mit einer URL oder gescrapten Seite	Ausführungsergebnis + scrapeId für den URL-Modus
map	Entdecken von URLs auf einer Website	URL[]
crawl	Mehrseitige Extraktion (mit Limits)	Endgültiger Crawl-Status/daten nach internem Polling
parse	Dateien und gehostete Upload-Referenzen	Markdown, JSON oder Dokumentausgabe
search	Websuche nach Informationen	results[]
developer	Programmierfragen über Entwicklerquellen	results[] mit Passagen
agent	Multi-Quellen-Recherche, unbekannte oder viele Websites	JSON (strukturierte Daten)
monitor	Wiederkehrende Seitenprüfungen	Monitor-/Prüfmetadaten und Diffs
research	Recherche zu Arbeiten und GitHub-Repositories	Forschungsergebnisse und Repo-Übereinstimmungen

Leitfaden zur Formatauswahl

Bei Verwendung von scrape wählen Sie das richtige Format:

• JSON-Format (für die meisten Fälle empfohlen): Verwenden Sie es, wenn Sie spezifische Daten von einer Seite benötigen. Definieren Sie ein Schema basierend auf dem, was Sie extrahieren möchten. Dies hält die Antworten klein und vermeidet einen Überlauf des Kontextfensters.
• Markdown-Format (sparsam verwenden): Nur wenn Sie wirklich den vollständigen Seiteninhalt benötigen, z. B. um einen gesamten Artikel zusammenzufassen oder die Seitenstruktur zu analysieren.

Verfügbare Tools

1. Scrape-Tool (firecrawl_scrape)

Extrahiert Inhalte von einer einzelnen URL mit erweiterten Optionen.

Am besten geeignet für:

• Extraktion von Inhalten einer einzelnen Seite, wenn Sie genau wissen, welche Seite die Informationen enthält.

Nicht empfohlen für:

• Extrahieren von Inhalten von mehreren Seiten (verwenden Sie wiederholte Scrape-Aufrufe für bekannte URLs, oder Map + Scrape, um URLs zuerst zu entdecken, oder Crawl für vollständige Seiteninhalte)
• Wenn Sie nicht sicher sind, welche Seite die Informationen enthält (verwenden Sie Suche)

Häufige Fehler:

• Übergabe einer Liste von URLs an einen einzigen Scrape-Aufruf. Rufen Sie Scrape in MCP einmal pro URL auf. Wenn Sie speziell eine Bulk-API-Operation benötigen, verwenden Sie den Firecrawl-API-Batch-Endpunkt außerhalb von MCP.
• Standardmäßige Verwendung des Markdown-Formats (verwenden Sie das JSON-Format, um nur das zu extrahieren, was Sie benötigen).

Das richtige Format wählen:

• JSON-Format (bevorzugt): Verwenden Sie für die meisten Anwendungsfälle das JSON-Format mit einem Schema, um nur die spezifischen benötigten Daten zu extrahieren. Dies hält die Antworten fokussiert und verhindert einen Überlauf des Kontextfensters.
• Markdown-Format: Nur wenn die Aufgabe wirklich den vollständigen Seiteninhalt erfordert (z. B. Zusammenfassen eines gesamten Artikels, Analysieren der Seitenstruktur).

Prompt-Beispiel:

„Produktdetails von https://example.com/product. abrufen"

Verwendungsbeispiel (JSON-Format – bevorzugt):

{
  "name": "firecrawl_scrape",
  "arguments": {
    "url": "https://example.com/product",
    "formats": [
      {
        "type": "json",
        "prompt": "Extract the product information",
        "schema": {
          "type": "object",
          "properties": {
            "name": { "type": "string" },
            "price": { "type": "number" },
            "description": { "type": "string" }
          },
          "required": ["name", "price"]
        }
      }
    ]
  }
}

Verwendungsbeispiel (Markdown-Format – wenn vollständiger Inhalt benötigt wird):

{
  "name": "firecrawl_scrape",
  "arguments": {
    "url": "https://example.com/article",
    "formats": ["markdown"],
    "onlyMainContent": true
  }
}

Verwendungsbeispiel (Branding-Format – Markenidentität extrahieren):

{
  "name": "firecrawl_scrape",
  "arguments": {
    "url": "https://example.com",
    "formats": ["branding"]
  }
}

Branding-Format: Extrahiert umfassende Markenidentität (Farben, Schriftarten, Typografie, Abstände, Logo, UI-Komponenten) für Designanalysen oder Stilreplikation. Datenschutz: Setzen Sie redactPII: true, um Inhalte mit geschwärzten personenbezogenen Daten zurückzugeben.

Rückgabe:

• JSON-strukturierte Daten, Markdown, Branding-Profil oder andere Formate wie angegeben.

2. Map-Tool (firecrawl_map)

Kartiert eine Website, um alle indizierten URLs auf der Website zu entdecken.

Am besten geeignet für:

• Entdecken von URLs auf einer Website, bevor Sie entscheiden, was gescrapt werden soll
• Finden bestimmter Abschnitte einer Website

Nicht empfohlen für:

• Wenn Sie bereits wissen, welche spezifische URL Sie benötigen (verwenden Sie Scrape)
• Wenn Sie den Inhalt der Seiten benötigen (verwenden Sie Scrape nach dem Mapping)

Häufige Fehler:

• Verwenden von Crawl zum Entdecken von URLs anstelle von Map

Prompt-Beispiel:

„Alle URLs auf example.com auflisten."

Verwendungsbeispiel:

{
  "name": "firecrawl_map",
  "arguments": {
    "url": "https://example.com"
  }
}

Rückgabe:

• Array der auf der Website gefundenen URLs

3. Such-Tool (firecrawl_search)

Durchsucht das Web und extrahiert optional Inhalte aus den Suchergebnissen.

Am besten geeignet für:

• Finden spezifischer Informationen auf mehreren Websites, wenn Sie nicht wissen, welche Website die Informationen enthält.
• Wenn Sie die relevantesten Inhalte für eine Abfrage benötigen

Nicht empfohlen für:

• Wenn Sie bereits wissen, welche Website gescrapt werden soll (verwenden Sie Scrape)
• Wenn Sie eine umfassende Abdeckung einer einzelnen Website benötigen (verwenden Sie Map oder Crawl)

Häufige Fehler:

• Verwenden von Crawl oder Map für offene Fragen (verwenden Sie stattdessen die Suche)

Verwendungsbeispiel:

{
  "name": "firecrawl_search",
  "arguments": {
    "query": "remote work stipend policies at tech companies",
    "highlights": true,
    "limit": 5,
    "lang": "en",
    "country": "us",
    "scrapeOptions": {
      "formats": ["markdown"],
      "onlyMainContent": true,
      "redactPII": true
    }
  }
}

Setzen Sie highlights auf true, um abfragerelevante Highlights anzufordern, oder false, um die ursprünglichen Suchsnippets beizubehalten. Lassen Sie es weg, um das Standardverhalten der API zu verwenden.

Für wissenschaftliche Arbeiten siehe Forschungstools: Diese durchsuchen Zusammenfassungen und Volltexte von Arbeiten, während categories: ["research"] hier normale Webergebnisse auf forschungsbezogene Websites filtert.

Rückgabe:

• Array von Suchergebnissen (mit optional gescraptem Inhalt) plus ein id-Feld. Übergeben Sie dieses id an firecrawl_search_feedback, nachdem Sie die Ergebnisse verwendet haben, um 1 Guthaben zu erstatten (Suche kostet 2) und die Suchqualität zu verbessern.

Prompt-Beispiel:

„Remote-Arbeits-Zuschussrichtlinien in Technologieunternehmen vergleichen."

3b. Such-Feedback-Tool (firecrawl_search_feedback)

Sendet strukturiertes Feedback zu einem vorherigen firecrawl_search-Ergebnis. Das erste Feedback pro Such-ID erstattet 1 Guthaben und verbessert die Suchqualität von Firecrawl. Idempotent pro Such-ID.

Rufen Sie dies nach jeder Suche auf, die Sie tatsächlich verwenden (oder die nicht geholfen hat). Schlechtes/teilweises Feedback mit missingContent ist genauso wertvoll wie gutes Feedback.

Abmelden: Setzen Sie FIRECRAWL_NO_SEARCH_FEEDBACK=1 (oder FIRECRAWL_DISABLE_SEARCH_FEEDBACK=1) in der Umgebung, wenn Sie den MCP-Server starten. Das firecrawl_search_feedback-Tool wird dann nicht registriert, sodass Agenten es nicht aufrufen können. Team-Administratoren können Feedback auch serverseitig deaktivieren; in diesem Fall ist das Tool registriert, gibt aber immer feedbackErrorCode: "TEAM_OPTED_OUT" zurück.

Wichtigstes Feld: missingContent. Es ist ein Array spezifischer Inhaltsteile, die der Agent erwartet hat zu finden, aber nicht gefunden hat. Ein Eintrag pro fehlendem Thema – diese werden teamübergreifend aggregiert und sagen uns, was als Nächstes indexiert werden soll.

Tägliches Erstattungslimit (pro Team, pro UTC-Tag, Standard 100 Guthaben). Sobald das creditsRefundedToday eines Teams dailyRefundCap erreicht, zeichnen weitere Übermittlungen weiterhin Feedback auf, erstatten aber keine Guthaben mehr. Die Antwort setzt dailyCapReached: true. Agenten sollten aufhören, dieses Tool für den Rest des UTC-Tages aufzurufen, wenn sie dieses Flag sehen.

Verwendungsbeispiel:

{
  "name": "firecrawl_search_feedback",
  "arguments": {
    "searchId": "0193f6c5-1234-7890-abcd-1234567890ab",
    "rating": "good",
    "valuableSources": [
      {
        "url": "https://docs.firecrawl.dev/features/search",
        "reason": "Most up-to-date description of /search."
      }
    ],
    "missingContent": [
      {
        "topic": "Pricing for the search endpoint",
        "description": "No pricing tier table for /search specifically."
      },
      { "topic": "Per-team rate limits" }
    ],
    "querySuggestions": "Boost docs.firecrawl.dev for queries that mention 'firecrawl'"
  }
}

Rückgabe:

• { success, feedbackId, creditsRefunded, alreadySubmitted? } JSON.

3c. Allgemeines Feedback-Tool (firecrawl_feedback)

Sendet strukturiertes Feedback für einen abgeschlossenen v2-Endpunkt-Job über /v2/feedback. Verwenden Sie dies für Endpunkt-Feedback zu scrape, parse, map oder search-Jobs. Für Suchqualität im Speziellen bevorzugen Sie firecrawl_search_feedback, da es suchspezifische Anleitungen enthält.

Halten Sie Feedback präzise: Verwenden Sie Problemcodes, Tags, kurze Notizen, URLs, Seitenzahlen und kleine Metadatenobjekte. Fügen Sie keine rohen Scrape-/Parse-Ausgaben hinzu.

Abmelden: Setzen Sie FIRECRAWL_NO_ENDPOINT_FEEDBACK=1 (oder FIRECRAWL_DISABLE_ENDPOINT_FEEDBACK=1) in der Umgebung, wenn Sie den MCP-Server starten. Das firecrawl_feedback-Tool wird dann nicht registriert, sodass Agenten es nicht aufrufen können.

Verwendungsbeispiel:

{
  "name": "firecrawl_feedback",
  "arguments": {
    "endpoint": "scrape",
    "jobId": "0193f6c5-1234-7890-abcd-1234567890ab",
    "rating": "partial",
    "issues": ["missing_markdown"],
    "tags": ["docs"],
    "note": "The pricing table was missing from the markdown output.",
    "url": "https://example.com/pricing",
    "pageNumbers": [1],
    "metadata": {
      "format": "markdown"
    }
  }
}

Rückgabe:

• { success, feedbackId, creditsRefunded, creditsRefundedToday?, dailyRefundCap?, dailyCapReached?, alreadySubmitted?, warning? } JSON.

4. Crawl-Tool (firecrawl_crawl)

Startet einen Crawl-Job, pollt, bis er einen Endzustand erreicht, und gibt den endgültigen Crawl-Status/die endgültigen Daten zurück.

Am besten geeignet für:

• Extrahieren von Inhalten von mehreren verwandten Seiten, wenn Sie eine umfassende Abdeckung benötigen.

Nicht empfohlen für:

• Extrahieren von Inhalten von einer einzelnen Seite (verwenden Sie Scrape)
• Wenn Token-Limits eine Rolle spielen (verwenden Sie Map + Scrape für engere Kontrolle)
• Wenn Sie schnelle Ergebnisse benötigen (Crawling kann langsam sein)

Warnung: Crawl-Antworten können sehr groß sein und Token-Limits überschreiten. Begrenzen Sie die Crawl-Tiefe und die Anzahl der Seiten oder verwenden Sie Map + Scrape für engere Kontrolle.

Häufige Fehler:

• Zu hohes Setzen von Limit oder maxDiscoveryDepth (verursacht Token-Überlauf)
• Verwenden von Crawl für eine einzelne Seite (verwenden Sie stattdessen Scrape)

Prompt-Beispiel:

„Alle Blog-Beiträge von den ersten beiden Ebenen von example.com/blog abrufen."

Verwendungsbeispiel:

{
  "name": "firecrawl_crawl",
  "arguments": {
    "url": "https://example.com/blog/*",
    "maxDiscoveryDepth": 2,
    "limit": 100,
    "allowExternalLinks": false,
    "deduplicateSimilarURLs": true
  }
}

Rückgabe:

• Endgültiger Crawl-Status und Daten nach internem Polling, einschließlich id, status, completed, total, creditsUsed, expiresAt, next und data. Verwenden Sie die zurückgegebene id mit firecrawl_check_crawl_status, wenn Sie den Job später erneut überprüfen müssen.

5. Crawl-Status prüfen (firecrawl_check_crawl_status)

Prüft den Status und die Ergebnisse eines bestehenden Crawl-Jobs anhand der ID.

{
  "name": "firecrawl_check_crawl_status",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Rückgabe:

• Die Antwort enthält den Status des Crawl-Jobs:

6. Parse-Tool (firecrawl_parse)

Parst lokale Dateien oder gehostete Upload-Referenzen mit dem /v2/parse-Endpunkt von Firecrawl.

Am besten geeignet für: PDFs, Word-Dokumente, Tabellenkalkulationen, HTML-Dateien und andere Dokumente, die Markdown oder strukturierte JSON-Ausgabe benötigen. Gehostetes MCP unterstützt einen zweistufigen Upload-Referenz-Ablauf; lokale direkte Dateilesevorgänge erfordern ein selbst gehostetes FIRECRAWL_API_URL.

Nicht empfohlen für: Remote-URLs (verwenden Sie Scrape), mehrere Dateien in einem Aufruf (rufen Sie Parse einmal pro Datei auf) oder reine Browser-Aktionen wie Screenshots und Klicks.

Gehosteter MCP-Ablauf: Gehostetes MCP kann das Dateisystem des Aufrufers nicht direkt lesen. Rufen Sie firecrawl_parse mit filePath auf, um einen kurzlebigen Upload-Befehl und nextToolCall zu erhalten, laden Sie die Datei lokal hoch und rufen Sie dann firecrawl_parse erneut mit der zurückgegebenen uploadRef auf. Das Erstellen der gehosteten Upload-URL erfordert Firecrawl-Authentifizierung oder Schlüssellose-Berechtigung. Im lokalen npx firecrawl-mcp-Modus erfordert das direkte Parsen von Dateien derzeit FIRECRAWL_API_URL, das auf eine selbst gehostete Firecrawl-API verweist; ein einfacher lokaler Server nur mit Cloud-API-Schlüssel kann Dateien über dieses Tool nicht lesen und hochladen.

Verwendungsbeispiel:

{
  "name": "firecrawl_parse",
  "arguments": {
    "filePath": "/absolute/path/to/document.pdf",
    "formats": ["markdown"],
    "parsers": ["pdf"],
    "zeroDataRetention": true
  }
}

Rückgabe: Analysierter Dokumentinhalt oder gehostete Upload-Anweisungen mit einer nextToolCall.

7. Strukturierte Daten mit Scrape-JSON

Für strukturierte Daten von einer bekannten Seite rufen Sie firecrawl_scrape einmal pro URL mit formats: ["json"] auf. Platzieren Sie den Extraktions-Prompt und das JSON-Schema in jsonOptions.

{
  "name": "firecrawl_scrape",
  "arguments": {
    "url": "https://example.com/product",
    "formats": ["json"],
    "jsonOptions": {
      "prompt": "Extract the product name, price, and description.",
      "schema": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "price": { "type": "number" },
          "description": { "type": "string" }
        },
        "required": ["name", "price"]
      }
    }
  }
}

Wenn die URLs nicht bekannt sind oder die Daten sich über mehrere Websites erstrecken, verwenden Sie firecrawl_agent für Multi-Quellen-Recherche.

8. Agent-Tool (firecrawl_agent)

Autonomer Web-Recherche-Agent, der strukturierte Daten zurückgibt, wenn Sie die URLs nicht kennen oder die Antwort sich über mehrere Websites erstreckt. Beschreiben Sie die benötigten Felder, übergeben Sie optional ein JSON-Schema und Start-URLs, und der Agent sucht, navigiert, liest Seiten und gibt JSON zurück, das über Quellen hinweg zusammengestellt wurde. Verwenden Sie es für eine Entität plus ihre Felder, für Listen und Datensätze und für Seiten, die Navigation benötigen, um an die Daten zu gelangen. Für eine bekannte URL verwenden Sie stattdessen firecrawl_scrape mit JSON-Format.

So funktioniert es:

Der Agent führt Websuchen durch, folgt Links, liest Seiten und sammelt Daten autonom. Dies läuft asynchron – es gibt sofort eine Job-ID zurück, und Sie pollen firecrawl_agent_status, um zu prüfen, wann er abgeschlossen ist, und Ergebnisse abzurufen.

Asynchroner Ablauf:

1. Rufen Sie firecrawl_agent mit Ihrem Prompt/Schema auf → gibt Job-ID zurück
2. Erledigen Sie andere Arbeiten, während der Agent recherchiert (kann bei komplexen Abfragen Minuten dauern)
3. Pollen Sie firecrawl_agent_status mit der Job-ID, um den Fortschritt zu prüfen
4. Wenn der Status „completed" ist, enthält die Antwort die extrahierten Daten

Am besten geeignet für:

• Komplexe Rechercheaufgaben, bei denen Sie die genauen URLs nicht kennen
• Datensammlung aus mehreren Quellen
• Finden von Informationen, die über das Web verstreut sind
• Aufgaben, bei denen Sie andere Arbeiten erledigen können, während Sie auf Ergebnisse warten

Nicht empfohlen für:

• Einfaches Scrapen einer einzelnen Seite, bei dem Sie die URL kennen (verwenden Sie Scrape mit JSON-Format – schneller und günstiger)

Argumente:

• prompt: Natürlichsprachliche Beschreibung der gewünschten Daten (erforderlich, max. 10.000 Zeichen)
• urls: Optionales Array von URLs, um den Agenten auf bestimmte Seiten zu fokussieren
• schema: Optionales JSON-Schema für strukturierte Ausgabe

Prompt-Beispiel:

„Finden Sie die Gründer von Firecrawl und ihre Hintergründe"

Verwendungsbeispiel (Agent starten, dann für Ergebnisse pollen):

{
  "name": "firecrawl_agent",
  "arguments": {
    "prompt": "Find the top 5 AI startups founded in 2024 and their funding amounts",
    "schema": {
      "type": "object",
      "properties": {
        "startups": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": { "type": "string" },
              "funding": { "type": "string" },
              "founded": { "type": "string" }
            }
          }
        }
      }
    }
  }
}

Dann pollen Sie mit firecrawl_agent_status unter Verwendung der zurückgegebenen Job-ID.

Verwendungsbeispiel (mit URLs – Agent fokussiert auf bestimmte Seiten):

{
  "name": "firecrawl_agent",
  "arguments": {
    "urls": ["https://docs.firecrawl.dev", "https://firecrawl.dev/pricing"],
    "prompt": "Compare the features and pricing information from these pages"
  }
}

Rückgabe:

• Job-ID zur Statusprüfung. Verwenden Sie firecrawl_agent_status, um für Ergebnisse zu pollen.

9. Agent-Status prüfen (firecrawl_agent_status)

Prüft den Status eines Agent-Jobs und ruft Ergebnisse ab, wenn er abgeschlossen ist. Verwenden Sie dies, um nach dem Starten eines Agenten für Ergebnisse zu pollen.

Polling-Muster: Agent-Recherche kann bei komplexen Abfragen Minuten dauern. Pollen Sie diesen Endpunkt regelmäßig (z. B. alle 10–30 Sekunden), bis der Status „completed" oder „failed" ist.

{
  "name": "firecrawl_agent_status",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Mögliche Status:

• processing: Agent recherchiert noch – später erneut prüfen
• completed: Recherche abgeschlossen – die Antwort enthält die extrahierten Daten
• failed: Ein Fehler ist aufgetreten

10. Interact-Tool (firecrawl_interact)

Interagieren Sie mit einer neuen URL oder mit einer Seite, die bereits von firecrawl_scrape geöffnet wurde. Am besten geeignet für: Klicken, Tippen, Navigieren und Extrahieren von Zuständen aus dynamischen Seiten, ohne die veralteten Browser-Tools wiederherzustellen.

Verwendungsoptionen:

• Übergeben Sie url, um eine Seite zu scrapen und für die Interaktion in einem einzigen MCP-Aufruf zu öffnen.
• Übergeben Sie scrapeId, um mit einer bereits gescrapten Seite weiter zu interagieren.
• Übergeben Sie genau eines von url oder scrapeId, plus entweder prompt oder code.

Verwendungsbeispiel:

{
  "name": "firecrawl_interact",
  "arguments": {
    "url": "https://example.com",
    "prompt": "Click the pricing link and summarize the visible plans"
  }
}

Rückgabe: Interaktionsergebnis und, im URL-Modus, das abgeleitete scrapeId für Folgeaktionen oder Bereinigung.

11. Stop-Interact-Tool (firecrawl_interact_stop)

Beenden Sie eine Interaktionssitzung für eine gescrapte Seite, wenn Sie mit der Interaktion fertig sind.

{
  "name": "firecrawl_interact_stop",
  "arguments": {
    "scrapeId": "scrape-id-here"
  }
}

12. Recherche-Tools (firecrawl_research_*)

Durchsuchen und prüfen Sie Paper und GitHub-Repositories über die Recherche-MCP-Tools.

Abdeckung: Paper-Abstracts und Volltexte aus biomedizinischer, lebenswissenschaftlicher und klinischer Literatur (PubMed, bioRxiv, medRxiv) sowie arXiv und andere wissenschaftliche Quellen.

Verfügbare Recherche-Tools:

• firecrawl_research_search_papers: Durchsucht Paper-Metadaten und Abstracts mit einer natürlichsprachlichen Abfrage, optional mit Autor-, Kategorie- und Datumsfiltern.
• firecrawl_research_inspect_paper: Ruft kanonische Metadaten für eine Paper-ID ab (arXiv, PMC, PMID oder DOI).
• firecrawl_research_related_papers: Erweitert von einem oder mehreren Anker-Papers durch den Zitationsgraphen.
• firecrawl_research_read_paper: Liest Volltextpassagen aus einem bestimmten Paper.

Am besten geeignet für: Literaturrecherche, Paper-Suche und Repository-Entdeckungs-Workflows, bei denen der Agent eine fokussierte Rechercheoberfläche statt allgemeinem Web-Scraping benötigt.

firecrawl_search mit categories: ["research"] ist eine andere Oberfläche: Sie filtert normale Webergebnisse auf forschungsbezogene Websites und gibt Seitenausschnitte zurück, keine Paper-Datensätze. Verwenden Sie diese Tools, wenn es um die Literatur selbst geht, und übergeben Sie mehrere unterschiedliche Formulierungen derselben Frage – sie liefern andere Paper als eine einzelne Abfrage.

13. Überwachungstools (firecrawl_monitor_*)

Erstellen und verwalten Sie wiederkehrende Seitenüberwachungen. Überwachungen führen geplante Scrapes oder Crawls durch, vergleichen jedes Ergebnis mit dem letzten gespeicherten Snapshot und können per Webhook oder E-Mail benachrichtigen.

Am besten geeignet für:

• Beobachten einer Seite oder weniger Seiten über einen Zeitraum
• Alarmieren bei bedeutenden Änderungen mithilfe eines Ziels in einfachem Englisch
• Verfolgen des Prüfverlaufs und von Seitenunterschieden

Empfohlenes Erstellungsmuster:

Verwenden Sie page oder pages plus goal. Der MCP-Server erstellt die Überwachungsanfrage mit einem 30-Minuten-Zeitplan, und die API aktiviert die Bewertung bedeutender Änderungen automatisch.

Die Bewertung bedeutender Änderungen läuft automatisch, wenn goal gesetzt ist. Seiten-Webhooks legen isMeaningful und judgment bei monitor.page-Ereignissen offen.

Formulieren Sie Ziele als prägnante 2-3-Satz-Überwachungsanweisungen. Geben Sie an, was einen Alarm auslösen soll, bewahren Sie jeden vom Benutzer angegebenen Umfang und fügen Sie zielspezifische Ausschlüsse nur hinzu, wenn sie aus der Anfrage offensichtlich sind. Generisches Rauschen wie Leerzeichen, reine Formatierungsänderungen, Anfrage-IDs, Tracking-Parameter, generische Metadaten und nicht zusammenhängende Seitenumgebungen werden bereits vom Bewertungsmodul behandelt – wiederholen Sie dies also nicht in jedem Ziel. Wenn der Benutzer vage ist, halten Sie das Ziel breit; wenn er breite Überwachung oder „jede Änderung“ wünscht, bewahren Sie das. Wenn der Benutzer sagt, dass ihm etwas egal ist, nehmen Sie das ausdrücklich auf.

{
  "name": "firecrawl_monitor_create",
  "arguments": {
    "page": "https://example.com/pricing",
    "goal": "Alert when pricing, packaging, or launch messaging changes."
  }
}

Mehrere Seiten mit Webhooks:

{
  "name": "firecrawl_monitor_create",
  "arguments": {
    "pages": ["https://example.com/pricing", "https://example.com/changelog"],
    "goal": "Alert when pricing, packaging, or launch messaging changes.",
    "webhookUrl": "https://example.com/webhooks/firecrawl"
  }
}

Erweiterte Erstellungsanfragen:

Übergeben Sie body, wenn Sie Crawl-Ziele, JSON-Änderungsverfolgung, benutzerdefinierte Aufbewahrung oder explizite judgeEnabled-Steuerung benötigen.

{
  "name": "firecrawl_monitor_create",
  "arguments": {
    "body": {
      "name": "Docs monitor",
      "schedule": { "text": "hourly", "timezone": "UTC" },
      "goal": "Alert when docs pages add, remove, or materially change API behavior.",
      "targets": [{ "type": "crawl", "url": "https://example.com/docs" }]
    }
  }
}

Andere Überwachungstools:

• firecrawl_monitor_list: Überwachungen auflisten.
• firecrawl_monitor_get: Eine Überwachung abrufen.
• firecrawl_monitor_update: Felder aktualisieren, einschließlich goal, judgeEnabled, webhook und notification.
• firecrawl_monitor_run: Jetzt eine Prüfung auslösen.
• firecrawl_monitor_delete: Eine Überwachung löschen (zerstörerisch; nur aufrufen, wenn der Benutzer sie entfernen möchte).
• firecrawl_monitor_checks: Prüfungen auflisten, optional nach Status gefiltert.
• firecrawl_monitor_check: Seitenbezogene Ergebnisse abrufen, einschließlich diff, snapshot, judgment.meaningful und judgment.meaningfulChanges.

14. Entwickler-Suchtool (firecrawl_developer_search)

Durchsucht einen Index, der für Codierungsagenten erstellt wurde. Der Index umfasst GitHub-Issues, zusammengeführte Pull-Requests, Repository-READMEs und kuratierte Dokumentationsseiten.

Am besten geeignet für: Eine Programmierfrage – Codeverhalten, eine Bibliothek oder ein Framework, einen API-Vertrag, eine Fehlermeldung oder einen bekannten Fehler.

Argumente:

{
  "name": "firecrawl_developer_search",
  "arguments": {
    "query": "how do I configure retries",
    "k": 10,
    "skills": "only"
  }
}

• query (erforderlich): die Entwicklerfrage oder der Suchbegriff.
• k: Anzahl der rangierten Ergebnisse. Der Standardwert ist 10 und das Maximum ist 100.
• skills: auf "only" setzen, um nur Agenten-Fähigkeitsdateien zu durchsuchen.

Rückgabe: Rangierte Ergebnisse. Jedes Ergebnis trägt eine ID, einen Quelltyp (issue, pull_request, readme oder doc), eine URL, einen Titel und die übereinstimmenden Passagen in Markdown.

firecrawl_search mit categories: ["developer"] durchsucht denselben Index neben den Webergebnissen. Verwenden Sie stattdessen dieses Tool, wenn Sie die übereinstimmenden Passagen, den skills-Filter oder keine Webergebnisse in der Antwort wünschen. Der suchspezifische Endpunkt legt beide Tools offen, und dieselbe Wahl gilt dort.

Protokollierungssystem

Der Server enthält umfassende Protokollierung:

• Betriebsstatus und Fortschritt
• Leistungsmetriken
• Ratenlimit-Verfolgung
• Fehlerbedingungen

Beispiel-Protokollmeldungen:

[INFO] Firecrawl MCP Server initialized successfully
[INFO] Starting scrape for URL: https://example.com
[ERROR] Rate limit exceeded

Fehlerbehandlung

Der Server bietet eine robuste Fehlerbehandlung:

• API-Ratenlimit-Fehler werden an den MCP-Client weitergegeben
• Detaillierte Fehlermeldungen
• Netzwerk-Resilienz

Beispiel-Fehlerantwort:

{
  "content": [
    {
      "type": "text",
      "text": "Error: Rate limit exceeded"
    }
  ],
  "isError": true
}

Entwicklung

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

Mitwirken

1. Forken Sie das Repository
2. Erstellen Sie Ihren Feature-Branch
3. Führen Sie Tests aus: npm test
4. Reichen Sie einen Pull-Request ein

Dank an Mitwirkende

Dank an @vrknetha, @cawstudios für die ursprüngliche Implementierung!

Dank an MCP.so und Klavis AI für das Hosting und an @gstarwd, @xiangkaiz und @zihaolin96 für die Integration unseres Servers.

Lizenz

MIT-Lizenz – siehe LICENSE-Datei für Details