Recursos · Integración n8n

Integración Airtop n8nAutomatiza Airtop con n8n.

Un flujo de trabajo que abre un navegador, lee una página y pulsa un botón por su cuenta. Eso es la integración Airtop n8n. El nodo reúne 24 operaciones repartidas en 6 recursos, Agent, Session, Window, Extraction, Interaction y File, para sacar datos de sitios donde no hay ninguna API que te ayude.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Para qué sirve la integración Airtop n8n?

Airtop levanta un navegador en la nube y n8n lo conduce paso a paso. Abres una sesión, dentro de ella abres una ventana, apuntas esa ventana a una dirección y a partir de ahí preguntas por lo que hay en pantalla o actúas sobre la página igual que lo haría una persona. Lo que muestra el sitio se convierte en datos de n8n que el nodo siguiente puede usar sin más.

Caso uno: verificar registros públicos. Una lista de empresas espera en Google Sheets, el flujo recorre cada ficha y extraction.query hace siempre la misma pregunta sobre la página abierta. La respuesta vuelve como dato del flujo y se escribe en la columna de al lado. Cuando el sitio cambia de diseño no hay ningún selector que reparar.

Caso dos: recoger listados largos. Los directorios que siguen más allá de la primera pantalla, con enlaces de página o con carga al desplazarse, son el terreno de extraction.getPaginated. Describes lo que quieres, eliges un modo de paginación y la operación recorre el resto. Después el resultado baja a Microsoft Excel 365 o abre una tarea en Jira Software cuando algo no cuadra.

Caso tres: el trámite que vive detrás de un acceso con contraseña. Una sesión creada con la opción de guardar perfil conserva las cookies y el almacenamiento local bajo un nombre, así que la siguiente ejecución arranca ya dentro. Desde ahí interaction.fill, interaction.click y session.waitForDownload se encargan del certificado que el portal solo entrega pulsando un botón de descarga.

Lo que la API de Airtop hace fuera de estas 24 operaciones se resuelve con el nodo HTTP Request, que llama a cualquier endpoint reutilizando el mismo credential, es decir, las mismas claves guardadas en n8n, mediante la autenticación predefinida. El nodo cubre el camino habitual y HTTP Request cubre el resto.

Conviene saberlo antes de montar nada: esta herramienta no tiene nodo trigger en n8n, o sea que el flujo arranca con otra cosa, casi siempre un Schedule Trigger a intervalo fijo o un Webhook de n8n, una dirección a la que llama un servicio externo. Las sesiones consumen recursos mientras siguen abiertas y una sesión inactiva se cierra a los 10 minutos por defecto, así que decide dónde la terminas. Si quieres situar la plataforma antes, la Reseña n8n la repasa, y el Curso n8n trata las expresiones y los bucles, que aquí vas a usar mucho.

Conexión

¿Cómo conectar Airtop con n8n?

  1. 01

    Abre tu cuenta de Airtop

    El credential se basa en una clave de API, así que necesitas una cuenta en el portal de Airtop antes de tocar n8n. Regístrate y deja el portal abierto en otra pestaña. El nodo de n8n no trae selector de autenticación: un único tipo de credential sirve para las 24 operaciones y, una vez guardado, cualquier nodo Airtop lo ofrece en su lista desplegable.

  2. 02

    Genera una clave de API

    Dentro del portal de Airtop, entra en la página API Keys y pulsa el botón + Create new key. Ponle un nombre que dentro de unos meses te recuerde qué flujo la usa. Pulsa sobre la clave generada para copiarla. Ese es el único valor que n8n necesita, y copiarlo de golpe evita los errores de transcripción que luego cuesta encontrar.

  3. 03

    Guarda el credential en n8n

    En n8n, abre el menú Credentials, crea un credential de Airtop y pega el valor en el campo API Key. Un credential se crea una vez y se reutiliza en todos los flujos, tanto en n8n Cloud como en una instancia que alojes tú. Guárdalo, coloca un nodo Airtop en un flujo y selecciónalo en su lista.

Acciones

¿Qué sabe hacer el nodo Airtop en n8n?

El nodo Airtop expone 24 operaciones en 6 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoCreate SessionGetClick an ElementClose WindowDeleteFill FormGet Live ViewGet ManyQuery Page with PaginationHover on an ElementList WindowsLoadQuery PageRunSave Profile on TerminationSmart ScrapeScrollTake ScreenshotTerminate SessionTypeUploadWait for Download
Agent✓
Extraction✓✓✓
File✓✓✓✓✓
Interaction✓✓✓✓✓
Session✓✓✓✓
Window✓✓✓✓✓✓

Agent

1 operación
01

Run an agent

agent.run

Lo que ves en n8n

Notas y casos de uso

Llama a un agente de Airtop ya publicado en vez de encadenar tú los pasos del navegador. El agente navega solo y el nodo recoge lo que produce.

Parámetros clave

  • Agent: un localizador de recurso que lista los agentes publicados en tu cuenta de Airtop, así que eliges de una lista en vez de escribir un identificador.
  • Agent Parameters: el mapeo de las entradas propias del agente, donde cada valor puede venir del elemento entrante, por ejemplo {{ $json.url }}.
  • Await Agent: activado, el flujo espera a que termine la ejecución; Timeout fija esa espera en segundos.
Casos de uso
una ejecución nocturna que entrega al agente una lista de fichas de empresa y devuelve un registro estructurado por ficha.

Extraction

3 operaciones
02

Query page

extraction.query

Lo que ves en n8n

Notas y casos de uso

Pregunta por lo que está cargado en la ventana y responde a partir del contenido de la página, sin escribir ni un selector.

Parámetros clave

  • URL: la página que se carga en la ventana antes de lanzar la pregunta.
  • Prompt: la pregunta en lenguaje corriente, por ejemplo si la página tiene formulario de acceso.
  • Session Mode: Automatically Create Session monta sesión y ventana solo para esta operación, Use Existing Session reutiliza tu Session ID y tu Window ID.
  • JSON Output Schema junto a Parse JSON Output: obliga a la respuesta a salir con una forma que el nodo siguiente lee campo a campo.
Casos de uso
leer una página de precios y devolver cada plan con su importe.
03

Query page with pagination

extraction.getPaginated

Lo que ves en n8n

Notas y casos de uso

Recoge el mismo tipo de dato en un listado que continúa más allá de la primera pantalla, ya use enlaces de página o cargue filas nuevas al desplazarse.

Parámetros clave

  • Prompt: qué extraer de cada página, por ejemplo todos los nombres de producto con su precio.
  • Pagination Mode: Auto busca primero enlaces de paginación y luego prueba el desplazamiento infinito, Paginated se queda en los enlaces, Infinite Scroll solo desplaza.
  • Interaction Mode: Accurate prioriza la precisión, Cost Efficient contiene el gasto, Auto decide entre ambos.
  • URL, Session ID y Window ID: qué listado abrir y dónde abrirlo.
Casos de uso
un catálogo de la competencia recogido de una vez y comparado con el del día anterior.
04

Smart scrape page

extraction.scrape

Lo que ves en n8n

Notas y casos de uso

Devuelve el contenido de la ventana en markdown. Sin pregunta y sin esquema, la página entera en un formato de texto que un modelo de lenguaje o un nodo documental leen tal cual.

Parámetros clave

  • URL: la página que se carga en la ventana antes de capturar el contenido.
  • Session Mode: sesión creada al vuelo para una página suelta, o reutilización de un Session ID y un Window ID si ya estás navegando.
  • Auto-Terminate Session: desactivado, la sesión sigue viva y la cierras tú más adelante.
Casos de uso
pasar la documentación de un proveedor a archivos markdown guardados en Notion para consultarla después.

File

5 operaciones
05

Delete a file

file.deleteFile

Lo que ves en n8n

Notas y casos de uso

Borra de Airtop un archivo subido en cuanto el flujo deja de necesitarlo, de modo que la lista se mantiene corta y previsible para las siguientes ejecuciones.

Parámetros clave

  • File ID: el identificador del archivo que se borra, normalmente arrastrado desde el paso de subida como {{ $json.fileId }} en lugar de escrito a mano.
Casos de uso
una rama de limpieza al final de un flujo que sube un albarán firmado, lo presenta en el portal del cliente y luego elimina la copia que ya no hace falta.
06

Get a file

file.get

Lo que ves en n8n

Notas y casos de uso

Recupera los detalles de un archivo subido y, si se lo pides, el archivo mismo, para que el nodo siguiente reciba bytes reales y no solo metadatos.

Parámetros clave

  • File ID: qué archivo traer, el mismo identificador que devolvió la subida o la espera de descarga.
  • Output Binary File: activado, el nodo saca el archivo en formato binario cuando está listo para descargar, que es lo que necesitas antes de adjuntarlo.
Casos de uso
recoger la factura que genera el portal de un proveedor y adjuntarla a un correo enviado con Gmail.
07

Get many files

file.getMany

Lo que ves en n8n

Notas y casos de uso

Lista de una sola vez los detalles de varios archivos subidos, la forma más rápida de revisar qué han dejado atrás una serie de ejecuciones.

Parámetros clave

  • Return All: marcado, n8n encadena las páginas hasta listar todos los archivos; sin marcar, Limit fija el máximo devuelto.
  • Session IDs: una lista separada por comas para filtrar; vacío, vuelven los archivos de todas las sesiones.
  • Output Files in Single Item: un elemento con todos los archivos, o un elemento por archivo para recorrerlos en bucle.
Casos de uso
un repaso semanal que cuenta los documentos que trajo cada sesión.
08

Load a file

file.load

Lo que ves en n8n

Notas y casos de uso

Mete en una ventana activa un archivo que ya está en Airtop, para que el campo de selección de la página lo reciba como si alguien lo hubiera elegido de una carpeta.

Parámetros clave

  • File ID: el archivo que se carga, con el Session ID de la sesión de destino y el Window ID de la ventana donde está el campo.
  • Element Description: descripción opcional del campo de archivo con el que interactuar, por ejemplo la zona de selección de archivos.
  • Include Hidden Elements: sirve cuando el campo real se esconde detrás de un botón con estilo propio.
Casos de uso
adjuntar el mismo certificado en varios portales de una tacada.
09

Upload a file

file.upload

Lo que ves en n8n

Notas y casos de uso

Trae un archivo a la sesión, bien descargándolo de una dirección, bien tomándolo de los datos binarios de un nodo anterior, y si quieres abre el campo de archivo en el acto.

Parámetros clave

  • File Name: el nombre que recibe el archivo en la sesión; dentro de una misma sesión, todos los archivos cargados deben llevar nombres únicos.
  • Source: URL lo descarga de la dirección indicada en URL, Binary lee la Binary Property que contiene los datos.
  • File Type: Customer Upload por defecto, junto a Browser Download, Screenshot y Video.
  • Trigger File Input: desactivado, el archivo entra en la sesión sin abrir ningún diálogo.
Casos de uso
llevar un contrato generado a una página de firma electrónica.

Interaction

5 operaciones
10

Click an element

interaction.click

Lo que ves en n8n

Notas y casos de uso

Describe un botón y la operación lo localiza y lo pulsa. Ni selector CSS ni XPath, algo que cambia mucho las cosas en sitios que renombran sus clases en cada despliegue.

Parámetros clave

  • Element Description: cuanto más concreta, mejor; el ejemplo del campo habla del botón verde de guardado en la parte superior.
  • Click Type: Left Click por defecto, con Double Click y Right Click disponibles.
  • Visual Scope: Viewport analiza la vista actual, Page el documento entero, Scan atiende los sitios donde el modo Page se atasca.
  • Wait Until Event After Navigation: Fully Loaded por defecto, DOM Only Loaded devuelve el control antes.
Casos de uso
aceptar el aviso de cookies antes de cualquier extracción.
11

Fill form

interaction.fill

Lo que ves en n8n

Notas y casos de uso

Rellena varios campos de una vez. Tú describes los valores en lenguaje corriente y la operación los reparte por el formulario que ve en la ventana.

Parámetros clave

  • Form Data: la información que hay que escribir, redactada como una frase, por ejemplo un nombre seguido de un correo.
  • Session ID y Window ID: la ventana donde está el formulario, casi siempre la que abrió un nodo anterior.
Casos de uso
un lead, o sea un contacto entrante, que llega por webhook y se traslada al formulario de alta de un partner, con los valores construidos desde el elemento mediante una expresión como {{ $json.email }}.
12

Hover on an element

interaction.hover

Lo que ves en n8n

Notas y casos de uso

Lleva el puntero sobre un elemento que describes, lo que saca a la luz los menús y las etiquetas flotantes que solo existen mientras el ratón se queda encima.

Parámetros clave

  • Element Description: el objetivo del gesto; el ejemplo del campo menciona la foto de perfil redonda arriba a la derecha.
  • Visual Scope: Auto vale para la mayoría de páginas, Viewport limita el análisis a lo que se ve.
  • Wait Until Event After Navigation: elige una condición más rápida cuando el gesto abre un menú y no carga nada.
Casos de uso
desplegar un menú de navegación para llegar a una subpágina sin enlace directo.
13

Scroll on page

interaction.scroll

Lo que ves en n8n

Notas y casos de uso

Trae contenido a la vista, ya sea describiendo adónde ir, ya sea desplazando una cantidad concreta hacia un borde de la página.

Parámetros clave

  • Scroll Mode: Automatic se desplaza hasta un elemento que describes, Manual define dirección y cantidad.
  • Element Description: en modo Automatic, el destino en lenguaje corriente, por ejemplo la sección titulada Contact Us.
  • Scroll To Edge y Scroll By: si defines los dos, primero se ejecuta el movimiento al borde y después la cantidad; Vertically y Horizontally guardan las direcciones.
  • Scrollable Area: desplazarse dentro de un elemento, una barra lateral izquierda por ejemplo.
Casos de uso
llegar a unas opiniones que cargan tarde antes de consultarlas.
14

Type text

interaction.type

Lo que ves en n8n

Notas y casos de uso

Escribe una cadena en la ventana y puede pulsar Intro después, con lo que una barra de búsqueda o un acceso de un solo campo se resuelven en un nodo.

Parámetros clave

  • Text: lo que se escribe, muchas veces construido desde el elemento entrante con una expresión como {{ $json.query }}.
  • Element Description: aquí es opcional, y conviene rellenarlo cuando hay varios campos en pantalla, por ejemplo la caja de búsqueda de la cabecera.
  • Press Enter Key: activado, la búsqueda se lanza sin un paso de clic aparte.
Casos de uso
buscar en un directorio cada razón social guardada en una hoja de cálculo, fila a fila.

Session

4 operaciones
15

Create a session

session.create

Lo que ves en n8n

Notas y casos de uso

Levanta el navegador en la nube y devuelve un Session ID, el valor que reclaman las demás operaciones. Nada es obligatorio aquí: los valores por defecto bastan.

Parámetros clave

  • Profile Name: carga o crea un perfil con nombre para recuperar la sesión iniciada.
  • Idle Timeout: los minutos de inactividad antes de cerrar la sesión.
  • Proxy: None, Integrated para el proxy de Airtop, o Proxy URL con tu dirección en Proxy URL; Country elige el país de salida.
  • Keep Same IP: mantiene la misma dirección, garantizada hasta 30 minutos.
  • Auto Solve Captchas y Extension IDs: captchas y extensiones de Chrome en la sesión.
Casos de uso
una sesión por país para ver una página mercado a mercado.
16

Save a profile on session termination

session.save

Lo que ves en n8n

Notas y casos de uso

Marca una sesión en curso para que, al cerrarse, el estado de navegación acumulado, cookies y almacenamiento local incluidos, quede escrito en un perfil con nombre.

Parámetros clave

  • Profile Name: el nombre con el que se guarda; solo admite caracteres alfanuméricos y guiones, de modo que un espacio o un guion bajo se rechazan.
  • Session ID: qué sesión en marcha se captura, tomada del paso de creación.
Casos de uso
entrar una vez a mano en un portal desde una vista en directo, guardar el perfil y dejar que cada ejecución programada empiece ya identificada en lugar de repetir el formulario de acceso.
17

Terminate a session

session.terminate

Lo que ves en n8n

Notas y casos de uso

Cierra una sesión a propósito en vez de esperar a que lo haga la inactividad. Las sesiones se cierran solas según el Idle Timeout fijado al crearlas, o aquí mismo cuando lo decide el flujo.

Parámetros clave

  • Session ID: la sesión que se cierra, casi siempre la que el flujo abrió al principio y ha ido pasando de nodo en nodo.
Casos de uso
el último nodo de una rama, colocado para ejecutarse también cuando un paso anterior falla, de forma que un trabajo largo de recogida nunca deje un navegador abierto detrás.
18

Wait for a download

session.waitForDownload

Lo que ves en n8n

Notas y casos de uso

Detiene el flujo hasta que un archivo lanzado dentro de la sesión está disponible, y devuelve su identificador y su dirección de descarga, con lo que el nodo siguiente ya tiene algo real entre manos.

Parámetros clave

  • Session ID: la sesión donde arrancó la descarga, normalmente justo después de pulsar un botón de exportación.
  • Timeout: el tiempo de espera en segundos hasta que la descarga esté disponible, que conviene subir cuando el sitio fabrica el documento en ese momento.
Casos de uso
el extracto mensual que exporta un portal bancario, recogido sin que nadie vigile la pantalla.

Window

6 operaciones
19

Close a window

window.close

Lo que ves en n8n

Notas y casos de uso

Cierra una ventana mientras la sesión sigue en pie, que es como un trabajo con varias pestañas libera lo que ya no usa sin perder el estado identificado.

Parámetros clave

  • Window ID: la ventana que se cierra, y Session ID para indicar a qué sesión pertenece.
Casos de uso
un comparador que abre una ventana por página de proveedor, saca un precio de cada una y las va cerrando conforme avanza el bucle, dejando solo la sesión para el paso de resumen final.
20

Create a window

window.create

Lo que ves en n8n

Notas y casos de uso

Añade una ventana de navegador dentro de una sesión existente y puede aterrizar directamente en una página, lo que ahorra un paso de navegación.

Parámetros clave

  • URL: la página inicial; si lo dejas vacío, se abre la portada de Google por defecto.
  • Get Live View: devuelve la dirección de la vista en directo de la ventana, y Include Navigation Bar deja que una persona se mueva entre páginas.
  • Screen Resolution: fuerza el tamaño de la ventana, escrito como 1280x720, y Disable Resize lo bloquea.
  • Wait Until: Load, DOM Content Loaded, Complete para todos los iframes, o No Wait para devolver el control enseguida.
Casos de uso
abrir una ventana con medidas de móvil para revisar un diseño adaptable.
21

Get live view

window.getLiveView

Lo que ves en n8n

Notas y casos de uso

Devuelve la información de una ventana, incluida la dirección de su vista en directo, desde la que una persona mira y controla el navegador en tiempo real.

Parámetros clave

  • Session ID y Window ID: qué ventana se expone.
  • Include Navigation Bar: muestra la barra para que quien mira pueda navegar por su cuenta.
  • Screen Resolution y Disable Resize: fijan el tamaño de la vista, útil cuando una captura debe coincidir con una maqueta conocida.
Casos de uso
enviar el enlace de la vista en directo a Slack cuando la ejecución llega a un paso que alguien tiene que desbloquear.
22

List windows

window.list

Lo que ves en n8n

Notas y casos de uso

Devuelve todas las ventanas abiertas en ese momento dentro de una sesión, la vía más corta para saber qué ha ido acumulando un proceso largo.

Parámetros clave

  • Session ID: la sesión que se inspecciona, y el único campo que pide la operación.
Casos de uso
una rama de mantenimiento que lista las ventanas de una sesión, recorre el resultado y cierra cada una antes del paso de informe, para que un proceso que abre una ventana por página no se descontrole.
23

Load a page

window.load

Lo que ves en n8n

Notas y casos de uso

Manda una ventana ya abierta a otra dirección, con lo que la sesión, el perfil y las cookies se mantienen mientras cambia la página.

Parámetros clave

  • URL: la dirección que se abre en esa ventana, a menudo tomada del elemento anterior como {{ $json.url }}.
  • Wait Until: Fully Loaded por defecto, DOM Only Loaded devuelve el control en cuanto está la estructura, Complete espera a todos los iframes, No Wait no espera.
Casos de uso
recorrer una lista de direcciones en una sola ventana ya identificada en vez de pagar el coste del acceso en cada una.
24

Take screenshot

window.takeScreenshot

Lo que ves en n8n

Notas y casos de uso

Captura lo que la ventana muestra en ese instante, y le da al flujo una prueba visual donde el texto por sí solo no basta.

Parámetros clave

  • Session ID y Window ID: la ventana que se captura.
  • Output Binary Image: activado, la imagen sale como archivo binario listo para adjuntar o subir; desactivado, sale como cadena codificada en base64.
Casos de uso
archivar la pantalla de confirmación de un pedido hecho por el flujo, junto a la referencia guardada en ClickUp.
Necesitas ayuda

¿Necesitas ayuda para automatizar Airtop con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Airtop y n8n: preguntas frecuentes

01¿La integración Airtop n8n es gratuita?
Sí por el lado de n8n. El nodo de Airtop viene incluido con n8n, así que no hay nada que instalar ni ningún coste añadido para n8n, tanto en n8n Cloud como en una instancia que alojes tú en Community Edition, con licencia Sustainable Use. El flujo se comporta igual en los dos casos. Lo que cuesta una cuenta de Airtop es otra cuestión y esta página no la trata, así que confírmalo con Airtop antes de programar ejecuciones que mantengan sesiones abiertas todo el día. Las 24 operaciones están disponibles sea cual sea tu alojamiento de n8n.
02¿Qué credenciales hacen falta para conectar Airtop con n8n?
Una clave de API, y es el único método de autenticación que admite este nodo. Crea una cuenta de Airtop, entra en el portal de Airtop, abre la página API Keys, pulsa el botón de crear una clave nueva, ponle nombre y pulsa sobre la clave generada para copiarla. Pega ese valor en el campo API Key de un credential de Airtop dentro de n8n. El nodo no tiene selector de autenticación, de modo que un único credential cubre las 24 operaciones de los 6 recursos. El credential se crea una vez en el menú Credentials y se reutiliza en todos los flujos.
03¿Qué límites tiene el nodo Airtop en n8n?
Dos cosas marcan lo que puedes montar. Primero el catálogo: el nodo expone 24 operaciones en 6 recursos, y lo que la API de Airtop ofrece más allá pasa por el nodo HTTP Request, que llama a cualquier endpoint reutilizando el mismo credential con la autenticación predefinida. Segundo, las sesiones guardan estado. Casi todas las operaciones piden un Session ID y un Window ID que vienen de nodos anteriores, un campo obligatorio vacío detiene la ejecución, y una sesión inactiva se cierra a los 10 minutos por defecto. En el listado de archivos, todo vuelve solo con Return All activado; si no, manda Limit.
04¿Airtop tiene trigger en n8n?
No. Airtop no tiene nodo trigger, así que ningún flujo arranca con un evento de Airtop. El arranque viene de otro sitio. Un Schedule Trigger lanza el flujo a intervalo fijo, que encaja con una recogida nocturna o con una descarga semanal en un portal. Un Webhook de n8n te da una dirección a la que llama un servicio externo, útil para abrir una sesión de navegador cuando alguien lo pide. También sirve el trigger de otra herramienta, por ejemplo una fila nueva en una hoja de cálculo o un mensaje en un chat de equipo. Los nodos de Airtop se ejecutan luego como acciones.
05¿n8n o Make para Airtop?
Depende de tres criterios. Alojamiento: n8n se instala por tu cuenta con Docker o npm, o corre en n8n Cloud, mientras que Make solo existe alojado. De ahí sale el control de los datos, y automatizar un navegador toca contenido de páginas y sesiones identificadas, algo que suele pesar en la decisión. Modelo de coste: Make factura por operación, y un recorrido de navegador encadena muchos pasos, uno para la sesión, uno por ventana, uno por interacción. Lógica visual: las dos se montan sobre un lienzo y la comodidad depende de cómo trabaje ya tu equipo. Ninguna de las dos sobra.