n8n

​

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

1. Accédez à firecrawl.dev dans votre navigateur web
2. Cliquez sur le bouton « Get Started » ou « Sign Up »
3. Créez un compte avec votre adresse e-mail ou votre identifiant GitHub
4. Vérifiez votre adresse e-mail si vous y êtes invité

​

Obtenez votre clé API

1. Accédez à votre tableau de bord Firecrawl
2. Ouvrez la page API Keys
3. Cliquez sur « Create New API Key »
4. Donnez à votre clé un nom descriptif (par exemple, « n8n Integration »)
5. Copiez la clé API générée et conservez-la dans un endroit sûr

​

É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)

1. Rendez-vous sur n8n.cloud
2. Cliquez sur « Start Free » ou « Sign Up »
3. Inscrivez-vous avec votre adresse e-mail ou votre compte GitHub
4. Terminez le processus de vérification
5. 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

1. Ouvrez votre terminal ou votre invite de commandes
2. Créez un volume Docker pour conserver les données de votre workflow :

docker volume create n8n_data

3. Démarrez le conteneur Docker n8n :

docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n

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

​

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

1. Dans le canevas de votre nouveau workflow, cliquez sur le bouton ”+” au centre
2. Le panneau de sélection des nœuds s’ouvre à droite
3. Dans le champ de recherche en haut, saisissez “Firecrawl”
4. Le nœud Firecrawl apparaît dans les résultats de recherche

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

​

Connectez votre clé API Firecrawl

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

4. Une fenêtre de configuration des identifiants s’ouvre.
5. Saisissez un nom pour cet identifiant (par exemple, « Mon compte Firecrawl »).
6. Collez votre clé API Firecrawl dans le champ « API Key ».
7. Cliquez sur « Save » en bas.

​

Testez votre connexion

1. Le nœud Firecrawl étant toujours sélectionné, consultez le panneau de configuration.
2. Définissez Resource sur « Scraping » et Operation sur « Scrape URL ».
3. Dans le champ « URL », saisissez : https://firecrawl.dev.
4. Laissez les autres paramètres sur leurs valeurs par défaut pour le moment.
5. Cliquez sur le bouton « Execute step ».

​

Étape 4 : Créez votre bot Telegram

​

Créer un bot avec BotFather

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

​

Obtenir votre ID de chat

1. Ouvrez votre navigateur web et accédez à cette URL (remplacez YOUR_BOT_TOKEN par le jeton réel de votre bot) :
   https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates
   
2. Gardez cet onglet ouvert
3. Recherchez maintenant le nom d’utilisateur de votre bot dans Telegram (celui que vous venez de créer)
4. Démarrez une conversation avec votre bot en cliquant sur « Start »
5. Envoyez un message quelconque à votre bot (par exemple, « bonjour »)
6. Revenez à l’onglet du navigateur et actualisez la page
7. Recherchez le champ "chat":{"id": dans la réponse JSON
8. Le nombre à côté de "id": est votre ID de chat (par exemple, 123456789)
9. Conservez cet ID de chat pour plus tard

​

É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

1. Créez un nouveau workflow dans n8n
2. Ajoutez un nœud Déclencheur planifié :
   • Cliquez sur le bouton ”+” sur le canevas
   • Recherchez “Déclencheur planifié”
   • Configurez : tous les jours à 9 h 00

3. Ajoutez le nœud Firecrawl :
   • Cliquez sur ”+” à côté du Déclencheur planifié
   • Recherchez et ajoutez “Firecrawl”
   • Sélectionnez vos identifiants Firecrawl
   • Configurez :
     • Ressource : Scraping
     • Opération : Extraire le contenu d’une URL
     • URL : https://www.firecrawl.dev/blog/category/product-updates
     • Options d’extraction : ajoutez Formats et sélectionnez “Summary”

4. Ajoutez le nœud Telegram :
   • Cliquez sur ”+” à côté de Firecrawl
   • Recherchez “Telegram”
   • Cliquez sur “Envoyer un message texte” pour l’ajouter au canevas
5. 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”

6. 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 summary (sous data) depuis la sortie du nœud Firecrawl.

7. Testez le workflow :
   • Cliquez sur “Exécuter le workflow”
   • Vérifiez sur Telegram que vous avez reçu le message de résumé

8. 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

1. Créez un workflow et ajoutez un nœud Manual Trigger
2. Ajoutez un nœud Firecrawl avec les paramètres suivants :
   • Resource : Map & Search
   • Operation : Search Web
   • Query : ai news
   • Limit : 5

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

const results = $input.all();
let message = "Latest AI News:\n\n";

results.forEach((item) => {
  const webData = item.json.data?.web || [];
  webData.forEach((article, index) => {
    message += `${index + 1}. ${article.title}\n`;
    message += `${article.description}\n`;
    message += `${article.url}\n\n`;
  });
});

return [{ json: { message } }];

4. Mettez à jour le nœud Telegram (avec vos identifiants enregistrés) :
   • Texte : faites glisser le champ message depuis le nœud Code

​

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

1. 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)

2. 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 message du nœud Code vers le champ de prompt d’entrée de l’agent IA
   • Sélectionnez OpenAI comme fournisseur de LLM

3. 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”

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

Tu es analyste de l'actualité de l'IA. Analyse les articles d'actualité sur l'IA fournis et rédige une synthèse
concise et pertinente mettant en avant les avancées et tendances les plus marquantes.
Regroupe les sujets connexes et explique en quoi ces avancées sont importantes.
Garde un ton conversationnel et captivant, sur environ 3 à 4 paragraphes.

5. 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

​

Comprendre les opérations Firecrawl

​

Extraire le contenu d’une URL

• 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
• Renvoie des données structurées avec le format JSON et un prompt ou un schéma
• 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

​

Interact

• Execute Interaction : exécute un prompt ou du code sur une page scrapée, à partir du scrapeId issu de la sortie de Scrape URL (data.metadata.scrapeId)
• Stop Interaction : met fin à la session interactive associée à ce scrapeId
• Get Interact Context : renvoie des instructions d’utilisation destinées aux agents IA qui appellent ces opérations en tant qu’outils

{
  "profile": {
    "name": "my-profile",
    "saveChanges": true
  }
}

​

Rechercher sur le Web

• 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 tâche
• Peut filtrer les URL selon des motifs
• Renvoie un ID de tâche d’exploration ; ajoutez un second nœud Firecrawl avec Get Crawl Status pour lire les pages scrapées

• L’extraction complète d’une documentation
• L’archivage de sites
• La collecte de données sur plusieurs pages

​

Cartographier un site web

• Découvre 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 URL par lots

• Traite une liste d’URL en une seule fois, avec les mêmes options d’extraction pour chacune
• Plus efficace qu’une boucle
• Renvoie un ID de tâche de lot ; ajoutez Get Batch Scrape Status pour récupérer l’ensemble des résultats en une 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, ainsi que des URL et un schéma JSON facultatifs
• L’agent IA navigue et extrait les informations de manière autonome
• Disponible sous deux formes : Extract Data With AI Agent (attend les résultats) et Start AI Agent Job (Async) (renvoie immédiatement un ID de tâche)
• Utilisez Get Agent Status pour interroger l’état et récupérer les résultats avec l’opération asynchrone

• La collecte de données complexe sur plusieurs pages, guidée par un prompt
• L’extraction d’informations lorsque vous ne connaissez pas la structure exacte de la page
• Les tâches de recherche qui nécessitent de naviguer sur plusieurs pages

• Extract Data With AI Agent démarre la tâche et attend le résultat en une seule étape : c’est l’option la plus simple dans 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 avant l’expiration du délai (par défaut : 300 secondes, maximum : 600 secondes). Si la tâche d’agent dure plus longtemps, le nœud renvoie un état timeout avec le jobId, même si la tâche peut encore aboutir côté Firecrawl. Transmettez cet ID à Get Agent Status, ou utilisez l’opération asynchrone pour les tâches susceptibles de dépasser 10 minutes.
• Start AI Agent Job (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.

​

Extraire des données structurées (ancienne version)

​

Browser Sandbox

• Create Browser Session : démarre une nouvelle session de navigateur et renvoie son id
• Execute Browser Code : exécute du code Node (Playwright), Python ou Bash dans la session, en utilisant l’id obtenu à l’étape Create comme Session ID
• Get Many Browser Sessions : répertorie les sessions actives ou détruites
• Delete Browser Session : détruit une session lorsque vous avez terminé
• Get Browser Context : renvoie les instructions d’utilisation et les sessions actives aux agents IA qui appellent ces opérations en tant qu’outils

• 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

​

Compte

​

Modèles et exemples de workflows

​

Modèles à la une

​

Comment importer des modèles

1. Cliquez sur un lien vers un modèle de workflow
2. Sur la page du modèle, cliquez sur le bouton « Import template to localhost:5678 self-hosted instance »
3. Le workflow s’ouvre dans votre instance n8n
4. Configurez les identifiants de chaque nœud
5. Personnalisez les paramètres selon votre cas d’utilisation
6. 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é

1. Réalisez les exemples de workflows de ce guide
2. Modifiez les modèles de la bibliothèque communautaire
3. Créez un workflow pour résoudre un problème concret dans votre travail
4. Explorez les fonctionnalités avancées de Firecrawl
5. Partagez vos propres modèles pour aider les autres

​

Ressources supplémentaires

• Documentation de l’API Firecrawl
• Documentation de n8n
• Bonnes pratiques du web scraping