- Inicio
- Recursos
- Integraciones
- BrightData
Integración BrightData n8nAutomatiza BrightData con n8n.
Traer datos públicos de la web a un flujo de trabajo sin mantener un scraper propio: ese es el tema. La integración BrightData n8n abre 16 operaciones repartidas en 3 recursos: Web Scraper, Marketplace Dataset y Web Unlocker. Aquí nada escucha por su cuenta.
Nodo comunitario Este nodo no viene con n8n: es un paquete comunitario (@brightdata/n8n-nodes-brightdata) que instalas desde Settings › Community nodes en una instancia autoalojada. npm
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Qué resuelve de verdad la integración BrightData n8n?
La integración BrightData n8n habla con Bright Data para extraer páginas web, o para tirar de los datasets ya montados del marketplace en forma de snapshots. Un snapshot es una exportación congelada de registros: se genera una vez y luego se lee o se envía a otro sitio con su identificador.
Tres recursos para tres trabajos distintos. Web Scraper ejecuta extracciones a partir de un dataset, Marketplace Dataset opera sobre datos de catálogo que nadie ha recogido en tu casa, y Web Unlocker apunta a una página concreta o a una página de resultados de Google.
Escenario uno, visibilidad en buscadores. webUnlocker.WebSearch lanza una consulta desde un país concreto y devuelve la página de resultados como datos, lista para comparar semana a semana. El nodo Code normaliza las posiciones antes de guardarlas, y el informe sale por Gmail cada lunes.
Escenario dos, vigilancia de precios. Un Schedule Trigger, es decir un disparador que salta a intervalo fijo, arranca el flujo de madrugada. webScrapper.triggerCollectionByUrl abre un lote sobre una lista de fichas de producto y webScrapper.monitorProgressSnapshot vigila el estado hasta que llega a Ready. Las filas acaban en una hoja mediante Google Sheets.
Escenario tres, estudio de mercado sobre datos de catálogo. marketplaceDataset.listDatasets enseña lo que hay disponible, marketplaceDataset.filterDataset recorta hasta los registros que importan y el snapshot resultante viaja directo a tu propio almacenamiento, sin pasos intermedios.
Cuando el nodo se queda corto, entra el nodo HTTP Request: llama a cualquier otro endpoint de la API de Bright Data reutilizando el mismo credential mediante la autenticación predefinida. Es la salida para todo lo que queda fuera de estas 16 operaciones.
Dos límites conviene tenerlos claros antes de montar nada. No existe ningún trigger de BrightData en n8n, así que aquí nada reacciona solo a un evento. Y la recogida es asíncrona: las operaciones por lotes devuelven un identificador de snapshot, no filas, de modo que un flujo que quiera los datos en la misma ejecución tiene que consultar el estado o esperar un aviso. Sobre la plataforma en general, la Reseña n8n lo repasa.
¿Cómo se conecta BrightData dentro de n8n?
- 01
Instalar el paquete comunitario
Este nodo no viene incluido con n8n. Entra en Settings, abre Community nodes e instala el paquete npm
@brightdata/n8n-nodes-brightdata(versión1.1.1). Ese camino solo existe en una instancia autoalojada, tanto si levantas n8n con Docker como si lo haces por npm. En n8n Cloud únicamente se aceptan nodos comunitarios verificados, así que comprueba ese estado antes de diseñar nada encima. - 02
Crear el credential una sola vez
Usa el menú Credentials, no el propio flujo. Un credential es el juego de datos de acceso que n8n guarda aparte: creado una vez, se reutiliza en todos los flujos de la instancia y el nodo lo ofrece en su lista desplegable en cuanto lo colocas en el lienzo. El nodo no tiene selector de autenticación, así que solo hay un credential que elegir y nada más que decidir.
- 03
Probar con una operación ligera
Elige el recurso Web Unlocker y la operación Send a Request, rellena una Zone y un Country, pega una URL que ya conozcas y deja Format en Raw. Ejecuta el nodo suelto. Si vuelve una respuesta, el paquete, el credential y la zona están alineados los tres, y ya puedes pasar a las operaciones de recogida más pesadas.
Lo que hace el nodo BrightData , operación por operación
El nodo BrightData expone 16 operaciones en 3 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
| Recurso | 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 | ✓ | ✓ |
Índice de operaciones
- Deliver a snapshot to specified storage
- Filter a dataset to create a snapshot
- Retrieve metadata for a specific dataset by dataset id
- Retrieve data by snapshot id
- Get metadata for a selected snapshot by snapshot id
- Split snapshot data to parts by snapshot id
- List available datasets
- List all your snapshot ids
Marketplace Dataset
8 operacionesDeliver a snapshot to specified storage
marketplaceDataset.deliverSnapshotLo que ves en n8n
Notas y casos de uso
Manda un snapshot de marketplace ya terminado a un almacenamiento tuyo, en lugar de dejarlo esperando a que alguien lo descargue.
Parámetros clave
- Snapshot ID: el snapshot afectado, muchas veces
{{ $json.snapshot_id }}heredado del paso de filtrado. - Filename Template: el patrón de nombre del archivo entregado, con sus placeholders, junto a File Extension en JSON, JSONL o CSV.
- Deliver Type: el destino, desde Amazon S3 y Google Cloud Storage hasta SFTP, Snowflake, Microsoft Azure, Aliyun Object Storage Service, Google Cloud PubSub o un Webhook a secas. Cada destino pide sus campos, Bucket y AWS Access Key en uno, Host y Username en otro.
Filter a dataset to create a snapshot
marketplaceDataset.filterDatasetLo que ves en n8n
Notas y casos de uso
Recorta un dataset del marketplace hasta los registros que interesan y convierte el resultado en un snapshot que luego se puede leer.
Parámetros clave
- Dataset: el dataset de trabajo, elegido de la lista en vez de escrito a mano.
- Filter Type: Single Filter para una condición, Group Filters cuando se combinan varias.
- Field Name, Operator y Field Value: la condición en sí, con operadores como Equals, Not Equals, Greater Than, Includes, In y sus negativos.
- Records Limit: pone techo al número de registros que entran en el snapshot.
Retrieve metadata for a specific dataset by dataset id
marketplaceDataset.getDatasetMetadataLo que ves en n8n
Notas y casos de uso
Describe un dataset en lugar de sacar sus registros: qué contiene y cómo está estructurado. Es justo lo que hace falta antes de escribir un filtro sobre él.
Parámetros clave
- Dataset: el único campo que rellenar, tomado de la lista de datasets disponibles en la cuenta.
Retrieve data by snapshot id
marketplaceDataset.getSnapshotContentLo que ves en n8n
Notas y casos de uso
Devuelve los registros guardados en un snapshot del marketplace, por tandas cuando el volumen lo pide.
Parámetros clave
- Snapshot ID: el snapshot que se lee, normalmente el que salió del paso de filtrado.
- Batch Size: cuántos registros llegan por respuesta, y Part indica qué tanda, numerada desde 1.
- Format: JSON, JSONL o CSV, y Compress para recibir la respuesta en gzip.
Get metadata for a selected snapshot by snapshot id
marketplaceDataset.getSnapshotMetadataLo que ves en n8n
Notas y casos de uso
Entrega la descripción de un snapshot del marketplace sin sacar ni un registro, lo que mantiene el paso barato cuando solo buscas contexto.
Parámetros clave
- Snapshot ID: único campo obligatorio, el identificador del snapshot que se inspecciona.
Split snapshot data to parts by snapshot id
marketplaceDataset.getSnapshotPartsLo que ves en n8n
Notas y casos de uso
Trocea un snapshot del marketplace en partes y cuenta cómo quedó la división, para repartir la descarga entre varias ejecuciones.
Parámetros clave
- Snapshot ID: el snapshot que se trocea, sin nada más que configurar.
List available datasets
marketplaceDataset.listDatasetsLo que ves en n8n
Notas y casos de uso
Devuelve los datasets del marketplace a los que llega la cuenta, sin un solo parámetro que rellenar.
List all your snapshot ids
marketplaceDataset.listSnapshotsLo que ves en n8n
Notas y casos de uso
Devuelve los identificadores de snapshots ya creados sobre un dataset del marketplace, para que un flujo reaproveche uno en lugar de fabricar otro.
Parámetros clave
- Dataset: el dataset cuyos snapshots quieres listar.
- Status: filtra por estado, desde Building, Collecting y Digesting hasta Ready, Failed o Canceled.
- View: el identificador de una vista para estrechar todavía más la lista.
Web Scraper
6 operacionesDeliver a snapshot to specified storage
webScrapper.deliverSnapshotLo que ves en n8n
Notas y casos de uso
Los mismos destinos que su gemela del marketplace, aplicados a un snapshot salido de tu propia recogida, y además con un aviso al terminar la transferencia.
Parámetros clave
- Notify: una URL que se llama al acabar la entrega, y que un Webhook de n8n puede recibir para seguir el flujo.
- Snapshot ID, Filename Template y File Extension: qué enviar, con qué nombre, en JSON, JSONL o CSV.
- Deliver Type: S3, Google Cloud Storage, Azure, SFTP, Snowflake, PubSub, Aliyun o Webhook, cada uno con sus campos obligatorios.
Download the snapshot content
webScrapper.downloadSnapshotLo que ves en n8n
Notas y casos de uso
Trae los registros rastreados de vuelta al flujo como items, en lugar de empujarlos a un almacenamiento externo.
Parámetros clave
- Snapshot ID: el lote que se descarga, casi siempre el identificador devuelto al lanzar la recogida.
- Format: JSON o CSV, obligatorio en ambos casos.
- Split Into Parts: actívalo en snapshots grandes y después usa Batch Size y Part para traerlos a trozos.
Get filtered snapshots
webScrapper.getSnapshotsLo que ves en n8n
Notas y casos de uso
Busca entre tus snapshots de recogida dentro de una ventana temporal, en vez de listar todo lo producido desde el principio.
Parámetros clave
- Dataset: el dataset sobre el que se busca.
- From Date y To Date: la ventana, obligatorias las dos, en formato ISO 8601.
- Status: limita la respuesta a un estado, siendo Ready y Failed los dos que más se usan.
- Limit: pone techo a los resultados, y Skip salta los primeros.
Check the status of a batch extraction
webScrapper.monitorProgressSnapshotLo que ves en n8n
Notas y casos de uso
Responde a una sola pregunta sobre una recogida en marcha: por dónde va. Como el proceso es asíncrono, esto es lo que convierte un identificador de snapshot en una decisión.
Parámetros clave
- Snapshot ID: la extracción vigilada, el único campo que se rellena.
Extract structured data from a single URL
webScrapper.scrapeByUrlLo que ves en n8n
Notas y casos de uso
Ejecuta una extracción y entrega el resultado estructurado en el momento, sin la ida y vuelta por un snapshot que exige la recogida por lotes.
Parámetros clave
- Dataset: el dataset que define qué se extrae de la página.
- URLs: las direcciones a tratar, en JSON, que pueden venir de un nodo anterior.
- Include Errors: obligatorio, y conviene dejarlo activo para que una página fallida se reporte en vez de desaparecer sin aviso.
- Format: JSON o CSV.
Initiate batch extraction from URL
webScrapper.triggerCollectionByUrlLo que ves en n8n
Notas y casos de uso
Pone en marcha una recogida sobre muchas direcciones a la vez y devuelve un identificador, no los datos. Las filas llegan más tarde.
Parámetros clave
- Dataset: la plantilla de extracción que se aplica a cada dirección del lote.
- URLs: la lista a recoger, en JSON.
- Endpoint: adónde se mandan los datos recogidos una vez existen.
- Notify: una URL avisada al terminar la recogida, lo que ahorra estar consultando el estado.
Web Unlocker
2 operacionesSearch the web and get serp results
webUnlocker.WebSearchLo que ves en n8n
Notas y casos de uso
Lanza una consulta a Google y devuelve la página de resultados convertida en datos, el camino más corto para meter la visibilidad en buscadores dentro de un flujo.
Parámetros clave
- Zone: la zona de Bright Data por la que sale la petición.
- Country: el país desde el que se busca, que cambia lo que Google contesta.
- Search Query: la consulta en sí.
- Page: 1 para la primera página de resultados, 2 para la siguiente, y así sucesivamente.
Access and extract data from a specific URL
webUnlocker.requestLo que ves en n8n
Notas y casos de uso
Funciona como una petición contra una página concreta, encaminada por una zona, y devuelve lo que esa página conteste.
Parámetros clave
- URL y Method: el objetivo y el verbo, GET, POST, PUT, PATCH, DELETE o HEAD.
- Zone y Country: el camino que toma la petición.
- Format: Raw o JSON, y Data Format en Markdown cuando la respuesta alimenta a un modelo de lenguaje, lo que fuerza el formato a Raw.
¿Necesitas ayuda para automatizar BrightData con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.


