Recursos · Integración n8n

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

Por qué automatizar

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

Conexión

¿Cómo se conecta BrightData dentro de n8n?

  1. 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ón 1.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.

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

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

Acciones

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.

Matriz recursos × operaciones
RecursoDeliver SnapshotDownload SnapshotFilter DatasetGet Dataset MetadataGet Snapshot ContentGet Snapshot MetadataGet Snapshot PartsGet SnapshotsList DatasetsList SnapshotsMonitor Progress SnapshotSend a RequestScrape By URLTrigger Collection By URLWeb Search
Marketplace Dataset✓✓✓✓✓✓✓✓
Web Scraper✓✓✓✓✓✓
Web Unlocker✓✓

Marketplace Dataset

8 operaciones
01

Deliver a snapshot to specified storage

marketplaceDataset.deliverSnapshot

Lo 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.
Casos de uso
una copia programada del catálogo que aterriza en el bucket que ya lee tu reporting.
02

Filter a dataset to create a snapshot

marketplaceDataset.filterDataset

Lo 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.
Casos de uso
quedarse solo con los anuncios por encima de un precio antes de exportar nada.
03

Retrieve metadata for a specific dataset by dataset id

marketplaceDataset.getDatasetMetadata

Lo 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.
Casos de uso
leer una vez los nombres de campo de un dataset del marketplace, para que el Field Name que uses después coincida con lo que existe y no con lo que suponías.
04

Retrieve data by snapshot id

marketplaceDataset.getSnapshotContent

Lo 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.
Casos de uso
recorrer un snapshot grande tanda a tanda dentro de un bucle, sin cargarlo entero de golpe.
05

Get metadata for a selected snapshot by snapshot id

marketplaceDataset.getSnapshotMetadata

Lo 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.
Casos de uso
una rama que lee primero la descripción de un snapshot y solo después decide si el contenido merece descargarse, o si el filtro tiene que repetirse con otros valores.
06

Split snapshot data to parts by snapshot id

marketplaceDataset.getSnapshotParts

Lo 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.
Casos de uso
preparar una exportación pesada y luego pasar cada número de parte al campo Part de la operación de lectura. Es el paso de preparación, no el sustituto de la lectura.
07

List available datasets

marketplaceDataset.listDatasets

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

Casos de uso
un paso de descubrimiento al principio del flujo, ejecutado una vez para ver qué existe antes de construir nada. También sirve de comprobación durante la instalación: si vuelve una lista, el paquete comunitario está puesto y el credential es válido, mucho antes de configurar la primera recogida.
08

List all your snapshot ids

marketplaceDataset.listSnapshots

Lo 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.
Casos de uso
una rutina de limpieza que saca todo lo que quedó en Failed y lo reporta.

Web Scraper

6 operaciones
09

Deliver a snapshot to specified storage

webScrapper.deliverSnapshot

Lo 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.
Casos de uso
dejar un lote rastreado en manos del equipo de datos sin que n8n guarde el archivo.
10

Download the snapshot content

webScrapper.downloadSnapshot

Lo 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.
Casos de uso
recoger el lote terminado en cuanto una comprobación de estado lo da por listo, y llevar los items a una base.
11

Get filtered snapshots

webScrapper.getSnapshots

Lo 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.
Casos de uso
un repaso semanal que cuenta las extracciones completadas.
12

Check the status of a batch extraction

webScrapper.monitorProgressSnapshot

Lo 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.
Casos de uso
colocarlo entre el Schedule Trigger y el paso de descarga, para que el flujo lea los datos solo cuando el lote ha terminado de verdad en lugar de fallar con un resultado vacío.
13

Extract structured data from a single URL

webScrapper.scrapeByUrl

Lo 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.
Casos de uso
enriquecer una ficha de contacto en el segundo en que entra.
14

Initiate batch extraction from URL

webScrapper.triggerCollectionByUrl

Lo 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.
Casos de uso
dejar unos miles de fichas de producto en cola durante la noche.

Web Unlocker

2 operaciones
15

Search the web and get serp results

webUnlocker.WebSearch

Lo 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.
Casos de uso
seguir el posicionamiento de una marca en varios países.
16

Access and extract data from a specific URL

webUnlocker.request

Lo 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.
Casos de uso
leer la página de un competidor en Markdown antes de resumirla.
Necesitas ayuda

¿Necesitas ayuda para automatizar BrightData con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

BrightData y n8n, las dudas que llegan después

01¿La integración BrightData n8n es gratis?
Del lado de n8n, sí. El nodo no cuesta nada, aunque tampoco viene incluido con n8n: es un nodo comunitario, publicado como paquete npm @brightdata/n8n-nodes-brightdata en la versión 1.1.1. Lo instalas tú desde Settings y luego Community nodes, en una instancia autoalojada que corra con Docker o por npm. En n8n Cloud solo se aceptan nodos comunitarios verificados, así que esa vía de instalación no está garantizada allí. Que la plataforma la aloje n8n o la alojes tú no cambia en nada el comportamiento del flujo una vez el nodo está puesto. Lo que cueste Bright Data por su cuenta es otro asunto y no se trata aquí.
02¿Qué credentials hacen falta para conectar BrightData con n8n?
Un único credential de Bright Data, creado una vez. El orden importa: instala antes el paquete comunitario, porque el tipo de credential solo aparece cuando el nodo ya existe en la instancia. Después entras en el menú Credentials, lo creas ahí y todos los flujos de esa instancia pueden reutilizarlo. El nodo lo ofrece en una lista desplegable, así que no hay nada que pegar dos veces. Este nodo no tiene selector de autenticación, es decir, no te pide elegir entre varios métodos como pasa en otros nodos. Los campos exactos los documenta Bright Data, no se describen aquí.
03¿Qué límites tiene el nodo de BrightData en n8n?
Hay tres cosas que conviene prever. La cobertura: 16 operaciones repartidas en 3 recursos, y todo lo que se salga de esa lista pasa por el nodo HTTP Request, capaz de llamar a cualquier endpoint de la API de Bright Data reutilizando el mismo credential mediante la autenticación predefinida. El tiempo: la recogida por lotes es asíncrona, las operaciones devuelven un identificador de snapshot y los registros solo existen cuando el proceso acaba. Y el volumen: las operaciones de listado y de contenido exponen Limit, Skip, Batch Size y Part en lugar de devolverlo todo de una vez, así que una exportación grande se recorre a trozos.
04¿BrightData reacciona en tiempo real dentro de n8n?
No, y no es una casilla que se te haya olvidado marcar. Sencillamente no existe ningún nodo trigger de BrightData en n8n, de modo que un flujo que lo use siempre arranca en otro sitio. Tres opciones prácticas: un Schedule Trigger que salta a intervalo fijo, que encaja con la vigilancia de precios y las exportaciones periódicas; un Webhook de n8n al que llama un servicio externo cuando algo se mueve en tu lado; o el trigger de otra herramienta que ya esté en el flujo. Bright Data también sabe devolver la llamada: las operaciones de entrega y de recogida aceptan una URL Notify, y un Webhook de n8n vale como destino.
05¿n8n o Make para BrightData?
Depende de tres criterios, y ninguna respuesta es equivocada. Primero el alojamiento: n8n se instala en tus propios servidores con Docker o npm, mientras que Make solo está alojado, sin opción de autoalojarlo. De ahí sale el control de los datos, que pesa cuando por la plataforma pasan páginas rastreadas y registros de catálogo. Después el modelo de coste: Make factura por operación, algo que conviene calcular frente a lotes que se abren sobre miles de direcciones. Las dos son herramientas visuales. Y si la vía del nodo comunitario está cerrada en tu caso, el nodo HTTP Request de n8n sigue siendo el recambio.