Installation
--allinstalle tous les segments de skills Firecrawl (CLI, build, workflows) sur tous les agents de codage IA détectés--browserouvre automatiquement le navigateur pour l’authentification Firecrawl
Après avoir installé les skills, redémarrez votre agent pour qu’il les détecte.
CLI
Authentification
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
Afficher la configuration
CLI
Déconnexion
CLI
Auto-hébergé / Développement local
--api-url :
CLI
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
CLI
- 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/crawlconsomme 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
CLI
Formats de sortie
CLI
Options de Scrape
CLI
| 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
CLI
Options de recherche
CLI
| 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
CLI
Options de la commande Map
CLI
| 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
CLI
| 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
CLI
Consulter l’état du crawl
CLI
Options de crawl
CLI
| 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
CLI
| 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
CLI
Options de l’agent
CLI
| 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
CLI
Version
CLI
Options globales
| 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
CLI
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
Exemples
Scraping rapide
CLI
Exploration complète du site
CLI
Découverte de sites web
CLI
Flux de recherche
CLI
Agent
CLI
Combiner avec d’autres outils
CLI
Télémétrie
- 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)
CLI
Open Source
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é.

