Si vous développez avec l’IA, Firecrawl propose plusieurs ressources pour améliorer votre expérience. Firecrawl inclut des skills — des blocs de connaissances autonomes que les agents IA de développement découvrent et utilisent automatiquement. Une seule commande d’installation fournit aux agents des skills CLI pour les opérations web en direct et des skills workflow pour produire des livrables reproductibles. Les skills Build, qui permettent d’intégrer Firecrawl au code applicatif, font l’objet d’une étape distincte (firecrawl setup build). Les utilisateurs de Firecrawl peuvent obtenir une clé API de deux façons. Voir Obtenir les identifiants ci-dessous.
- Obtenir les identifiants
- CLI et skills d’agent
- Utiliser Firecrawl comme outil
- Débogage agentique
- Firecrawl MCP Server
- docs Firecrawl pour les agents
- Guides de démarrage rapide
- intégration pour agent
- SDKs
Obtenir les identifiants#
Les utilisateurs de Firecrawl peuvent obtenir une clé API de deux façons. La plupart des utilisateurs doivent se connecter via le dashboard ou la CLI. Si votre plateforme d’agents prend en charge WorkOS ID-JAG, elle peut s’enregistrer directement auprès de Firecrawl.
Laquelle utiliser ? Utilisez le dashboard ou la CLI, sauf si vous savez que votre plateforme prend en charge WorkOS ID-JAG.
Comment vous pouvez arriver ici :
- Docs : vous y êtes déjà. Choisissez l’option ci-dessous qui correspond à votre mode de connexion.
- API
401: les agents compatibles ID-JAG peuvent suivre le flux de découverte dansauth.md, à l’étape 1. Tous les autres doivent utiliser le dashboard ou la CLI. - URL directe : suivez
SKILL.mdpour la connexion et la configuration dans le browser, ouauth.mdpour l’enregistrement WorkOS ID-JAG.
Par défaut pour la plupart des utilisateurs. Connectez-vous depuis le browser, lancez la CLI avec --browser, installez les skills et MCP, ou créez une clé API dans le dashboard.
Pour les plateformes d’agents prises en charge. Utilisez cette option lorsque votre plateforme peut émettre un WorkOS ID-JAG pour Firecrawl. Consultez Agent Auth, puis suivez auth.md.
Vous ne pouvez pas vous connecter ni obtenir de clé ? La CLI, les SDK et l’API REST permettent d’effectuer des recherches, du scraping, des interactions et du parsing sans clé. Le MCP hébergé n’expose sans clé qu’un périmètre plus restreint : recherche, Scrape et Parse ; Interact y nécessite une connexion à un compte ou une clé API. L’accès sans clé est soumis à une limitation de débit et conçu comme solution de secours ; passez donc à un compte Free ou à une clé API dès que possible. Consultez Keyless (no API key) pour plus de détails.
Une fois que vous avez une clé API, poursuivez avec la CLI et les skills d’agent ci-dessous.
CLI et skills d’agent#
Le Firecrawl CLI permet à votre agent de rechercher, scraper, interagir, lancer un crawl, faire de la cartographie, extraire des données et exécuter des tâches d’agent depuis le terminal. Il est conçu pour les humains, les agents IA et les pipelines CI/CD.
Les skills Firecrawl sont des ensembles de connaissances autonomes que les agents IA de développement comme Codex, Claude Code, Cursor et OpenCode découvrent et utilisent automatiquement. Une seule commande d’installation configure les outils CLI pour les opérations web en direct et les skills workflow pour produire des livrables reproductibles. Les skills Build pour intégrer Firecrawl dans le code applicatif s’installent avec firecrawl setup build :
--allignore la sélection d’agent et initialise tous les agents détectés--browserouvre automatiquement le Browser pour l’authentification Firecrawl--skip-auth,--skip-install,--skip-skillset--agent <name>sont également disponibles. Voirfirecrawl init --help.
Après l’installation, vérifiez que tout fonctionne :
Pour réinstaller ou cibler un agent spécifique ultérieurement :
Ce que l’installation inclut#
Les skills Firecrawl couvrent trois catégories. init installe les skills CLI et workflow. Exécutez firecrawl setup build pour les skills Build. Chaque segment vit dans son propre dépôt afin de pouvoir évoluer indépendamment :
firecrawl/cli— Skills CLI pour les opérations web en directfirecrawl/skills— skills Build pour l’intégration dans l’applicationfirecrawl/firecrawl-workflows— skills workflow pour des livrables reproductibles
Skills CLI — pour les opérations web en direct pendant une session d’agent :
| Skill | Objectif |
|---|---|
firecrawl | Workflow global des commandes CLI |
firecrawl-search | Rechercher sur le web et découvrir des pages |
firecrawl-scrape | Extraire un contenu propre depuis une URL connue |
firecrawl-interact | Interagir avec des pages scrapées à l’aide de prompts ou de code |
firecrawl-crawl | Extraire en masse le contenu d’un site entier |
firecrawl-map | Découvrir toutes les URL d’un domaine |
firecrawl-agent | Exécuter une collecte autonome de données web avec un job |
firecrawl-monitor | Détecter les changements d’un site et être notifié |
firecrawl-parse | Convertir des documents locaux en markdown |
firecrawl-download | Télécharger un site sous forme de fichiers locaux |
firecrawl-research-index | Rechercher des articles, lire des passages et suivre les citations |
firecrawl-developer-index | Rechercher des tickets, des pull requests, des README et de la documentation |
L’installation ci-dessus inclut les deux skills d’index. Pour n’ajouter que celle de recherche d’articles à une configuration existante — ce qui est utile lorsque le travail porte sur la littérature biomédicale ou scientifique — exécutez :
Skills Build — pour intégrer Firecrawl au code applicatif :
| Skill | Objectif |
|---|---|
firecrawl-build | Choisir le bon point de terminaison Firecrawl pour votre produit |
firecrawl-build-onboarding | Authentification et configuration du projet |
firecrawl-build-scrape | Implémenter le scraping dans le code applicatif |
firecrawl-build-search | Implémenter la recherche dans le code applicatif |
firecrawl-build-interact | Implémenter l’interaction avec la page dans le code applicatif |
Skills workflow — des skills orientées résultats qui produisent un livrable concret à partir des données web de Firecrawl :
| Skill | Résultat |
|---|---|
firecrawl-workflows | Skill principale pour choisir le bon workflow |
firecrawl-deep-research | Rapports de recherche multi-sources |
firecrawl-seo-audit | Plans de site, vérifications SEO on-page, comparaison des SERP et correctifs priorisés |
firecrawl-lead-research | Briefs d’intelligence sur les entreprises et les personnes avant réunion |
firecrawl-lead-gen | Génération de listes de prospects à partir de bases de données et de répertoires |
firecrawl-qa | Rapports de QA sur site en direct avec problèmes et étapes de reproduction |
firecrawl-competitive-intel | Monitoring récurrent de la tarification, des fonctionnalités et des journaux des modifications |
firecrawl-market-research | Recherche de marché, financière, sur les résultats et sectorielle |
firecrawl-research-papers | Revues de littérature à partir d’articles, de PDF et de livres blancs |
firecrawl-company-directories | Extraction de répertoires en listes structurées d’entreprises |
firecrawl-dashboard-reporting | Extraction de métriques depuis des dashboards et des outils web internes |
firecrawl-knowledge-base | Documentation de référence prête pour les LLM, chunks RAG, données d’entraînement ou miroirs de documentation |
firecrawl-knowledge-ingest | Ingestion de portails de documentation protégés par authentification ou fortement dépendants de JS |
firecrawl-demo-walkthrough | Présentations guidées de parcours produit et rapports d’analyse UX |
firecrawl-shop | Recherche produit et recommandations d’achat |
firecrawl-website-design-clone | Extraire le système de design d’un site web dans un DESIGN.md prêt pour un agent |
Choisissez votre voie#
Les skills CLI et Workflow proviennent de l'installation ci-dessus. Les skills Build font l'objet d'une étape distincte : firecrawl setup build. La différence se joue ensuite :
Outils web en temps réel (skills CLI)
Utilisez ceci lorsque vous avez besoin de données web pendant votre session en cours — recherche sur le web, scraping d'URL connues, interaction avec des pages scrapées, crawl de documentation, cartographie d'un site ou exécution d'une tâche d’agent.
Le flux par défaut :
- Commencez par recherche lorsque vous avez besoin de découverte
- Passez à scrape lorsque vous avez une URL
- Utilisez interact lorsque la page scrapée nécessite des actions supplémentaires
- Utilisez cartographie ou crawl lorsque vous avez besoin de nombreuses URL ou pages
- Utilisez agent lorsque la tâche est ouverte et nécessite une découverte autonome
Intégration applicative (skills Build)
Utilisez ceci lorsque vous créez une application, un agent ou un workflow qui appelle l'API Firecrawl depuis du code. Installez les skills Build avec firecrawl setup build. Ils aident à choisir le bon point de terminaison, à intégrer le SDK et à exécuter un test rapide.
L'agent répond à une question clé — que doit faire Firecrawl dans le produit ? — et les skills Build orientent ensuite vers /search, /scrape, /interact, /parse, /crawl, /map ou /agent selon le cas.
Livrables reproductibles (skills Workflow)
Utilisez ceci lorsque l'objectif est un livrable finalisé — un rapport de recherche, un audit SEO, un rapport QA, une liste de leads, une base de connaissances, une synthèse de veille concurrentielle ou un système de design cloné — et non des données web brutes ou du code produit.
Les skills Workflow déduisent d'abord à partir du contexte et ne posent de brèves questions de clarification que lorsqu'une entrée bloquerait le travail. Ils signalent aussi les unités parallélisables de manière indépendante afin que des sous-agents puissent se répartir entre concurrents, pages ou sources.
Choisissez directement un workflow, ou laissez le skill parapluie firecrawl-workflows orienter la requête :
API REST (aucune installation nécessaire)
Si vous préférez ne rien installer, les agents peuvent appeler directement l'API REST de Firecrawl. Définissez la clé API et appelez les points de terminaison :
POST https://api.firecrawl.dev/v2/search— découvrir des pages à partir d'une requêtePOST https://api.firecrawl.dev/v2/scrape— extraire un markdown propre depuis une URLPOST https://api.firecrawl.dev/v2/scrape/{scrapeId}/interact— interagir avec une page scrapéePOST https://api.firecrawl.dev/v2/crawl— extraire en masse un site entierPOST https://api.firecrawl.dev/v2/map— découvrir des URL sur un domainePOST https://api.firecrawl.dev/v2/agent— exécuter une collecte autonome de données web
En-tête d'authentification : Authorization: Bearer VOTRE_CLÉ_API
Les définitions complètes de l'onboarding se trouvent ici :
- Connexion Browser, configuration CLI, skills, MCP et clés du dashboard :
firecrawl.dev/agent-onboarding/SKILL.md - Enregistrement d'agent avec WorkOS ID-JAG :
firecrawl.dev/auth.md
Les agents peuvent récupérer directement l'un ou l'autre document : utilisez agent-onboarding/SKILL.md pour un onboarding CLI/Browser avec humain dans la boucle, ou auth.md pour l'enregistrement WorkOS ID-JAG.
Travail web en temps réel pendant une session d'agent — recherche, scrape, interact, cartographie, crawl et exécution de tâches d’agent depuis le terminal.
Intégrez Firecrawl dans du code applicatif — choisissez le bon point de terminaison, intégrez le SDK et livrez une intégration vérifiée.
Produisez des livrables reproductibles — briefs de recherche, audits SEO, rapports QA, listes de leads, bases de connaissances et clones de design.
Utiliser Firecrawl comme outil#
Firecrawl met à la disposition des agents cinq outils principaux pour travailler avec le web. Chaque outil correspond à un point de terminaison d’API et à une commande CLI. Les agents choisissent l’outil adapté à leurs besoins :
recherche — découvrir des pages à partir d’une requête
Commencez ici si vous n’avez pas encore d’URL. recherche renvoie des pages web pertinentes pour une requête en langage naturel, avec en option le contenu complet des pages dans les résultats.
Quand l’utiliser : recherche web générale, localisation de documentation, analyse concurrentielle, réponse à des questions nécessitant des informations web à jour.
Quand ne pas l’utiliser : littérature scientifique. Pour trouver des publications, lire des passages dans l’une d’elles ou suivre des citations, utilisez plutôt le Research Index — les outils MCP firecrawl_research_*, firecrawl research search-papers dans la CLI ou la skill firecrawl-research-index. recherche renvoie des snippets de pages web ; le Research Index renvoie des fiches de publications avec les résumés complets.
Scrape — extraire le contenu d’une URL
Utilisez cet outil lorsque vous avez déjà une URL et que vous avez besoin d’un contenu propre, prêt pour les LLM. Scrape convertit n’importe quelle page web en markdown, HTML ou données structurées, en gérant automatiquement le rendu JavaScript, les mesures anti-bot et le HTML désordonné.
Quand l’utiliser : lecture de documentation, extraction du contenu d’articles, récupération de données depuis une page connue, conversion de pages web en contexte pour les LLM.
Crawl — extraire en masse un site entier
Crawl suit récursivement les liens à partir d’une URL de départ et scrape chaque page trouvée. Utilisez-le lorsque vous avez besoin du contenu d’un site entier ou d’un ensemble de documentation, et non d’une seule page.
Quand l’utiliser : ingestion de sites de documentation complets, création de bases de connaissances, migration de contenu, collecte de données d’entraînement.
cartographie — découvrir toutes les URL d’un domaine
cartographie découvre rapidement toutes les URL indexées d’un domaine sans en scraper le contenu. Utilisez-le lorsque vous avez besoin de comprendre la structure d’un site ou de trouver des pages spécifiques avant de les scraper.
Quand l’utiliser : audits de site, recherche de pages spécifiques sur un site volumineux, compréhension de la structure d’un site avant un crawl ciblé.
Interact — travailler avec une page scrapée
Interact permet aux agents de poursuivre à partir d’un scrape à l’aide de prompts ou de code. Utilisez-le lorsqu’une page scrapée nécessite des clics, le remplissage de formulaires, de la navigation ou une extraction complémentaire.
Quand l’utiliser : poursuite après un scrape, navigation dans des pages dynamiques, remplissage de formulaires et extraction de données après des actions sur la page.
Comment les agents enchaînent les outils#
La plupart des workflows d’agents combinent plusieurs outils. Schéma typique :
- Recherche de pages pertinentes → obtenir une liste d’URL
- Scrape des URL les plus pertinentes → obtenir un contenu propre
- Interact lorsque la page scrapée nécessite des actions de suivi
- Agent lorsque la tâche nécessite une découverte autonome ou une extraction structurée sur plusieurs pages
Pour les traitements en masse, les agents utilisent d’abord Cartographie pour découvrir des URL, puis Crawl ou Scrape de manière sélective sur les pages dont ils ont besoin.
Débogage agentique#
Lorsqu'un appel à Firecrawl échoue ou renvoie des résultats inattendus, votre agent n'a pas besoin de faire appel à un humain. Le point de terminaison /support/ask est un agent de support IA conçu pour la communication d’agent à agent — il diagnostique les problèmes liés à vos jobs, à votre compte et à votre utilisation de l’API, puis renvoie une réponse vérifiée avec des paramètres de correction lisibles par machine que votre agent peut appliquer directement.
Intégrez-le au flux de gestion des erreurs de votre agent afin qu’il puisse se rétablir automatiquement après des échecs de scraping, des problèmes de crawl et des erreurs de configuration — généralement en 15 à 30 secondes, sans intervention humaine.
Comment cela fonctionne#
- Votre agent décrit le problème — une question en langage naturel qui décrit le problème.
- L'agent de support enquête — il examine les logs de tâche, l'état du compte, la documentation et le code source.
- L'agent de support valide — lorsque c'est possible, il teste un correctif sur l'API Firecrawl en conditions réelles (par exemple, en relançant un scrape avec des paramètres ajustés).
- Votre agent obtient une réponse vérifiée — une
answerrédigée en langage naturel, desfixParametersexploitables par machine à appliquer directement, et des résultats devalidationindiquant si le correctif a été testé.
Exemple#
Envoyez une question, ainsi qu’un rationale facultatif pour donner à l’agent de support plus de contexte sur l’objectif de votre utilisateur final :
La réponse inclut une answer, un niveau de confidence, des fixParameters facultatifs (par ex. {"waitFor": 5000}) que votre agent peut transmettre lors de l’appel suivant, ainsi qu’une validation indiquant si le correctif a été testé sur l’API en production.
Schéma complet de la requête et de la réponse pour /support/ask, y compris les codes d’état et l’enveloppe de retour renvoyée lorsque l’agent est bloqué.
Firecrawl MCP Server#
MCP est un protocole ouvert qui permet aux applications compatibles de donner aux modèles accès à des outils. Le serveur MCP Firecrawl open source prend en charge la recherche, le scraping, la navigation, le crawl, la cartographie, l’extraction structurée via Scrape JSON et les tâches d’agent autonomes.
Essayez l’accès sans clé, connectez-vous via un client interactif ou configurez une clé API pour les agents, l’intégration continue et les services backend.
Docs Firecrawl pour les agents#
Vous pouvez fournir à votre agent la documentation Firecrawl à jour de façon contextualisée. Les agents peuvent se configurer eux-mêmes en récupérant directement ces ressources — sans intervention humaine.
Obtenir les identifiants
Démarrez par Obtenir les identifiants pour choisir entre la configuration via le dashboard/CLI et l’enregistrement à WorkOS ID-JAG. Pour l’enregistrement ID-JAG, suivez auth.md.
Docs Markdown
Chaque page dispose d'une version markdown. Ajoutez .md à n'importe quelle URL de la documentation, ou utilisez le menu d'action de la page pour la copier au format markdown.
llms.txt complet
Fournissez à votre agent l'ensemble de notre documentation dans un seul fichier.
Une version d'index plus courte est également disponible à https://docs.firecrawl.dev/llms.txt.
Serveur de docs MCP
Pour une approche structurée avec les outils MCP, connectez le serveur MCP Firecrawl dans Codex, Cursor, Claude Code, Claude Desktop ou un autre client compatible. Commencez par le sélecteur de configuration MCP. Les utilisateurs de Windsurf doivent suivre le démarrage rapide de Windsurf.
Copier vers ChatGPT / Claude
Chaque page inclut un menu d'action contextuel (copier, consulter en markdown, ouvrir dans ChatGPT, ouvrir dans Claude), afin que les agents comme les humains puissent déplacer des pages entre les outils en un clic.
Guides de démarrage rapide#
Des guides de démarrage rapide prêts à l’emploi pour les stacks sur lesquelles les agents s’appuient le plus souvent. Faites pointer votre agent vers l’un d’eux pour mettre en place une intégration Firecrawl complète et fonctionnelle.
Vous préférez laisser Cursor s’en charger ? Installez en un clic le serveur MCP Firecrawl et commencez à rédiger des prompts dans Cursor :
JavaScript et TypeScript côté serveur avec le Firecrawl Node SDK.
Scraper, rechercher et lancer un crawl depuis les route handlers et server actions de Next.js.
Utilisez Firecrawl depuis des scripts, des notebooks et des services backend.
Créez des API Python asynchrones pour la recherche, le scrape et l’extraction.
Exécutez Firecrawl à l’edge avec Workers.
Appelez Firecrawl depuis des fonctions serverless Vercel.
Invoquez Firecrawl depuis des handlers Lambda.
Utilisez Firecrawl dans l’environnement d’exécution Deno de Supabase.
SDK Go idiomatique pour la recherche, le scrape et le crawl.
SDK Rust typé pour Firecrawl.
Ajoutez Firecrawl à vos applications Laravel via le SDK PHP.
Intégrez Firecrawl à Ruby on Rails.
Consultez la liste complète des guides de démarrage rapide (Express, NestJS, Fastify, Hono, Bun, Remix, Nuxt, SvelteKit, Astro, Mastra, Django, Flask, Elixir, Java, Spring Boot, .NET, ASP.NET Core, et plus encore) dans la barre latérale gauche.
Intégrations pour agents#
Firecrawl s’intègre aux environnements d’exécution et frameworks que les agents utilisent réellement — agents de codage, SDK d’agents et agrégateurs de modèles. La plupart des outils de codage peuvent détecter automatiquement les skills Firecrawl via npx -y firecrawl-cli@latest init --all --browser ; les autres appellent Firecrawl comme outil via MCP ou l’API REST.
CLI d’Anthropic — configurez Firecrawl MCP dans Claude Code.
IDE agentique — installez Firecrawl MCP dans Cursor en un clic.
Intégrez Firecrawl MCP à OpenCode.
Intégrez Firecrawl MCP à OpenAI Codex CLI.
Associez n’importe quel modèle OpenRouter aux outils web de Firecrawl.
Intégrez Firecrawl MCP à Sourcegraph Amp.
IDE agentique — configurez Firecrawl MCP dans Windsurf.
Ajoutez Firecrawl MCP à l’IDE agentique de Google.
Intégrez Firecrawl MCP à Google Gemini CLI.
Utilisez Firecrawl comme outil avec les modèles Hermes.
Utilisez les outils Firecrawl au sein des équipes multi-agents de Microsoft AutoGen.
SDKs#
Des SDKs officiels et typés couvrant l’ensemble de l’API Firecrawl. Choisissez pour votre agent le langage adapté à votre stack.
Firecrawl propose également des intégrations SDK natives pour les principaux SDK de LLM et frameworks d’agents — consultez LLM SDKs and Frameworks pour OpenAI, Anthropic, Gemini, Google ADK, Vercel AI SDK, LangChain, LangGraph, LlamaIndex, Mastra et ElevenAgents.

