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
• Prise en charge du cloud et de l’auto‑hébergement
• Prise en charge de l’HTTP en streaming

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

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

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

npm install -g firecrawl-mcp

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/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é, fonctionne sans clé API)
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp

# Avec une clé API, envoyez-la dans un header Authorization
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp --header "Authorization: Bearer fc-your-api-key"

# Ou exécuter localement via npx
claude mcp add firecrawl -e FIRECRAWL_API_KEY=fc-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 :

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

6. Définissez Server Transport sur HTTP Streamable
7. Définissez Authentication sur Bearer et collez votre clé API Firecrawl, ou laissez None pour utiliser le palier gratuit sans clé
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)

export FIRECRAWL_API_KEY=your-api-key

export FIRECRAWL_API_URL=https://firecrawl.your-domain.com
export FIRECRAWL_API_KEY=your-api-key  # Si votre instance requiert une authentification

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

• Le mode keyless hébergé n’expose que les outils pris en charge en mode keyless et est soumis à une limitation de débit par IP.
• La lecture de fichiers locaux n’est disponible que lorsque vous exécutez le serveur MCP localement.
• Les Webhooks et les chemins de fichiers locaux doivent être configurés à partir d’un serveur MCP local ou self-hosted lorsque l’agent doit accéder à des ressources locales.

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

• Passez url pour ouvrir une nouvelle page et interagir avec elle en un seul appel MCP.
• Passez scrapeId depuis un appel firecrawl_scrape précédent pour réutiliser la page déjà chargée.

{
  "name": "firecrawl_interact",
  "arguments": {
    "url": "https://example.com/products",
    "prompt": "Click on the first product and tell me its price"
  }
}

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

• url : Page avec laquelle interagir ; ouvre la session pour vous. Utilisez ceci ou scrapeId.
• scrapeId : L’ID de tâche d’une tâche de scraping issue d’un appel précédent à firecrawl_scrape. Utilisez ceci ou url.
• 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).
• scrapeOptions : Options de scraping facultatives, utilisées uniquement avec le mode url.

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