Les commandes à connaître pour utiliser Firecrawl depuis Claude Code ou Codex : rechercher sur le web, récupérer une page en Markdown propre, cartographier ou parcourir un site entier. Firecrawl s’utilise via une skill + CLI, ou via un serveur MCP.

Installation

# Skill + CLI pour Claude Code, Cursor, OpenCode… (redémarrer l'agent ensuite)
npx -y firecrawl-cli@latest init --all --browser
 
# Se connecter (1 000 crédits offerts à l'inscription)
firecrawl login --browser
firecrawl --status        # vérifie l'authentification et les crédits restants

Serveur MCP (alternative) :

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

Commandes principales

CommandeCe qu’elle faitCoût indicatif
firecrawl search "requête" --limit 5Cherche sur le web et renvoie le contenu des résultats (--scrape pour le contenu complet).1 crédit par requête
firecrawl scrape <url>Récupère une page en Markdown propre.1 crédit par page
firecrawl scrape <url> --only-main-contentRetire menus, pieds de page et publicités.1 crédit
firecrawl scrape <url> --format markdown,links -o page.jsonPlusieurs formats en JSON, sauvegardés dans un fichier.1 crédit
firecrawl scrape <url> --schema schema.jsonExtrait des données structurées selon un schéma.—
firecrawl map <url> --search "pricing"Liste les URL d’un site, triées par pertinence, sans les récupérer.faible
firecrawl crawl <url> --limit 100 --max-depth 2 --waitParcourt un site entier et récupère toutes les pages.1 crédit par page
firecrawl interact exec --prompt "Clique sur le premier résultat"Agit sur une page déjà récupérée, en langage naturel.—
firecrawl agent "tâche de recherche" --max-credits 50Recherche autonome sur plusieurs pages, avec plafond de crédits.variable
firecrawl monitor create …Surveille les changements d’une page.—

Options utiles : --wait-for (attendre le rendu JavaScript), --include-paths (limiter le crawl), --pretty (JSON lisible), --api-url (instance auto-hébergée).

Outils MCP (si tu utilises le serveur MCP)

OutilQuand l’utiliser
firecrawl_scrapeURL connue, contenu en Markdown ou en JSON selon un schéma.
firecrawl_searchRecherche web avec contenu des résultats.
firecrawl_mapDécouvrir les URL d’un site avant de crawler.
firecrawl_crawlPlusieurs pages d’un même site, avec limites.

Choisir la bonne commande

BesoinCommande
Je connais l’URLscrape
Je cherche une information sur le websearch
Je veux savoir ce que contient un sitemap
Je veux tout le contenu d’une sectionmap puis crawl avec --include-paths
Je dois cliquer ou remplir avant de lirescrape puis interact

Conseils d’utilisation

  • Toujours map avant crawl : tu sais combien de pages (donc de crédits) le crawl va consommer.
  • Borner les crawls avec --limit, --max-depth et --include-paths.
  • --only-main-content par défaut : moins de bruit, moins de tokens dans le contexte de Claude.
  • Préférer la skill au serveur MCP si tu veux économiser du contexte : une skill se charge à la demande, un serveur MCP déclare tous ses outils dès le début.
  • Attention à la facturation d’Extract : l’extraction structurée par IA a une facturation séparée des crédits, source fréquente de mauvaises surprises.
  • Plafonner agent avec --max-credits : la recherche autonome peut visiter beaucoup de pages.

Sources