Skills + CLI

Les skills Firecrawl permettent simplement aux agents IA comme Claude Code, Antigravity et OpenCode d’utiliser Firecrawl via la CLI.

Recherchez, scrapez, interagissez, lancez des crawls, cartographiez et exécutez des jobs d’agent directement depuis le terminal. Le CLI Firecrawl fonctionne seul ou avec des skills que des agents IA de développement comme Claude Code, Antigravity et OpenCode peuvent découvrir et utiliser automatiquement.

​

Installation

Si vous utilisez un agent IA comme Claude Code, vous pouvez installer les skills Firecrawl ci-dessous et l’agent les configurera pour vous.

npx -y firecrawl-cli@latest init --all --browser

• --all installe tous les segments de skills Firecrawl (CLI, build, workflows) sur tous les agents de codage IA détectés
• --browser ouvre automatiquement le navigateur pour l’authentification Firecrawl

Après avoir installé les skills, redémarrez votre agent pour qu’il les détecte.

Vous pouvez également installer manuellement la CLI Firecrawl au niveau global avec npm :

CLI

# Installer globalement avec npm
npm install -g firecrawl-cli

​

Authentification

Avant d’utiliser la CLI, vous devez vous authentifier avec votre clé API Firecrawl.

Certaines commandes CLI fonctionnent sans vous connecter. Si aucune clé API n’est configurée, les commandes prises en charge utilisent le niveau gratuit sans clé — gratuit, mais limité par IP. Voir Limites de débit pour la liste actuelle des commandes sans clé et les points à connaître. Inscrivez-vous pour obtenir une clé gratuite et bénéficier de 1 000 crédits ainsi que de limites plus élevées ; la CLI l’utilise automatiquement une fois configurée.

​

Connexion

CLI

# Interactive login (opens browser or prompts for API key)
firecrawl login

# Connexion avec authentification par navigateur (recommandé pour les agents)
firecrawl login --browser

# Login with API key directly
firecrawl login --api-key fc-YOUR-API-KEY

# Or set via environment variable
export FIRECRAWL_API_KEY=fc-YOUR-API-KEY

​

Afficher la configuration

CLI

# Voir la configuration actuelle et le statut d'authentification
firecrawl view-config

​

Déconnexion

CLI

# Effacer les identifiants enregistrés
firecrawl logout

​

Auto-hébergé / Développement local

Pour les instances Firecrawl auto-hébergées ou le développement local, utilisez l’option --api-url :

CLI

# Utiliser une instance locale de Firecrawl (aucune clé API requise)
firecrawl --api-url http://localhost:3002 scrape https://example.com

# Or set via environment variable
export FIRECRAWL_API_URL=http://localhost:3002
firecrawl scrape https://example.com

# Configure and persist the custom API URL
firecrawl config --api-url http://localhost:3002

Lorsque vous utilisez une URL d’API personnalisée (toute URL différente de https://api.firecrawl.dev), l’authentification par clé d’API est automatiquement contournée, ce qui vous permet d’utiliser des instances locales sans clé d’API.

​

Vérifier l’état

Vérifiez l’installation, l’authentification et affichez les limites de débit :

CLI

firecrawl --status

Sortie une fois prête :

  🔥 firecrawl cli v1.16.2

  ● Authenticated via FIRECRAWL_API_KEY
  Concurrency: 0/100 jobs (parallel scrape limit)
  Credits: 500,000 remaining

• Concurrence : Nombre maximal de tâches en parallèle. Exécutez des opérations parallèles au plus près de cette limite, sans la dépasser.
• Crédits : Crédits API restants. Chaque opération de scrape/crawl consomme des crédits.

​

Commandes

La commande masquée firecrawl browser est dépréciée pour les workflows d’agents. Utilisez d’abord firecrawl scrape <url>, puis firecrawl interact ... avec la session de scrape ainsi obtenue.

​

Scrape

Analysez une seule URL et extrayez son contenu dans différents formats.

Utilisez --only-main-content pour obtenir un résultat propre sans navigation, pied de page ni publicités. C’est recommandé pour la plupart des cas d’usage où vous souhaitez uniquement l’article ou le contenu principal de la page.

CLI

# Scraper une URL (par défaut : sortie markdown)
firecrawl https://example.com

# Ou utiliser la commande scrape explicite
firecrawl scrape https://example.com

# Recommandé : utiliser --only-main-content pour une sortie propre sans nav/footer
firecrawl https://example.com --only-main-content

​

Formats de sortie

CLI

# Get HTML output
firecrawl https://example.com --html

# Multiple formats (returns JSON)
firecrawl https://example.com --format markdown,links

# Get images from a page
firecrawl https://example.com --format images

# Get a summary of the page content
firecrawl https://example.com --format summary

# Track changes on a page
firecrawl https://example.com --format changeTracking

# Formats disponibles : markdown, html, rawHtml, links, screenshot, json, images, summary, changeTracking, attributes, branding, product

​

Options de Scrape

CLI

# Extraire uniquement le contenu principal (supprime les menus de navigation, pieds de page)
firecrawl https://example.com --only-main-content

# Wait for JavaScript rendering
firecrawl https://example.com --wait-for 3000

# Take a screenshot
firecrawl https://example.com --screenshot

# Extraire du JSON structuré avec un schéma
firecrawl https://example.com --format json --schema '{"type":"object","properties":{"title":{"type":"string"}}}'

# Exécuter des actions de scrape légères avant l'extraction
firecrawl https://example.com --actions '[{"type":"wait","milliseconds":1000}]'

# Sélectionner le mode proxy
firecrawl https://example.com --proxy basic

# Anonymiser les informations personnellement identifiables
firecrawl https://example.com --redact-pii

# Include/exclude specific HTML tags
firecrawl https://example.com --include-tags article,main
firecrawl https://example.com --exclude-tags nav,footer

# Save output to file
firecrawl https://example.com -o output.md

# Pretty print JSON output
firecrawl https://example.com --format markdown,links --pretty

# Force JSON output even with single format
firecrawl https://example.com --json

# Show request timing information
firecrawl https://example.com --timing

Options disponibles :

Option	Forme courte	Description
--url <url>	-u	URL à Scrape (alternative à l’argument positionnel)
--format <formats>	-f	formats de sortie (séparés par des virgules) : markdown, html, rawHtml, links, screenshot, json, images, summary, suiviDesModifications, attributes, branding
--html	-H	Raccourci pour --format html
--only-main-content		Extraire uniquement le contenu principal
--wait-for <ms>		Temps d’attente en millisecondes pour le rendu JS
--screenshot		Prendre une capture d’écran
--full-page-screenshot		Prendre une capture d’écran de la page entière
--include-tags <tags>		Balises HTML à inclure (séparées par des virgules)
--exclude-tags <tags>		Balises HTML à exclure (séparées par des virgules)
--schema <json>		Schéma JSON pour l’extraction structurée
--schema-file <path>		Chemin du fichier de schéma JSON
--actions <json>		Tableau JSON des actions à exécuter pendant le Scrape
--actions-file <path>		Chemin du fichier JSON des actions
--proxy <proxy>		Mode proxy pour le Scrape (par exemple, auto ou basic)
--redact-pii		Masquer les informations personnellement identifiables dans le contenu renvoyé
--output <path>	-o	Enregistrer la sortie dans un fichier
--json		Forcer la sortie JSON même avec un seul format
--pretty		Afficher la sortie JSON de manière lisible
--timing		Afficher le temps de la requête et d’autres informations utiles

---

​

Recherche

Recherchez sur le Web et, si besoin, extrayez le contenu des résultats.

CLI

# Search the web
firecrawl search "web scraping tutorials"

# Limit results
firecrawl search "AI news" --limit 10

# Afficher les résultats avec formatage
firecrawl search "machine learning" --pretty

​

Options de recherche

CLI

# Search specific sources
firecrawl search "AI" --sources web,news,images

# Search with category filters
firecrawl search "react hooks" --categories github
firecrawl search "machine learning" --categories research,pdf

# Time-based filtering
firecrawl search "tech news" --tbs qdr:h   # Last hour
firecrawl search "tech news" --tbs qdr:d   # Last day
firecrawl search "tech news" --tbs qdr:w   # Dernière semaine
firecrawl search "tech news" --tbs qdr:m   # Last month
firecrawl search "tech news" --tbs qdr:y   # Last year

# Location-based search
firecrawl search "restaurants" --location "Berlin,Germany" --country DE

# Search and scrape results
firecrawl search "documentation" --scrape --scrape-formats markdown

# Save to file
firecrawl search "firecrawl" --pretty -o results.json

Options disponibles :

Option	Description
--limit <number>	Nombre maximal de résultats (par défaut : 5, max : 100)
--sources <sources>	Sources à interroger : web, images, news (séparées par des virgules)
--categories <categories>	Filtrer par catégorie : github, research, pdf (séparées par des virgules)
--tbs <value>	Filtre temporel : qdr:h (heure), qdr:d (jour), qdr:w (semaine), qdr:m (mois), qdr:y (année)
--location <location>	Ciblage géographique (p. ex. “Berlin,Germany”)
--country <code>	Code de pays ISO (par défaut : US)
--timeout <ms>	Délai d’expiration en millisecondes (par défaut : 60000)
--ignore-invalid-urls	Exclure les URL invalides pour d’autres endpoints Firecrawl
--scrape	Scraper les résultats de recherche
--scrape-formats <formats>	Formats pour le contenu extrait (par défaut : markdown)
--only-main-content	Inclure uniquement le contenu principal lors du scraping (par défaut : true)
--json	Résultat au format JSON
--output <path>	Enregistrer le résultat dans un fichier
--pretty	Affichage JSON formaté

---

​

Map

Découvrez rapidement toutes les URL d’un site.

CLI

# Découvrir toutes les URL d'un site web
firecrawl map https://example.com

# Output as JSON
firecrawl map https://example.com --json

# Limit number of URLs
firecrawl map https://example.com --limit 500

​

Options de la commande Map

CLI

# Filter URLs by search query
firecrawl map https://example.com --search "blog"

# Include subdomains
firecrawl map https://example.com --include-subdomains

# Contrôler l'utilisation du sitemap
firecrawl map https://example.com --sitemap include   # Utiliser le sitemap
firecrawl map https://example.com --sitemap skip      # Ignorer le sitemap
firecrawl map https://example.com --sitemap only      # Utiliser uniquement le sitemap

# Ignore query parameters (dedupe URLs)
firecrawl map https://example.com --ignore-query-parameters

# Wait for map to complete with timeout
firecrawl map https://example.com --wait --timeout 60

# Save to file
firecrawl map https://example.com -o urls.txt
firecrawl map https://example.com --json --pretty -o urls.json

Options disponibles :

Option	Description
--url <url>	URL à cartographier (alternative à l’argument positionnel)
--limit <number>	Nombre maximal d’URL à découvrir
--search <query>	Filtrer les URL selon une requête de recherche
--sitemap <mode>	Gestion du sitemap : include, skip, only
--include-subdomains	Inclure les sous-domaines
--ignore-query-parameters	Considérer les URL avec des paramètres différents comme identiques
--wait	Attendre la fin de l’opération de cartographie
--timeout <seconds>	Délai d’expiration en secondes
--json	Résultat au format JSON
--output <path>	Enregistrer le résultat dans un fichier
--pretty	Affichage JSON mis en forme

---

​

Interact

Scrapez une page, puis interagissez avec elle en langage naturel ou à l’aide de code. Interact utilise par défaut le dernier scrape, ou vous pouvez fournir un ID de scrape spécifique.

CLI

# 1. Scrape la page d'accueil d'Amazon (l'ID de scrape est sauvegardé automatiquement)
firecrawl scrape https://www.amazon.com

# 2. Interagir — rechercher un produit et obtenir son prix
firecrawl interact "Search for iPhone 16 Pro Max"
firecrawl interact "Click on the first result and tell me the price"

# 3. Arrêter la session
firecrawl interact stop

Options disponibles :

Option	Description
-p, --prompt <text>	Prompt IA (alternative à l’argument positionnel)
-c, --code <code>	Code à exécuter dans la session active de la page
-s, --scrape-id <id>	ID de tâche de scraping (par défaut : dernier scrape)
--python	Exécuter le code en Python/Playwright
--node	Exécuter le code en Node.js/Playwright (par défaut)
--bash	Exécuter le code en Bash
--timeout <seconds>	Délai d’attente en secondes (1-300, par défaut : 30)
--output <path>	Enregistrer la sortie dans un fichier
--json	Sortie au format JSON

---

​

Crawl

Lancer un crawl sur l’ensemble d’un site web à partir d’une URL.

CLI

# Start a crawl (returns job ID immediately)
firecrawl crawl https://example.com

# Wait for crawl to complete
firecrawl crawl https://example.com --wait

# Attendre avec indicateur de progression
firecrawl crawl https://example.com --wait --progress

​

Consulter l’état du crawl

CLI

# Vérifier le statut du crawl avec l'ID de tâche
firecrawl crawl <job-id>

# Exemple avec un véritable ID de tâche
firecrawl crawl 550e8400-e29b-41d4-a716-446655440000

​

Options de crawl

CLI

# Limit crawl depth and pages
firecrawl crawl https://example.com --limit 100 --max-depth 3 --wait

# Include only specific paths
firecrawl crawl https://example.com --include-paths /blog,/docs --wait

# Exclude specific paths
firecrawl crawl https://example.com --exclude-paths /admin,/login --wait

# Include subdomains
firecrawl crawl https://example.com --allow-subdomains --wait

# Crawl entire domain
firecrawl crawl https://example.com --crawl-entire-domain --wait

# Rate limiting
firecrawl crawl https://example.com --delay 1000 --max-concurrency 2 --wait

# Transmettre les options de scrape à chaque page explorée
firecrawl crawl https://example.com --scrape-options '{"formats":["markdown"],"onlyMainContent":true}'

# Envoyer les événements de fin de crawl à un webhook
firecrawl crawl https://example.com --webhook '{"url":"https://example.com/webhook","events":["completed"]}'

# Annuler un crawl actif
firecrawl crawl <job-id> --cancel

# Custom polling interval and timeout
firecrawl crawl https://example.com --wait --poll-interval 10 --timeout 300

# Save results to file
firecrawl crawl https://example.com --wait --pretty -o results.json

Options disponibles :

Option	Description
--url <url>	URL à explorer (alternative à l’argument positionnel)
--wait	Attendre la fin du crawl
--progress	Afficher un indicateur de progression pendant l’attente
--poll-interval <seconds>	Intervalle d’interrogation (par défaut : 5)
--timeout <seconds>	Délai d’expiration de l’attente
--status	Vérifier l’état d’une tâche de crawl existante
--limit <number>	Nombre maximal de pages à explorer
--max-depth <number>	Profondeur maximale du crawl
--include-paths <paths>	Chemins à inclure (séparés par des virgules)
--exclude-paths <paths>	Chemins à exclure (séparés par des virgules)
--sitemap <mode>	Gestion du sitemap : include, skip, only
--allow-subdomains	Inclure les sous-domaines
--allow-external-links	Suivre les liens externes
--crawl-entire-domain	Explorer l’ensemble du domaine
--ignore-query-parameters	Considérer les URL avec des paramètres différents comme identiques
--delay <ms>	Délai entre les requêtes
--max-concurrency <n>	Nombre maximal de requêtes simultanées
--scrape-options <json>	Options de scrape au format JSON transmises à chaque page
--scrape-options-file <path>	Chemin vers le fichier JSON des options de scrape
--webhook <url-or-json>	URL ou configuration du Webhook
--cancel	Annuler une tâche de crawl active à l’aide de son ID de tâche
--output <path>	Enregistrer le résultat dans un fichier
--pretty	Afficher la sortie JSON formatée

---

​

Monitor

Créez des scrapes ou crawls récurrents qui comparent chaque exécution à l’instantané précédent. Ajoutez un objectif lorsque vous voulez que Firecrawl évalue quelles pages modifiées sont pertinentes pour votre cas d’usage.

CLI

firecrawl monitor create --name "Hacker News AI" \
  --schedule "every 30 minutes" \
  --goal "Alert when a new Hacker News story related to AI enters the top 10. Ignore changes to stories that are not about AI. Do not alert on changes outside the top 10." \
  --page https://news.ycombinator.com

firecrawl monitor run <monitorId>
firecrawl monitor checks <monitorId> --limit 10
firecrawl monitor check <monitorId> <checkId> --page-status changed
firecrawl monitor update <monitorId> \
  --goal "Alert when a new Hacker News story related to AI enters the top 10. Do not alert on changes outside the top 10."
firecrawl monitor delete <monitorId>

Les objectifs du monitor doivent rester courts et fidèles à l’intention de l’utilisateur : indiquez ce qui doit déclencher une alerte, reformulez toute portée précisée et n’incluez des exclusions que lorsqu’elles sont évidentes ou explicitement demandées. Si l’utilisateur demande “tout changement”, gardez l’objectif large.

Options disponibles :

Option	Description
--name <name>	Nom du monitor
--goal <goal>	Objectif pour évaluer les changements significatifs
--cron <expression>	Planification cron, par exemple */30 * * * *
--schedule <text>	Planification en langage naturel, par exemple hourly
--timezone <tz>	Fuseau horaire de la planification, UTC par défaut
--page <url>	URL d’une seule page à scraper à chaque vérification
--scrape-urls <list>	URL de pages à scraper à chaque vérification, séparées par des virgules
--crawl-url <url>	URL racine de la cible de crawl
--webhook-url <url>	Destination du Webhook
--webhook-events <list>	Événements du monitor séparés par des virgules
--email <list>	Destinataires e-mail séparés par des virgules
--retention-days <n>	Durée de conservation des instantanés
--page-status <state>	Filtrer les pages dans monitor check
--state <state>	Définir l’état du monitor dans monitor update : active/paused

---

​

Agent

Recherchez et collectez des données sur le web à l’aide de prompts en langage naturel.

CLI

# Basic usage - URLs are optional
firecrawl agent "Trouvez les 5 meilleures startups IA et leurs montants de financement" --wait

# Focus on specific URLs
firecrawl agent "Comparez les plans tarifaires" --urls https://slack.com/pricing,https://teams.microsoft.com/pricing --wait

# Use a schema for structured output
firecrawl agent "Obtenez des informations sur l'entreprise" --urls https://example.com --schema '{"type":"object","properties":{"name":{"type":"string"},"founded":{"type":"number"}}}' --wait

# Use schema from a file
firecrawl agent "Obtenez les détails du produit" --urls https://example.com --schema-file schema.json --wait

​

Options de l’agent

CLI

# Use Spark 1 Pro for higher accuracy
firecrawl agent "Competitive analysis across multiple domains" --model spark-1-pro --wait

# Set max credits to limit costs
firecrawl agent "Gather contact information from company websites" --max-credits 100 --wait

# Check status of an existing job
firecrawl agent <job-id> --status

# Envoyer les événements de l'agent à un webhook
firecrawl agent "Extract product details" --urls https://example.com --webhook '{"url":"https://example.com/webhook","events":["completed","failed"]}'

# Annuler un job d'agent actif
firecrawl agent <job-id> --cancel

# Custom polling interval and timeout
firecrawl agent "Summarize recent blog posts" --wait --poll-interval 10 --timeout 300

# Save output to file
firecrawl agent "Find pricing information" --urls https://example.com --wait -o pricing.json --pretty

Options disponibles :

Option	Description
--urls <urls>	Liste facultative d’URL sur lesquelles concentrer l’agent (séparées par des virgules)
--model <model>	Modèle à utiliser : spark-1-mini (par défaut, 60 % moins cher) ou spark-1-pro (meilleure précision)
--schema <json>	Schéma JSON pour la sortie structurée (chaîne JSON intégrée)
--schema-file <path>	Chemin vers le fichier de schéma JSON pour la sortie structurée
--max-credits <number>	Nombre maximal de crédits à utiliser (la tâche échoue si la limite est atteinte)
--webhook <url-or-json>	URL ou configuration du webhook
--status	Consulter l’état d’une tâche d’agent existante
--cancel	Annuler une tâche d’agent active à l’aide de l’ID de tâche
--wait	Attendre que l’agent ait terminé avant de renvoyer les résultats
--poll-interval <seconds>	Intervalle d’interrogation pendant l’attente (par défaut : 5)
--timeout <seconds>	Délai d’attente maximal (par défaut : aucun délai)
--output <path>	Enregistrer la sortie dans un fichier
--json	Sortie au format JSON

---

​

Utilisation des crédits

Consultez le solde et l’utilisation des crédits de votre équipe.

CLI

# Voir l'utilisation des crédits
firecrawl credit-usage

# Sortie en JSON
firecrawl credit-usage --json --pretty

---

​

Version

Afficher la version de la CLI.

CLI

firecrawl version
# ou
firecrawl --version

​

Options globales

Ces options sont disponibles pour toutes les commandes :

Option	Raccourci	Description
--status		Afficher la version, l’état d’authentification, le niveau de concurrence et les crédits
--api-key <key>	-k	Ignorer la clé d’API enregistrée pour cette commande
--api-url <url>		Utiliser une URL d’API personnalisée (pour l’auto-hébergement ou le développement local)
--help	-h	Afficher l’aide pour une commande
--version	-V	Afficher la version de la CLI

​

Gestion de la sortie

La CLI écrit sur stdout par défaut, ce qui facilite l’utilisation de pipes ou la redirection :

CLI

# Pipe markdown to another command
firecrawl https://example.com | head -50

# Redirect to a file
firecrawl https://example.com > output.md

# Save JSON with pretty formatting
firecrawl https://example.com --format markdown,links --pretty -o data.json

​

Comportement des formats

• Un seul format : renvoie le contenu brut (texte markdown, HTML, etc.)
• Plusieurs formats : renvoie du JSON avec toutes les données demandées

CLI

# Sortie markdown brute
firecrawl https://example.com --format markdown

# Sortie JSON avec plusieurs formats
firecrawl https://example.com --format markdown,links

​

Exemples

​

Scraping rapide

CLI

# Récupérer le contenu markdown d'une URL (utiliser --only-main-content pour une sortie épurée)
firecrawl https://docs.firecrawl.dev --only-main-content

# Get HTML content
firecrawl https://example.com --html -o page.html

​

Exploration complète du site

CLI

# Crawle un site de docs avec des limites
firecrawl crawl https://docs.example.com --limit 50 --max-depth 2 --wait --progress -o docs.json

​

Découverte de sites web

CLI

# Trouver tous les articles de blog
firecrawl map https://example.com --search "blog" -o blog-urls.txt

​

Flux de recherche

CLI

# Rechercher et scraper les résultats pour la recherche
firecrawl search "machine learning best practices 2024" --scrape --scrape-formats markdown --pretty

​

Agent

CLI

# Les URL sont facultatives
firecrawl agent "Find the top 5 AI startups and their funding amounts" --wait

# Se concentrer sur des URL spécifiques
firecrawl agent "Compare pricing plans" --urls https://slack.com/pricing,https://teams.microsoft.com/pricing --wait

​

Combiner avec d’autres outils

CLI

# Extract URLs from search results
jq -r '.data.web[].url' search-results.json

# Récupérer les titres des résultats de recherche
jq -r '.data.web[] | "\(.title): \(.url)"' search-results.json

# Extract links and process with jq
firecrawl https://example.com --format links | jq '.links[].url'

# Count URLs from map
firecrawl map https://example.com | wc -l

​

Télémétrie

La CLI collecte des données d’utilisation anonymes lors de l’authentification afin d’améliorer le produit :

• Version de la CLI, système d’exploitation et version de Node.js
• Détection de l’outil de développement (par exemple, Cursor, VS Code, Claude Code)

Aucune donnée relative aux commandes, aux URL ou au contenu des fichiers n’est collectée via la CLI.

Pour désactiver la télémétrie, définissez la variable d’environnement :

CLI

export FIRECRAWL_NO_TELEMETRY=1

​

Open Source

La CLI Firecrawl et les trois catégories de skills sont open source sur GitHub :

• firecrawl/cli — la CLI et les skills CLI (travail sur le web en direct)
• firecrawl/skills — les skills Build (intégrer Firecrawl dans le code d’application)
• firecrawl/firecrawl-workflows — les skills workflow (livrables reproductibles comme des synthèses de recherche, des audits SEO, des listes de prospects et des clones de design)

Êtes-vous un agent IA qui a besoin d’une clé API Firecrawl ? Consultez firecrawl.dev/agent-onboarding/SKILL.md pour obtenir les instructions d’onboarding automatisé.