Introduction à Firecrawl et n8n

Pourquoi utiliser Firecrawl avec n8n ?
- Extraient des données de manière fiable depuis n’importe quel site web
- Connectent les données scrapées à d’autres outils métier
- S’exécutent selon une planification ou sont déclenchés par des événements
- Passent de tâches simples à des pipelines complexes
Étape 1 : Créez votre compte Firecrawl
Créez un compte Firecrawl
- Accédez à firecrawl.dev dans votre navigateur web
- Cliquez sur le bouton « Get Started » ou « Sign Up »
- Créez un compte avec votre adresse e-mail ou votre identifiant GitHub
- Vérifiez votre adresse e-mail si vous y êtes invité
Obtenez votre clé API
- Accédez à votre tableau de bord Firecrawl
- Ouvrez la page API Keys
- Cliquez sur « Create New API Key »
- Donnez à votre clé un nom descriptif (par exemple, « n8n Integration »)
- Copiez la clé API générée et conservez-la dans un endroit sûr

Votre clé API est comme un mot de passe. Gardez-la en lieu sûr et ne la partagez jamais publiquement. Vous en aurez besoin dans la section suivante.
Étape 2 : Configurer n8n
Choisissez votre version de n8n
- Aucune installation requise
- Offre Free disponible
- Infrastructure gérée
- Mises à jour automatiques
- Contrôle total de vos données
- Fonctionne sur vos propres serveurs
- Nécessite l’installation de Docker
- Adapté aux utilisateurs avancés ayant des exigences spécifiques en matière de sécurité
Option A : n8n Cloud (recommandé pour les débutants)
- Rendez-vous sur n8n.cloud
- Cliquez sur « Start Free » ou « Sign Up »
- Inscrivez-vous avec votre adresse e-mail ou votre compte GitHub
- Terminez le processus de vérification
- Vous serez redirigé vers votre tableau de bord n8n

Option B : Auto-hébergé avec Docker
- Docker Desktop installé sur votre ordinateur
- Connaissances de base de la ligne de commande ou du terminal
- Ouvrez votre terminal ou votre invite de commandes
- Créez un volume Docker pour conserver les données de votre workflow :
- Démarrez le conteneur Docker n8n :

- Attendez que n8n démarre. Une sortie indiquera que le serveur est en cours d’exécution.
- Ouvrez votre navigateur web et accédez à
http://localhost:5678 - Créez votre compte n8n en vous inscrivant avec une adresse e-mail

L’indicateur
--rm supprime automatiquement le conteneur lorsque vous l’arrêtez, mais vos données restent en sécurité dans le volume n8n_data. Pour les déploiements en production, consultez la documentation sur l’auto-hébergement de n8n afin de découvrir des options de configuration plus avancées.Comprendre l’interface n8n

- Workflows : vos automatisations enregistrées apparaissent ici
- Executions : historique des exécutions de workflows
- Credentials : clés API et jetons d’authentification enregistrés
- Settings : configuration du compte et de l’espace de travail
Le canevas du workflow

- Canevas : zone principale où vous placez et reliez les nœuds
- Bouton Ajouter un nœud (+) : cliquez dessus pour ajouter de nouveaux nœuds à votre workflow
- Panneau des nœuds : s’ouvre lorsque vous cliquez sur « + » et affiche tous les nœuds disponibles
- Exécuter le workflow : exécute manuellement votre workflow à des fins de test
- Save : enregistre la configuration de votre workflow
Étape 3 : Installer et configurer le nœud Firecrawl
Ajoutez le nœud Firecrawl à votre workflow
- Dans le canevas de votre nouveau workflow, cliquez sur le bouton ”+” au centre
- Le panneau de sélection des nœuds s’ouvre à droite
- Dans le champ de recherche en haut, saisissez “Firecrawl”
- Le nœud Firecrawl apparaît dans les résultats de recherche

- Cliquez sur “Install” à côté du nœud Firecrawl
- Attendez la fin de l’installation (cela prend quelques secondes)
- Une fois l’installation terminée, cliquez sur le nœud Firecrawl pour l’ajouter à votre canevas

Connectez votre clé API Firecrawl
- Cliquez sur le bloc du nœud Firecrawl pour ouvrir son panneau de configuration à droite.
- En haut, vous verrez la liste déroulante « Credential to connect with ».
- Comme il s’agit de votre première utilisation, cliquez sur « Create New Credential ».

- Une fenêtre de configuration des identifiants s’ouvre.
- Saisissez un nom pour cet identifiant (par exemple, « Mon compte Firecrawl »).
- Collez votre clé API Firecrawl dans le champ « API Key ».
- Cliquez sur « Save » en bas.
Testez votre connexion
- Le nœud Firecrawl étant toujours sélectionné, consultez le panneau de configuration.
- Dans la liste déroulante « Resource », sélectionnez « Extraire une URL et obtenir son contenu ».
- Dans le champ « URL », saisissez :
https://firecrawl.dev. - Laissez les autres paramètres sur leurs valeurs par défaut pour le moment.
- Cliquez sur le bouton « Test step » en bas à droite du nœud.

Étape 4 : Créez votre bot Telegram
Créer un bot avec BotFather
- Ouvrez Telegram sur votre téléphone ou votre ordinateur
- Recherchez “@BotFather” (le bot officiel de Telegram)
- Démarrez une conversation avec BotFather en cliquant sur “Start”
- Envoyez la commande
/newbotpour créer un nouveau bot - BotFather vous demandera de choisir un nom pour votre bot (il s’agit du nom d’affichage que les utilisateurs verront)
- Saisissez un nom tel que “Mon bot Firecrawl”
- Choisissez ensuite un nom d’utilisateur pour votre bot. Il doit se terminer par « bot » (par exemple, “my_firecrawl_updates_bot”)
- Si le nom d’utilisateur est disponible, BotFather créera votre bot et vous enverra un message contenant son jeton

Conservez le jeton de votre bot en lieu sûr. Ce jeton est comme un mot de passe qui permet à n8n d’envoyer des messages au nom de votre bot. Ne le partagez jamais publiquement.
Obtenir votre ID de chat
- Ouvrez votre navigateur web et accédez à cette URL (remplacez
YOUR_BOT_TOKENpar le jeton réel de votre bot) : - Gardez cet onglet ouvert
- Recherchez maintenant le nom d’utilisateur de votre bot dans Telegram (celui que vous venez de créer)
- Démarrez une conversation avec votre bot en cliquant sur « Start »
- Envoyez un message quelconque à votre bot (par exemple, « bonjour »)
- Revenez à l’onglet du navigateur et actualisez la page
- Recherchez le champ
"chat":{"id":dans la réponse JSON - Le nombre à côté de
"id":est votre ID de chat (par exemple,123456789) - Conservez cet ID de chat pour plus tard

Votre ID de chat est l’identifiant unique de votre conversation avec le bot. Vous l’utiliserez pour indiquer à n8n où envoyer les messages.
Étape 5 : Créer des workflows pratiques avec Telegram
Exemple 1 : résumé quotidien des mises à jour de Firecrawl
- Extrait chaque jour à 9 h les articles du blog de Firecrawl consacrés aux mises à jour produit
- Utilise l’IA pour générer un résumé du contenu
- Envoie le résumé sur Telegram
- Créez un nouveau workflow dans n8n
- Ajoutez un nœud Schedule Trigger :
- Cliquez sur le bouton ”+” sur le canevas
- Recherchez “Schedule Trigger”
- Configurez : tous les jours à 9 h 00

- Ajoutez le nœud Firecrawl :
- Cliquez sur ”+” à côté de Schedule Trigger
- Recherchez et ajoutez “Firecrawl”
- Sélectionnez vos identifiants Firecrawl
- Configurez :
- Ressource : Extraire une URL et obtenir son contenu
- URL :
https://www.firecrawl.dev/blog/category/product-updates - Formats : sélectionnez “Summary”

-
Ajoutez le nœud Telegram :
- Cliquez sur ”+” à côté de Firecrawl
- Recherchez “Telegram”
- Cliquez sur “Envoyer un message texte” pour l’ajouter au canevas
-
Configurez les identifiants Telegram :
- Cliquez sur le nœud Telegram pour ouvrir sa configuration
- Dans la liste déroulante “Credential to connect with”, cliquez sur “Create New Credential”
- Collez le jeton de votre bot fourni par BotFather
- Cliquez sur “Save”
- Configurez le message Telegram :
- Opération : envoyer un message
- ID de chat : saisissez votre ID de chat
- Texte : laissez pour l’instant le message “hello”
- Cliquez sur Exécuter l’étape pour tester l’envoi d’un message et récupérer le résumé de Firecrawl.
- Une fois la structure du résumé de Firecrawl disponible, ajoutez-le au texte du message en faisant glisser le champ
summarydepuis la sortie du nœud Firecrawl.
- Testez le workflow :
- Cliquez sur “Exécuter le workflow”
- Vérifiez sur Telegram que vous avez reçu le message de résumé

- Activez le workflow en basculant l’interrupteur “Active”
Exemple 2 : Envoyer les actualités sur l’IA à Telegram
- Utilise un Manual Trigger au lieu de Schedule (exécution à la demande)
- Utilise l’opération Search au lieu de Scrape
- Inclut un nœud Code pour formater plusieurs résultats
- Créez un workflow et ajoutez un nœud Manual Trigger
-
Ajoutez un nœud Firecrawl avec les paramètres suivants :
- Resource : Recherche et scrape facultatif des résultats de recherche
- Query :
ai news - Limit : 5

- Ajoutez un nœud Code pour formater les résultats de recherche :
- Sélectionnez “Run Once for All Items”
- Collez ce code :

- Mettez à jour le nœud Telegram (avec vos identifiants enregistrés) :
- Texte : faites glisser le champ
messagedepuis le nœud Code
- Texte : faites glisser le champ
Exemple 3 : Résumé des actualités par l’IA
- Configuration des identifiants OpenAI
- Ajout d’un nœud agent IA entre Code et Telegram
- agent IA analyse et résume intelligemment tous les articles d’actualité
- Telegram reçoit le résumé généré par l’IA au lieu de la liste brute d’actualités
- Obtenez votre clé API OpenAI :
- Accédez à platform.openai.com/api-keys
- Connectez-vous ou créez un compte
- Cliquez sur “Create new secret key”
- Donnez-lui un nom (par exemple, “n8n Integration”)
- Copiez immédiatement la clé API (vous ne pourrez plus la consulter)

- Ajoutez et connectez le nœud agent IA :
- Cliquez sur ”+” après le nœud Code
- Recherchez “Basic LLM Chain” ou “agent IA”
- Faites glisser le champ
messagedu nœud Code vers le champ de prompt d’entrée de l’agent IA - Sélectionnez OpenAI comme fournisseur de LLM
- Ajoutez vos identifiants OpenAI :
- Cliquez sur “Create New Credential” pour OpenAI
- Collez votre clé API OpenAI
- Sélectionnez le modèle : gpt-5-mini (économique) ou gpt-5 (plus performant)
- Cliquez sur “Save”

- Ajoutez le system prompt à l’agent IA :
- Dans le nœud agent IA, ajoutez ce system prompt :

- Mettez à jour le nœud Telegram et testez :
- Mettez à jour le nœud Telegram :
- Texte : faites glisser la sortie de l’agent IA (le résumé généré)
- Supprimez l’ancien mapping vers le message du nœud Code
- Cliquez sur “Exécuter le workflow” pour tester
- L’IA analysera tous les articles d’actualité et créera un résumé
- Consultez Telegram pour voir le résumé généré par l’IA
- Mettez à jour le nœud Telegram :
L’agent IA reçoit tous les articles d’actualité mis en forme et crée un résumé intelligent, ce qui permet de comprendre plus facilement les tendances et les évolutions importantes en un coup d’œil.
Comprendre les opérations Firecrawl
Extraire une URL et obtenir son contenu
- Extrait le contenu d’une URL unique
- Renvoie du Markdown propre, du HTML ou des résumés générés par l’IA
- Peut capturer des captures d’écran et extraire des liens
- L’extraction d’articles
- La surveillance de pages produit
- Le scraping d’articles de blog
- La génération de résumés de pages
Scrape + Interact avec des profils persistants
profile persistant à l’étape Scrape. L’étape Interact n’a besoin que du scrapeId de la réponse de scraping, ainsi que d’un prompt ou de code. N’ajoutez pas profile au corps de la requête Interact : Interact hérite du profil de la tâche de scraping.
Pour enregistrer les cookies, le localStorage et les autres données d’état du navigateur, arrêtez la session Interact une fois le workflow terminé. Si vous devez seulement lire un profil existant lors d’une exécution ultérieure du workflow, définissez saveChanges sur false à l’étape Scrape.
Si la version installée du nœud Firecrawl n8n n’expose pas les paramètres de profil pour l’opération Scrape, mettez à jour le nœud Firecrawl n8n vers la dernière version. Si votre version de n8n prend en charge des options de requête ou de corps personnalisées pour le nœud, vous pouvez y transmettre le même objet profile :
Rechercher et éventuellement scraper les résultats de recherche
- Recherche sur le Web, dans les actualités ou parmi les images
- Renvoie les titres, les descriptions et les URL
- Peut scraper le contenu complet des résultats
- Automatiser la recherche
- Surveiller les actualités
- Découvrir les tendances
- Trouver du contenu pertinent
Explorer un site web
- Suit automatiquement les liens
- Scrape plusieurs pages en une seule opération
- Peut filtrer les URL selon des motifs
- L’extraction complète d’une documentation
- L’archivage de sites
- La collecte de données sur plusieurs pages
Cartographier un site web et obtenir les URL
- Découvre tous les liens d’un site
- Renvoie une liste d’URL épurée
- Rapide et léger
- La découverte d’URL
- La génération de sitemaps
- La planification de crawls plus vastes
Extraire des données
- Extraction de données par IA
- Renvoie les données au format spécifié
- Fonctionne sur plusieurs pages
- Extraction de données personnalisée
- Création de bases de données
- Collecte d’informations structurées
Extraction par lot
- Traite plusieurs URL simultanément
- Plus efficace que d’utiliser des boucles
- Renvoie tous les résultats en une seule fois
- Traiter des listes d’URL
- Collecter des données en masse
- Projets de scraping à grande échelle
Agent
- Accepte un prompt décrivant les données dont vous avez besoin
- L’agent IA navigue et extrait les informations de manière autonome
- Disponible en mode Sync (attend les résultats) et en mode Async (renvoie immédiatement un ID de tâche)
- Utilisez Get Agent Status pour interroger les résultats lorsque vous utilisez le mode Async
- La collecte complexe de données sur plusieurs pages, guidée par un prompt
- L’extraction d’informations lorsque vous ne connaissez pas la structure exacte des pages
- Les tâches de recherche nécessitant de naviguer sur plusieurs pages
- Agent (Sync) démarre la tâche et attend le résultat en une seule étape — l’option la plus simple pour la plupart des cas d’utilisation. Le paramètre Max Wait Time définit la durée pendant laquelle le nœud interroge l’état de la tâche avant expiration du délai (par défaut : 300 secondes, maximum : 600 secondes). Si la tâche d’agent prend plus de temps, le nœud renvoie un état d’expiration, même si la tâche peut toujours se terminer côté Firecrawl. Pour les tâches susceptibles de dépasser 10 minutes, utilisez plutôt le mode Async.
- Agent (Async) renvoie immédiatement un ID de tâche. Ajoutez un second nœud Firecrawl avec l’opération Get Agent Status pour récupérer les résultats une fois la tâche terminée.
Browser Sandbox
- Créer une session de navigateur — démarre une nouvelle session de navigateur et renvoie un
sessionId - Exécuter du code dans le navigateur — exécute du code JavaScript, Python ou bash dans la session (à l’aide du
sessionIdde l’étape de création) - Lister les sessions de navigateur — répertorie les sessions actives ou détruites
- Supprimer une session de navigateur — détruit une session lorsque vous avez terminé
- Les workflows de navigateur en plusieurs étapes nécessitant de conserver l’état entre les pages
- La navigation dans des pages dynamiques lorsque le nombre d’étapes n’est pas connu à l’avance
- Les workflows utilisant des profils de navigateur persistants pour conserver les cookies et le localStorage entre les exécutions
sessionId de l’étape de création à chaque étape d’exécution ou de suppression suivante. Utilisez le nœud Loop Over Items de n8n pour parcourir une liste dynamique de pages et appeler Exécuter pour chacune d’elles au sein de la même session.
Pour en savoir plus sur la fonctionnalité Browser Sandbox, consultez la documentation de Browser Sandbox.
Modèles et exemples de workflows
Modèles à la une
Tutoriel complet n8n
Créez un chatbot IA avec accès au web à l’aide de Firecrawl et n8n
8 workflows prêts pour la production
Modèles prêts à l’emploi pour la génération de prospects, la surveillance des prix et bien plus encore
Pipeline RAG Supabase pgvector
Scrapez des pages, générez des embeddings et stockez-les dans Supabase pgvector pour le RAG
Enrichissement de prospects par IA
Scrapez les sites web d’entreprises et extrayez des signaux commerciaux structurés
Pipeline RAG Pinecone
Scrapez des pages, générez des embeddings et stockez-les dans Pinecone pour le RAG
Workflows de la communauté n8n
Parcourez des centaines de workflows utilisant Firecrawl
Intégration officielle de n8n
Consultez la documentation officielle de l’intégration
Comment importer des modèles
- Cliquez sur un lien vers un modèle de workflow
- Sur la page du modèle, cliquez sur le bouton « Import template to localhost:5678 self-hosted instance »
- Le workflow s’ouvre dans votre instance n8n
- Configurez les identifiants de chaque nœud
- Personnalisez les paramètres selon votre cas d’utilisation
- Activez le workflow

Bonnes pratiques
Tests et débogage
- Testez toujours les workflows manuellement avant d’activer les planifications
- Utilisez le bouton “Exécuter le workflow” pour tester l’ensemble du flux
- Vérifiez les données de sortie de chaque nœud pour vous assurer qu’elles sont correctes
- Utilisez l’onglet “Exécutions” pour consulter les exécutions précédentes et résoudre les problèmes

Gestion des erreurs
- Ajoutez des nœuds Error Trigger pour détecter et gérer les erreurs
- Configurez des notifications en cas d’échec des workflows
- Utilisez le paramètre “Continue On Fail” pour les nœuds non critiques
- Surveillez régulièrement l’exécution de vos workflows
Optimisation des performances
- Utilisez l’extraction par lot pour traiter plusieurs URL plutôt que de recourir à des boucles
- Définissez des limites de débit appropriées pour éviter de surcharger les sites cibles
- Mettez les données en cache lorsque possible afin de réduire les requêtes inutiles
- Planifiez les workflows intensifs pendant les heures creuses
Sécurité
- N’exposez jamais de clés API dans les configurations de workflow
- Utilisez le système d’identifiants de n8n pour stocker vos informations d’authentification de manière sécurisée
- Soyez prudent lorsque vous partagez des workflows publiquement
- Respectez les conditions d’utilisation et le fichier robots.txt des sites web ciblés
Prochaines étapes
Explorer les fonctionnalités avancées
- Étudiez les configurations de webhooks pour traiter les données en temps réel
- Expérimentez l’extraction optimisée par l’IA à l’aide de prompts et de schémas
- Créez des workflows complexes en plusieurs étapes avec une logique de branchement
Rejoignez la communauté
- Discord de Firecrawl - Obtenez de l’aide avec Firecrawl et échangez sur le web scraping
- Forum de la communauté n8n - Posez vos questions sur l’automatisation des workflows
- Partagez vos workflows et inspirez-vous des autres
Parcours d’apprentissage recommandé
- Réalisez les exemples de workflows de ce guide
- Modifiez les modèles de la bibliothèque communautaire
- Créez un workflow pour résoudre un problème concret dans votre travail
- Explorez les fonctionnalités avancées de Firecrawl
- Partagez vos propres modèles pour aider les autres
Besoin d’aide ? Si vous êtes bloqué ou avez des questions, les communautés Firecrawl et n8n sont actives et prêtes à vous aider. N’hésitez pas à demander conseil lors de la création de vos automatisations.

