Ressources · Intégration n8n

Intégration BrightData n8nAutomatiser BrightData avec n8n.

Récupérer des données web publiques dans un workflow sans maintenir son propre scraper, c'est le sujet. L'intégration BrightData n8n donne accès à 16 opérations sur 3 ressources : Web Scraper, Marketplace Dataset et Web Unlocker. Rien n'écoute tout seul ici.

Nœud communautaire Ce nœud n'est pas livré avec n8n : c'est un paquet communautaire (@brightdata/n8n-nodes-brightdata) à installer depuis Settings › Community nodes sur une instance auto-hébergée. npm

Tester l'intégration BrightData sur n8n Voir les 16 opérations

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert vraiment l'intégration BrightData n8n ?

L'intégration BrightData n8n dialogue avec Bright Data pour extraire des pages web, ou pour piocher dans les datasets déjà constitués de la marketplace sous forme de snapshots. Un snapshot, c'est un export figé d'enregistrements, relu ou expédié ensuite via son identifiant.

Trois ressources, trois métiers différents. Web Scraper lance des extractions à partir d'un dataset, Marketplace Dataset travaille sur des données de catalogue que personne n'a collectées chez toi, et Web Unlocker vise une page unique ou une page de résultats Google.

Premier scénario, la veille tarifaire. Un Schedule Trigger, c'est-à-dire un déclencheur qui part à intervalle fixe, réveille le workflow chaque matin. webScrapper.triggerCollectionByUrl lance un lot sur une liste de fiches produit, puis webScrapper.monitorProgressSnapshot surveille l'état jusqu'à ce qu'il passe à Ready. Les lignes atterrissent ensuite dans MySQL quand il faut garder l'historique.

Deuxième scénario, la page à la demande. Un outil interne appelle un Webhook n8n, autrement dit une URL que n8n expose pour être appelée de l'extérieur, et webUnlocker.request va chercher cette URL précise à travers une zone. Réponse immédiate, aucun snapshot à attendre. Un message dans Slack suffit à prévenir l'équipe.

Troisième scénario, l'étude de marché sur données de catalogue. marketplaceDataset.listDatasets montre ce qui existe, marketplaceDataset.filterDataset resserre sur les enregistrements utiles, et le snapshot obtenu part directement vers ton propre stockage sans transiter par une feuille intermédiaire.

Quand le nœud s'arrête, le nœud HTTP Request prend le relais : il appelle n'importe quel autre endpoint de l'API Bright Data en réutilisant le même credential via l'authentification prédéfinie. C'est la porte de sortie pour tout ce qui sort de ces 16 opérations.

Deux limites à connaître avant de construire. Il n'existe aucun trigger BrightData dans n8n, donc rien ne réagit spontanément à un événement. Et la collecte est asynchrone : les opérations de lot renvoient un identifiant de snapshot, pas des lignes. Un workflow qui veut les données dans la même exécution doit donc surveiller le statut ou attendre une notification. Pour le reste de la plateforme, l'Avis n8n fait le tour.

Connexion

Comment brancher BrightData dans n8n ?

01
Installer le paquet communautaire
Ce nœud n'est pas livré avec n8n. Direction Settings, puis Community nodes, et installe le paquet npm @brightdata/n8n-nodes-brightdata (version 1.1.1). Ce chemin n'existe que sur une instance auto-hébergée, que n8n tourne sous Docker ou via npm. Sur n8n Cloud, seuls les nœuds communautaires vérifiés sont acceptés : vérifie ce statut avant de bâtir dessus.
02
Créer le credential une seule fois
Passe par le menu Credentials, pas par le workflow. Un credential, c'est le jeu d'identifiants que n8n stocke à part : créé une fois, il se réutilise dans tous les workflows de l'instance, et le nœud le propose dans sa liste déroulante dès que tu le poses sur le canevas. Le nœud n'a pas de sélecteur d'authentification, donc il n'y a qu'un credential à choisir, rien d'autre.
03
Tester avec une opération légère
Choisis la ressource Web Unlocker et l'opération Send a Request, renseigne une Zone et un Country, colle une URL que tu connais déjà, laisse Format sur Raw. Exécute le nœud seul. Une réponse qui revient prouve que le paquet, le credential et la zone sont alignés tous les trois, et tu peux passer aux opérations de collecte plus lourdes.

Actions

Ce que le nœud BrightData sait faire, opération par opération

Le nœud BrightData expose 16 opérations sur 3 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
Ressource	Deliver Snapshot	Download Snapshot	Filter Dataset	Get Dataset Metadata	Get Snapshot Content	Get Snapshot Metadata	Get Snapshot Parts	Get Snapshots	List Datasets	List Snapshots	Monitor Progress Snapshot	Send a Request	Scrape By URL	Trigger Collection By URL	Web Search
Marketplace Dataset	✓		✓	✓	✓	✓	✓		✓	✓
Web Scraper	✓	✓						✓			✓		✓	✓
Web Unlocker												✓			✓

Marketplace Dataset

8 opérations

Deliver a snapshot to specified storage

marketplaceDataset.deliverSnapshot

Ce que tu vois dans n8n

BrightDataParameters

Credential to connect withBrightData account

ResourceMarketplace Dataset

OperationDeliver Snapshot

Snapshot ID *{{ $json.snapshot_id }}

Filename Template *{{ $json.filename_template }}

File Extension *{{ $json.filename_extension }}

Topic ID *{{ $json.topic_id }}

Client Email *{{ $json.client_email }}

Private Key *{{ $json.private_key }}

Container *{{ $json.container }}

Bucket *{{ $json.bucket }}

AWS Access Key *{{ $json.aws-access-key }}

AWS Secret Key *{{ $json.aws-secret-key }}

Access Key *{{ $json.access-key }}

Secret Key *{{ $json.secret-key }}

Account *{{ $json.account }}

Key *{{ $json.key }}

SAS Token *{{ $json.sas_token }}

Host *{{ $json.host }}

Username *{{ $json.username }}

Password *{{ $json.password }}

SSH Key *{{ $json.ssh_key }}

Database *{{ $json.database }}

Schema *{{ $json.schema }}

Stage *{{ $json.stage }}

Role *{{ $json.role }}

Warehouse *{{ $json.warehouse }}

Account *{{ $json.credentials.account }}

User *{{ $json.credentials.user }}

Password *{{ $json.credentials.password }}

Notes & cas d'usage

Expédie un snapshot marketplace terminé vers un stockage qui t'appartient, au lieu de le laisser en attente de téléchargement.

Paramètres clés

Snapshot ID : le snapshot concerné, souvent {{ $json.snapshot_id }} repris de l'étape de filtrage.
Filename Template : le motif de nom du fichier livré, placeholders compris, associé à File Extension réglé sur JSON, JSONL ou CSV.
Deliver Type : la destination, d'Amazon S3 et Google Cloud Storage à SFTP, Snowflake, Microsoft Azure, Aliyun Object Storage Service, Google Cloud PubSub ou un simple Webhook. Chacune réclame ensuite ses propres champs, Bucket et AWS Access Key ici, Host et Username là.

Cas d'usage

une copie planifiée des données catalogue déposée dans le bucket que ton reporting lit déjà.

Filter a dataset to create a snapshot

marketplaceDataset.filterDataset

Ce que tu vois dans n8n

Notes & cas d'usage

Réduit un dataset de la marketplace aux enregistrements voulus et transforme le résultat en snapshot relisable ensuite.

Paramètres clés

Dataset : le dataset visé, choisi dans la liste plutôt que saisi à la main.
Filter Type : Single Filter pour une condition, Group Filters quand plusieurs se combinent.
Field Name, Operator et Field Value : la condition elle-même, avec des opérateurs qui couvrent Equals, Not Equals, Greater Than, Includes, In et leurs négatifs.
Records Limit : plafonne le nombre d'enregistrements retenus.

Cas d'usage

ne garder que les annonces au-dessus d'un seuil de prix avant tout export.

Retrieve metadata for a specific dataset by dataset id

marketplaceDataset.getDatasetMetadata

Ce que tu vois dans n8n

Notes & cas d'usage

Décrit un dataset au lieu d'en sortir les enregistrements : ce qu'il contient, comment il est structuré. C'est exactement ce qu'il faut avant d'écrire un filtre dessus.

Paramètres clés

Dataset : le seul champ à remplir, pris dans la liste des datasets disponibles sur le compte.

Cas d'usage

lire une fois les noms de champs d'un dataset marketplace, pour que le Field Name utilisé plus tard corresponde à ce qui existe vraiment et pas à une supposition.

Retrieve data by snapshot id

marketplaceDataset.getSnapshotContent

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les enregistrements contenus dans un snapshot marketplace, par paquets quand le volume le justifie.

Paramètres clés

Snapshot ID : le snapshot à relire, typiquement celui produit par l'étape de filtrage.
Batch Size : le nombre d'enregistrements par réponse, Part désignant le paquet voulu, numéroté à partir de 1.
Format : JSON, JSONL ou CSV, et Compress pour recevoir la réponse en gzip.

Cas d'usage

parcourir un gros snapshot paquet par paquet dans une boucle, sans jamais tout charger d'un coup.

Get metadata for a selected snapshot by snapshot id

marketplaceDataset.getSnapshotMetadata

Ce que tu vois dans n8n

Notes & cas d'usage

Donne la description d'un snapshot marketplace sans en tirer le moindre enregistrement, ce qui garde l'étape légère quand seul le contexte compte.

Paramètres clés

Snapshot ID : unique champ requis, l'identifiant du snapshot à inspecter.

Cas d'usage

une branche qui lit d'abord la description d'un snapshot, puis décide seulement après si le contenu mérite d'être téléchargé ou si le filtre doit repartir avec d'autres valeurs.

Split snapshot data to parts by snapshot id

marketplaceDataset.getSnapshotParts

Ce que tu vois dans n8n

Notes & cas d'usage

Découpe un snapshot marketplace en parties et indique comment la division s'est faite, pour étaler la récupération sur plusieurs exécutions.

Paramètres clés

Snapshot ID : le snapshot à découper, rien d'autre à régler.

Cas d'usage

préparer un export volumineux, puis injecter chaque numéro de partie dans le champ Part de l'opération de lecture. C'est l'étape de préparation, pas le remplacement de la lecture elle-même.

List available datasets

marketplaceDataset.listDatasets

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les datasets marketplace accessibles au compte, sans le moindre paramètre à remplir.

Cas d'usage

une étape de découverte en tête de workflow, lancée une fois pour voir ce qui existe avant de construire quoi que ce soit. Elle sert aussi de contrôle pendant l'installation : une liste qui revient prouve que le paquet communautaire est bien en place et que le credential est valide, bien avant de configurer la première collecte.

List all your snapshot ids

marketplaceDataset.listSnapshots

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les identifiants de snapshots déjà créés sur un dataset marketplace donné, pour qu'un workflow en reprenne un au lieu d'en refabriquer un autre.

Paramètres clés

Dataset : le dataset dont on veut lister les snapshots.
Status : filtre sur l'état, de Building, Collecting et Digesting jusqu'à Ready, Failed ou Canceled.
View : l'identifiant d'une vue pour resserrer encore la liste.

Cas d'usage

une routine de ménage qui liste tout ce qui est resté en Failed et le remonte.

Web Scraper

6 opérations

Deliver a snapshot to specified storage

webScrapper.deliverSnapshot

Ce que tu vois dans n8n

BrightDataParameters

Credential to connect withBrightData account

ResourceWeb Scraper

OperationDeliver Snapshot

Snapshot ID *{{ $json.snapshot_id }}

Filename Template *{{ $json.filename_template }}

File Extension *{{ $json.filename_extension }}

Topic ID *{{ $json.topic_id }}

Client Email *{{ $json.client_email }}

Private Key *{{ $json.private_key }}

Container *{{ $json.container }}

Bucket *{{ $json.bucket }}

AWS Access Key *{{ $json.aws-access-key }}

AWS Secret Key *{{ $json.aws-secret-key }}

Access Key *{{ $json.access-key }}

Secret Key *{{ $json.secret-key }}

Account *{{ $json.account }}

Key *{{ $json.key }}

SAS Token *{{ $json.sas_token }}

Host *{{ $json.host }}

Username *{{ $json.username }}

Password *{{ $json.password }}

SSH Key *{{ $json.ssh_key }}

Database *{{ $json.database }}

Schema *{{ $json.schema }}

Stage *{{ $json.stage }}

Role *{{ $json.role }}

Warehouse *{{ $json.warehouse }}

Account *{{ $json.credentials.account }}

User *{{ $json.credentials.user }}

Password *{{ $json.credentials.password }}

Notes & cas d'usage

Mêmes destinations que son homologue marketplace, appliquées cette fois à un snapshot issu de ta propre collecte, avec en plus un moyen d'être averti à la fin du transfert.

Paramètres clés

Notify : une URL appelée une fois la livraison terminée, qu'un Webhook n8n peut recevoir pour enchaîner la suite.
Snapshot ID, Filename Template et File Extension : quoi envoyer, sous quel nom, en JSON, JSONL ou CSV.
Deliver Type : S3, Google Cloud Storage, Azure, SFTP, Snowflake, PubSub, Aliyun ou Webhook, chacun avec ses champs obligatoires.

Cas d'usage

remettre un lot collecté à une équipe data sans que n8n garde le fichier.

Download the snapshot content

webScrapper.downloadSnapshot

Ce que tu vois dans n8n

Notes & cas d'usage

Ramène les enregistrements collectés dans le workflow sous forme d'items, au lieu de les pousser vers un stockage externe.

Paramètres clés

Snapshot ID : le lot à télécharger, en général l'identifiant renvoyé au lancement de la collecte.
Format : JSON ou CSV, requis dans les deux cas.
Split Into Parts : à activer sur les gros snapshots, puis Batch Size et Part pour les tirer par morceaux.

Cas d'usage

récupérer le lot terminé dès qu'un contrôle de statut le déclare prêt, puis router les items vers une base.

Get filtered snapshots

webScrapper.getSnapshots

Ce que tu vois dans n8n

Notes & cas d'usage

Cherche dans tes snapshots de collecte sur une fenêtre de temps, plutôt que de tout lister depuis le début.

Paramètres clés

Dataset : le dataset sur lequel porte la recherche.
From Date et To Date : la fenêtre, obligatoires toutes les deux, au format ISO 8601.
Status : restreint la réponse à un seul état, Ready et Failed étant les deux qui servent le plus.
Limit : plafonne le nombre de résultats, Skip passant par-dessus les premiers.

Cas d'usage

un point hebdomadaire qui compte les extractions abouties.

Check the status of a batch extraction

webScrapper.monitorProgressSnapshot

Ce que tu vois dans n8n

Notes & cas d'usage

Répond à une seule question sur une collecte en cours : où elle en est. Comme le traitement est asynchrone, c'est ce qui transforme un identifiant de snapshot en décision.

Paramètres clés

Snapshot ID : l'extraction surveillée, seul champ à renseigner.

Cas d'usage

se placer entre le Schedule Trigger et l'étape de téléchargement, pour que le workflow ne lise les données qu'une fois le lot réellement terminé au lieu de planter sur un résultat vide.

Extract structured data from a single URL

webScrapper.scrapeByUrl

Ce que tu vois dans n8n

Notes & cas d'usage

Lance une extraction et rend le résultat structuré tout de suite, sans l'aller-retour par un snapshot qu'impose la collecte en lot.

Paramètres clés

Dataset : le dataset qui définit ce qu'on extrait de la page.
URLs : les adresses à traiter, passées en JSON, éventuellement issues d'un nœud précédent.
Include Errors : requis, et à laisser actif pour qu'une page en échec soit signalée plutôt qu'écartée en silence.
Format : JSON ou CSV.

Cas d'usage

enrichir une fiche prospect à la seconde où elle arrive.

Initiate batch extraction from URL

webScrapper.triggerCollectionByUrl

Ce que tu vois dans n8n

Notes & cas d'usage

Démarre un travail de collecte sur de nombreuses adresses d'un coup et renvoie un identifiant, pas les données. Les lignes arrivent plus tard.

Paramètres clés

Dataset : le modèle d'extraction appliqué à chaque adresse du lot.
URLs : la liste à collecter, en JSON.
Endpoint : l'adresse où les données collectées sont envoyées une fois disponibles.
Notify : une URL prévenue à la fin de la collecte, ce qui évite d'aller vérifier en boucle.

Cas d'usage

mettre quelques milliers de fiches produit en file pour la nuit.

Web Unlocker

2 opérations

Search the web and get serp results

webUnlocker.WebSearch

Ce que tu vois dans n8n

Notes & cas d'usage

Envoie une requête à Google et rend la page de résultats sous forme de données, le chemin le plus court pour faire entrer la visibilité search dans un workflow.

Paramètres clés

Zone : la zone Bright Data par laquelle passe la requête.
Country : le pays depuis lequel la recherche est faite, ce qui change la réponse de Google.
Search Query : la requête elle-même.
Page : 1 pour la première page de résultats, 2 pour la suivante, et ainsi de suite.

Cas d'usage

suivre le positionnement d'une marque sur plusieurs pays.

Access and extract data from a specific URL

webUnlocker.request

Ce que tu vois dans n8n

Notes & cas d'usage

Se comporte comme une requête sur une page précise, routée par une zone, et rend ce que cette page renvoie.

Paramètres clés

URL et Method : la cible et le verbe, GET, POST, PUT, PATCH, DELETE ou HEAD.
Zone et Country : le chemin emprunté par la requête.
Format : Raw ou JSON, et Data Format sur Markdown quand la réponse alimente un modèle de langage, ce qui force le format sur Raw.

Cas d'usage

lire une page concurrente en Markdown avant de la résumer.

Besoin d'aide

Besoin d'aide pour automatiser BrightData avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

BrightData et n8n, les questions qui viennent ensuite

01L'intégration BrightData n8n est-elle gratuite ?

Côté n8n, oui. Le nœud ne coûte rien, mais il n'est pas livré avec n8n pour autant : c'est un nœud communautaire, publié sous forme de paquet npm @brightdata/n8n-nodes-brightdata en version 1.1.1. Tu l'installes toi-même depuis Settings, puis Community nodes, sur une instance auto-hébergée qui tourne sous Docker ou via npm. Sur n8n Cloud, seuls les nœuds communautaires vérifiés sont acceptés, donc ce chemin d'installation n'y est pas garanti. Que la plateforme soit hébergée par n8n ou par toi ne change rien au comportement du workflow une fois le nœud en place. Ce que coûte Bright Data en propre est un autre sujet, non traité ici.

02Quels credentials faut-il pour connecter BrightData à n8n ?

Un seul credential Bright Data, créé une fois. L'ordre compte : installe d'abord le paquet communautaire, parce que le type de credential n'apparaît qu'une fois le nœud présent sur l'instance. Ensuite, direction le menu Credentials, tu le crées là, et tous les workflows de l'instance peuvent le réutiliser. Le nœud le propose dans une liste déroulante, il n'y a donc rien à recoller deux fois. Ce nœud n'a pas de sélecteur d'authentification, autrement dit on ne te demande pas de choisir entre plusieurs méthodes comme sur certains autres nœuds. Les champs exacts à remplir sont documentés par Bright Data, pas décrits ici.

03Quelles sont les limites du nœud BrightData dans n8n ?

Trois points à anticiper. La couverture d'abord : 16 opérations réparties sur 3 ressources, et tout ce qui sort de cette liste passe par le nœud HTTP Request, capable d'appeler n'importe quel endpoint de l'API Bright Data en réutilisant le même credential via l'authentification prédéfinie. Le temps ensuite : la collecte en lot est asynchrone, les opérations rendent un identifiant de snapshot et les enregistrements n'existent qu'une fois le traitement fini. Le volume enfin : les opérations de liste et de contenu exposent Limit, Skip, Batch Size et Part au lieu de tout renvoyer d'un bloc, donc un gros export se parcourt par morceaux.

04BrightData réagit-il en temps réel dans n8n ?

Non, et ce n'est pas une case oubliée dans un réglage. Il n'existe tout simplement aucun nœud trigger BrightData dans n8n, donc un workflow qui l'utilise démarre toujours ailleurs. Trois options concrètes : un Schedule Trigger qui part à intervalle fixe, adapté à la veille tarifaire et aux exports récurrents ; un Webhook n8n appelé par un service tiers quand quelque chose bouge de ton côté ; ou le trigger d'un autre outil déjà présent dans le workflow. Bright Data sait aussi rappeler : les opérations de livraison et de collecte acceptent une URL Notify, et un Webhook n8n fait une destination parfaitement valable.

05n8n ou Make pour BrightData ?

Ça dépend de trois critères, et aucune des deux réponses n'est fausse. L'hébergement d'abord : n8n s'installe sur tes propres serveurs via Docker ou npm, là où Make est hébergé uniquement, sans option d'auto-hébergement. La maîtrise des données en découle, ce qui pèse quand des pages collectées et des enregistrements de catalogue transitent par la plateforme. Le modèle de coût ensuite : Make facture à l'opération, un point à chiffrer face à des lots qui s'étalent sur des milliers d'adresses. Les deux restent des outils visuels. Et si la voie du nœud communautaire est fermée chez toi, le nœud HTTP Request de n8n reste le repli.

Installer le paquet communautaire

Créer le credential une seule fois

Tester avec une opération légère

Besoin d'aide pour automatiser BrightData avec n8n ?