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
¿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.
¿Cómo conectar Airtop con n8n?
- 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.
- 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.
- 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.
¿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.
| Recurso | Create Session | Get | Click an Element | Close Window | Delete | Fill Form | Get Live View | Get Many | Query Page with Pagination | Hover on an Element | List Windows | Load | Query Page | Run | Save Profile on Termination | Smart Scrape | Scroll | Take Screenshot | Terminate Session | Type | Upload | Wait for Download |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Agent | ✓ | |||||||||||||||||||||
| Extraction | ✓ | ✓ | ✓ | |||||||||||||||||||
| File | ✓ | ✓ | ✓ | ✓ | ✓ | |||||||||||||||||
| Interaction | ✓ | ✓ | ✓ | ✓ | ✓ | |||||||||||||||||
| Session | ✓ | ✓ | ✓ | ✓ | ||||||||||||||||||
| Window | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Índice de operaciones
Agent
1 operaciónRun an agent
agent.runLo 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.
Extraction
3 operacionesQuery page
extraction.queryLo 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.
Query page with pagination
extraction.getPaginatedLo 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.
Smart scrape page
extraction.scrapeLo 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.
File
5 operacionesDelete a file
file.deleteFileLo 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.
Get a file
file.getLo 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.
Get many files
file.getManyLo 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.
Load a file
file.loadLo 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.
Upload a file
file.uploadLo 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.
Interaction
5 operacionesClick an element
interaction.clickLo 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.
Fill form
interaction.fillLo 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.
{{ $json.email }}.Hover on an element
interaction.hoverLo 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.
Scroll on page
interaction.scrollLo 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.
Type text
interaction.typeLo 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.
Session
4 operacionesCreate a session
session.createLo 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.
Save a profile on session termination
session.saveLo 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.
Terminate a session
session.terminateLo 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.
Wait for a download
session.waitForDownloadLo 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.
Window
6 operacionesClose a window
window.closeLo 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.
Create a window
window.createLo 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.
Get live view
window.getLiveViewLo 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.
List windows
window.listLo 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.
Load a page
window.loadLo 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.
Take screenshot
window.takeScreenshotLo 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.
¿Necesitas ayuda para automatizar Airtop con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.
