Serveur MCP Firecrawl

• Recherche sur le web et récupération du contenu complet des pages
• Extraction de n’importe quelle URL en données structurées propres
• Analyse de fichiers locaux tels que des PDF, DOCX, XLSX et HTML
• Interaction avec les pages — cliquer, naviguer et effectuer des actions
• Recherche approfondie avec agent autonome
• Gestion des sessions de navigateur
• Prise en charge du cloud et de l’auto‑hébergement
• Prise en charge du streaming HTTP

https://mcp.firecrawl.dev/{FIRECRAWL_API_KEY}/v2/mcp

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

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

​

Installation manuelle

npm install -g firecrawl-mcp

1. Ouvrez les paramètres de Cursor
2. Allez dans Features > MCP Servers
3. Cliquez sur ”+ Add new global MCP server”
4. Saisissez le code suivant :
   {
     "mcpServers": {
       "firecrawl-mcp": {
         "command": "npx",
         "args": ["-y", "firecrawl-mcp"],
         "env": {
           "FIRECRAWL_API_KEY": "YOUR-API-KEY"
         }
       }
     }
   }
   

1. Ouvrez les paramètres de Cursor
2. Allez dans Features > MCP Servers
3. Cliquez sur ”+ Add New MCP Server”
4. Renseignez les éléments suivants :
   • Name: “firecrawl-mcp” (ou le nom de votre choix)
   • Type: “command”
   • Command: env FIRECRAWL_API_KEY=your-api-key npx -y firecrawl-mcp

Si vous utilisez Windows et rencontrez des problèmes, essayez cmd /c "set FIRECRAWL_API_KEY=your-api-key && npx -y firecrawl-mcp"

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

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

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

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

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

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

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

# URL hébergée à distance (recommandé)
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/your-api-key/v2/mcp

# Ou exécuter localement via npx
claude mcp add firecrawl -e FIRECRAWL_API_KEY=your-api-key -- npx -y firecrawl-mcp

1. Ouvrez la barre latérale Agent dans l’Editor ou la vue Agent Manager
2. Cliquez sur le menu « … » (More Actions) et sélectionnez MCP Servers
3. Sélectionnez View raw config pour ouvrir votre fichier local mcp_config.json
4. Ajoutez la configuration suivante :

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

5. Enregistrez le fichier et cliquez sur Refresh dans l’interface MCP d’Antigravity pour voir les nouveaux outils.

1. Récupérez votre clé API Firecrawl à partir de https://firecrawl.dev/app/api-keys
2. Dans votre workflow n8n, ajoutez un nœud AI Agent
3. Dans la configuration du nœud AI Agent, ajoutez un nouveau Tool
4. Sélectionnez MCP Client Tool comme type d’outil
5. Saisissez l’Endpoint du serveur MCP (remplacez {YOUR_FIRECRAWL_API_KEY} par votre clé API) :

  https://mcp.firecrawl.dev/{YOUR_FIRECRAWL_API_KEY}/v2/mcp

6. Définissez Server Transport sur HTTP Streamable
7. Définissez Authentication sur None
8. Pour Tools to include, vous pouvez sélectionner All, Selected ou All Except – cela rendra disponibles les outils Firecrawl (scrape, crawl, map, search, extract, etc.)

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

• FIRECRAWL_API_KEY : votre clé API Firecrawl
  • Requise lors de l’utilisation de l’API cloud (par défaut)
  • Facultative lors de l’utilisation d’une instance auto-hébergée avec FIRECRAWL_API_URL
• FIRECRAWL_API_URL (facultatif) : point de terminaison API personnalisé pour les instances auto-hébergées
  • Exemple : https://firecrawl.your-domain.com
  • Si elle n’est pas renseignée, l’API cloud sera utilisée (nécessite une clé API)

• FIRECRAWL_RETRY_MAX_ATTEMPTS: Nombre maximal de tentatives de relance (par défaut : 3)
• FIRECRAWL_RETRY_INITIAL_DELAY: Délai initial en millisecondes avant la première relance (par défaut : 1000)
• FIRECRAWL_RETRY_MAX_DELAY: Délai maximal en millisecondes entre les relances (par défaut : 10000)
• FIRECRAWL_RETRY_BACKOFF_FACTOR: Facteur de backoff exponentiel (par défaut : 2)

• FIRECRAWL_CREDIT_WARNING_THRESHOLD: Seuil d’avertissement pour l’utilisation des crédits (par défaut : 1000)
• FIRECRAWL_CREDIT_CRITICAL_THRESHOLD: Seuil critique pour l’utilisation des crédits (par défaut : 100)

# Requis pour l’API cloud
export FIRECRAWL_API_KEY=your-api-key

# Paramètres de nouvelle tentative (facultatif)
export FIRECRAWL_RETRY_MAX_ATTEMPTS=5        # Augmenter le nombre maximal de tentatives
export FIRECRAWL_RETRY_INITIAL_DELAY=2000    # Commencer avec un délai de 2 s
export FIRECRAWL_RETRY_MAX_DELAY=30000       # Délai maximal de 30 s
export FIRECRAWL_RETRY_BACKOFF_FACTOR=3      # Backoff plus agressif

# Surveillance des crédits (facultatif)
export FIRECRAWL_CREDIT_WARNING_THRESHOLD=2000    # Avertissement à 2000 crédits
export FIRECRAWL_CREDIT_CRITICAL_THRESHOLD=500    # Seuil critique à 500 crédits

# Requis pour l’auto‑hébergement
export FIRECRAWL_API_URL=https://firecrawl.your-domain.com

# Authentification facultative pour l’auto‑hébergement
export FIRECRAWL_API_KEY=your-api-key  # Si votre instance requiert une authentification

# Configuration personnalisée des tentatives
export FIRECRAWL_RETRY_MAX_ATTEMPTS=10
export FIRECRAWL_RETRY_INITIAL_DELAY=500     # Démarrer avec des tentatives plus rapides

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

        "FIRECRAWL_RETRY_MAX_ATTEMPTS": "5",
        "FIRECRAWL_RETRY_INITIAL_DELAY": "2000",
        "FIRECRAWL_RETRY_MAX_DELAY": "30000",
        "FIRECRAWL_RETRY_BACKOFF_FACTOR": "3",

        "FIRECRAWL_CREDIT_WARNING_THRESHOLD": "2000",
        "FIRECRAWL_CREDIT_CRITICAL_THRESHOLD": "500"
      }
    }
  }
}

const CONFIG = {
  retry: {
    maxAttempts: 3, // Number of retry attempts for rate-limited requests
    initialDelay: 1000, // Initial delay before first retry (in milliseconds)
    maxDelay: 10000, // Maximum delay between retries (in milliseconds)
    backoffFactor: 2, // Multiplier for exponential backoff
  },
  credit: {
    warningThreshold: 1000, // Warn when credit usage reaches this level
    criticalThreshold: 100, // Alerte critique lorsque l'utilisation des crédits atteint ce niveau
  },
};

1. Comportement de réessai
   • Réessaie automatiquement les requêtes ayant échoué à cause des limites de débit
   • Utilise un backoff exponentiel pour éviter de surcharger l’API
   • Exemple : avec les paramètres par défaut, les réessais seront effectués aux intervalles suivants :
     • 1ʳᵉ tentative de réessai : délai de 1 seconde
     • 2ᵉ tentative de réessai : délai de 2 secondes
     • 3ᵉ tentative de réessai : délai de 4 secondes (plafonné par maxDelay)
2. Suivi de la consommation de crédits
   • Suit la consommation de crédits de l’API pour l’utilisation de l’API cloud
   • Fournit des avertissements à des seuils définis
   • Aide à éviter les interruptions de service inattendues
   • Exemple : avec les paramètres par défaut :
     • Avertissement à 1 000 crédits restants
     • Alerte critique à 100 crédits restants

• Gestion automatique de la limitation de débit avec backoff exponentiel
• Traitement parallèle efficace pour les opérations par lots
• Mise en file d’attente et régulation intelligente des requêtes
• Réessais automatiques en cas d’erreurs transitoires

{
  "name": "firecrawl_scrape",
  "arguments": {
    "url": "https://example.com",
    "formats": ["markdown"],
    "onlyMainContent": true,
    "waitFor": 1000,
    "mobile": false,
    "includeTags": ["article", "main"],
    "excludeTags": ["nav", "footer"],
    "skipTlsVerification": false
  }
}

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

{
  "name": "firecrawl_map",
  "arguments": {
    "url": "https://example.com",
    "search": "blog",
    "sitemap": "include",
    "includeSubdomains": false,
    "limit": 100,
    "ignoreQueryParameters": true
  }
}

• url: L’URL de base du site web à cartographier
• search: Terme de recherche facultatif pour filtrer les URL
• sitemap: Contrôle l’utilisation du sitemap : « include », « skip » ou « only »
• includeSubdomains: Indique s’il faut inclure les sous-domaines dans la cartographie
• limit: Nombre maximal d’URL à retourner
• ignoreQueryParameters: Indique s’il faut ignorer les paramètres de requête lors de la cartographie

{
  "name": "firecrawl_search",
  "arguments": {
    "query": "votre requête de recherche",
    "limit": 5,
    "location": "United States",
    "tbs": "qdr:m",
    "scrapeOptions": {
      "formats": ["markdown"],
      "onlyMainContent": true
    }
  }
}

• query : chaîne de requête de recherche (obligatoire)
• limit : nombre maximal de résultats à retourner
• location : emplacement géographique pour les résultats de recherche
• tbs : filtre temporel de recherche (par exemple, qdr:d pour les dernières 24 heures, qdr:w pour la dernière semaine, qdr:m pour le dernier mois)
• filter : filtre de recherche supplémentaire
• sources : tableau des types de sources à interroger (web, images, news)
• scrapeOptions : options de scraping des pages de résultats de recherche
• enterprise : tableau d’options d’entreprise (default, anon, zdr)

{
  "name": "firecrawl_parse",
  "arguments": {
    "filePath": "/absolute/path/to/report.pdf",
    "formats": ["markdown"]
  }
}

1. Appelez firecrawl_parse avec filePath. L’outil renvoie une commande d’upload préremplie et un nextToolCall contenant un uploadRef.
2. Exécutez la commande d’upload sur la machine qui peut lire le fichier, puis appelez à nouveau firecrawl_parse avec l’uploadRef renvoyé.

• filePath : Chemin local vers le fichier que vous souhaitez analyser. À utiliser pour le premier appel.
• uploadRef : Référence renvoyée par le premier appel hosted-MCP. À utiliser pour le second appel une fois le téléversement terminé.
• formats : Formats de sortie. Valeur par défaut : markdown.
• parsers : Paramètres du parseur, comme les options d’analyse PDF.
• contentType : Remplacement facultatif du type MIME du fichier.
• declaredSizeBytes : Indication facultative de la taille du fichier. Les fichiers sont limités à 50 Mo.

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

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

{
  "name": "firecrawl_extract",
  "arguments": {
    "urls": ["https://example.com/page1", "https://example.com/page2"],
    "prompt": "Extract product information including name, price, and description",
    "schema": {
      "type": "object",
      "properties": {
        "name": { "type": "string" },
        "price": { "type": "number" },
        "description": { "type": "string" }
      },
      "required": ["name", "price"]
    },
    "allowExternalLinks": false,
    "enableWebSearch": false,
    "includeSubdomains": false
  }
}

{
  "content": [
    {
      "type": "text",
      "text": {
        "name": "Example Product",
        "price": 99.99,
        "description": "This is an example product description"
      }
    }
  ],
  "isError": false
}

• urls: Liste d’URL à partir desquelles extraire des informations
• prompt: Prompt personnalisé pour l’extraction par le LLM
• schema: Schéma JSON pour l’extraction de données structurées
• allowExternalLinks: Autoriser l’extraction à partir de liens externes
• enableWebSearch: Activer la recherche sur le web pour obtenir un contexte supplémentaire
• includeSubdomains: Inclure les sous-domaines dans l’extraction

{
  "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" }
            }
          }
        }
      }
    }
  }
}

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

• prompt: Description en langage naturel des données dont vous avez besoin (obligatoire, 10 000 caractères maximum)
• urls: Tableau optionnel d’URL pour concentrer l’agent sur des pages spécifiques
• schema: Schéma JSON optionnel pour une sortie structurée

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

• id: L’ID de tâche d’agent renvoyé par firecrawl_agent (obligatoire)

• processing: L’agent est encore en cours de recherche — continuer à interroger
• completed: Recherche terminée — la réponse inclut les données extraites
• failed: Une erreur s’est produite

{
  "name": "firecrawl_browser_create",
  "arguments": {
    "ttl": 120,
    "activityTtl": 60
  }
}

• ttl : Durée de vie totale de la session en secondes (30-3600, facultatif)
• activityTtl : Délai d’inactivité en secondes (10-3600, facultatif)

{
  "name": "firecrawl_browser_execute",
  "arguments": {
    "sessionId": "session-id-here",
    "code": "agent-browser open https://example.com",
    "language": "bash"
  }
}

{
  "name": "firecrawl_browser_execute",
  "arguments": {
    "sessionId": "session-id-here",
    "code": "await page.goto('https://example.com')\ntitle = await page.title()\nprint(title)",
    "language": "python"
  }
}

• sessionId: L’ID de session du navigateur (obligatoire)
• code: Le code à exécuter (obligatoire)
• language: bash, python ou node (optionnel, bash par défaut)

• agent-browser open <url> — Accéder à l’URL
• agent-browser snapshot — Récupérer l’arbre d’accessibilité avec références cliquables
• agent-browser click @e5 — Cliquer sur un élément par référence issue du snapshot
• agent-browser type @e3 "text" — Saisir du texte dans l’élément
• agent-browser screenshot [path] — Prendre une capture d’écran
• agent-browser scroll down — Faire défiler la page vers le bas
• agent-browser wait 2000 — Attendre 2 secondes

{
  "name": "firecrawl_browser_delete",
  "arguments": {
    "sessionId": "session-id-here"
  }
}

• sessionId: L’ID de session navigateur à supprimer (obligatoire)

{
  "name": "firecrawl_browser_list",
  "arguments": {
    "status": "active"
  }
}

• status: Filtrer par statut de session — active ou destroyed (optionnel)

{
  "name": "firecrawl_interact",
  "arguments": {
    "scrapeId": "scrape-id-from-previous-scrape",
    "prompt": "Click the Sign In button"
  }
}

• scrapeId : L’ID de tâche d’une tâche de scraping issue d’un appel précédent à firecrawl_scrape (obligatoire)
• prompt : Instruction en langage naturel décrivant l’action à effectuer (fournissez prompt ou code)
• code : Code à exécuter dans la session de navigateur (fournissez code ou prompt)
• language : bash, python ou node (facultatif, valeur par défaut : node, utilisé uniquement avec code)
• timeout : Délai d’exécution maximal, en secondes, de 1 à 300 (facultatif, valeur par défaut : 30)

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

• scrapeId : l’ID du scrape de la session à arrêter (obligatoire)

• État et progression des opérations
• Indicateurs de performance
• Suivi de l’utilisation des crédits
• Suivi des limites de débit
• Conditions d’erreur

[INFO] Firecrawl MCP Server initialized successfully
[INFO] Starting scrape for URL: https://example.com
[INFO] Starting crawl for URL: https://example.com
[WARNING] L'utilisation des crédits a atteint le seuil d'alerte
[ERROR] Rate limit exceeded, retrying in 2s...

• Nouveaux essais automatiques en cas d’erreurs transitoires
• Gestion des limites de débit avec backoff
• Messages d’erreur détaillés
• Alertes sur l’utilisation des crédits
• Résilience du réseau

{
  "content": [
    {
      "type": "text",
      "text": "Erreur : Limite de débit dépassée. Nouvelle tentative dans 2 secondes..."
    }
  ],
  "isError": true
}

# Installer les dépendances
npm install

# Build
npm run build

# Run tests
npm test

1. Créez un fork du dépôt
2. Créez une branche pour votre fonctionnalité
3. Exécutez les tests : npm test
4. Ouvrez une pull request