Intégration Airtop n8nAutomatiser Airtop avec n8n.
Et si un workflow ouvrait un navigateur, lisait une page et cliquait sur un bouton tout seul ? C'est ce que permet l'intégration Airtop n8n. Le nœud expose 24 opérations sur 6 ressources, Agent, Session, Window, Extraction, Interaction et File, pour récupérer des données là où aucune API n'existe.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert l'intégration Airtop n8n ?
Airtop fait tourner un navigateur dans le cloud, et n8n le dirige étape par étape. Tu ouvres une session, tu y ouvres une fenêtre, tu pointes cette fenêtre vers une adresse, puis tu poses des questions sur ce qui s'affiche ou tu agis sur la page comme le ferait une personne. Le contenu de la page devient une donnée n8n classique, réutilisable par le nœud suivant.
Premier scénario : la veille tarifaire. Les URL des concurrents dorment dans Google Sheets, le workflow les parcourt une par une et extraction.query pose la même question à chaque page, en français ou en anglais, peu importe. La réponse revient dans l'exécution et repart dans la colonne d'à côté. Zéro sélecteur CSS à maintenir le jour où le site change de thème.
Deuxième scénario : la collecte d'annuaire. Les listes qui s'étalent sur plusieurs pages, ou qui rajoutent des lignes au fur et à mesure du défilement, c'est le terrain de extraction.getPaginated. Tu décris ce que tu veux, tu choisis un mode de pagination, l'opération avance toute seule. Le résultat part ensuite dans Notion ou dans un récapitulatif posté sur Slack.
Troisième scénario : la corvée derrière un login. Une session créée avec l'option de sauvegarde de profil conserve les cookies et le stockage local sous un nom de profil, donc l'exécution suivante démarre déjà connectée. Ensuite interaction.fill, interaction.click et session.waitForDownload vont chercher le relevé mensuel que le portail fournisseur ne propose qu'en bouton de téléchargement.
Ce que l'API Airtop fait en dehors de ces 24 opérations passe par le nœud HTTP Request, qui appelle n'importe quel endpoint en réutilisant le même credential, c'est-à-dire le même jeu d'identifiants enregistré dans n8n, via l'authentification prédéfinie. Le nœud couvre le chemin courant, HTTP Request couvre le reste.
À savoir avant de construire : cet outil n'a pas de nœud trigger dans n8n. Un workflow démarre donc avec autre chose, le plus souvent un Schedule Trigger à intervalle fixe ou un Webhook n8n, une URL qu'un service tiers appelle. Les sessions consomment des ressources tant qu'elles restent ouvertes, et une session inactive s'arrête au bout de 10 minutes par défaut : prévois où tu la termines. Pour situer la plateforme avant de te lancer, l'Avis n8n fait le tour, et la Formation n8n couvre les expressions et les boucles, dont tu vas beaucoup te servir ici.
Comment connecter Airtop à n8n ?
- 01
Ouvrir un compte Airtop
Le credential repose sur une clé API, il te faut donc un compte sur le portail Airtop avant même de toucher à n8n. Inscris-toi, puis garde le portail ouvert dans un second onglet. Le nœud n8n n'a pas de sélecteur d'authentification : un seul type de credential couvre les 24 opérations, et une fois enregistré, chaque nœud Airtop le propose dans une liste déroulante.
- 02
Générer une clé API
Dans le portail Airtop, ouvre la page API Keys et clique sur le bouton + Create new key. Donne un nom à la clé, de préférence un nom qui te rappellera plus tard quel workflow l'utilise. Clique sur la clé générée pour la copier. C'est la seule valeur dont n8n a besoin, alors copie-la proprement plutôt que de la recopier à la main depuis une capture d'écran.
- 03
Enregistrer le credential dans n8n
Dans n8n, ouvre le menu Credentials, crée un credential Airtop et colle la valeur dans le champ API Key. Un credential se crée une fois et se réutilise partout, sur n8n Cloud comme sur une instance auto-hébergée. Enregistre, puis pose un nœud Airtop dans un workflow et sélectionne le credential dans sa liste.
Que sait faire le nœud Airtop dans n8n ?
Le nœud Airtop expose 24 opérations sur 6 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
| Ressource | 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 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Sommaire des opérations
Agent
1 opérationRun an agent
agent.runCe que tu vois dans n8n
Notes & cas d'usage
Appelle un agent Airtop déjà publié au lieu d'assembler toi-même la suite d'étapes du navigateur. L'agent navigue de son côté, le nœud récupère ce qu'il a produit.
Paramètres clés
- Agent : un sélecteur de ressource qui liste les agents publiés sur ton compte Airtop, donc tu choisis dans une liste au lieu de taper un identifiant.
- Agent Parameters : la table de correspondance des entrées propres à l'agent, dont chaque valeur peut venir de l'item entrant, par exemple
{{ $json.url }}. - Await Agent : activé, le workflow attend la fin de l'exécution ; Timeout fixe cette attente en secondes.
Extraction
3 opérationsQuery page
extraction.queryCe que tu vois dans n8n
Notes & cas d'usage
Pose une question sur le contenu chargé dans la fenêtre et répond à partir de la page, sans le moindre sélecteur.
Paramètres clés
- URL : la page à charger dans la fenêtre avant que la question ne soit posée.
- Prompt : la question elle-même, en langage courant, du genre « cette page contient-elle un formulaire de connexion ».
- Session Mode : Automatically Create Session fabrique session et fenêtre pour cette opération, Use Existing Session réutilise tes Session ID et Window ID.
- JSON Output Schema avec Parse JSON Output : force la réponse dans une forme que le nœud suivant lit champ par champ.
Query page with pagination
extraction.getPaginatedCe que tu vois dans n8n
Notes & cas d'usage
Ramasse le même type de données sur une liste qui continue au-delà du premier écran, qu'elle utilise des liens de page ou qu'elle charge la suite au défilement.
Paramètres clés
- Prompt : ce qu'il faut extraire de chaque page, par exemple tous les noms de produits et leurs prix.
- Pagination Mode : Auto cherche d'abord les liens de pagination puis tente le défilement infini, Paginated s'en tient aux liens, Infinite Scroll ne fait que défiler.
- Interaction Mode : Accurate privilégie la précision, Cost Efficient limite le coût, Auto tranche entre les deux.
- URL, Session ID et Window ID : la liste à ouvrir et l'endroit où l'ouvrir.
Smart scrape page
extraction.scrapeCe que tu vois dans n8n
Notes & cas d'usage
Renvoie le contenu de la fenêtre en markdown. Pas de question, pas de schéma, juste la page dans un format texte qu'un modèle de langage ou un nœud document relit directement.
Paramètres clés
- URL : la page à récupérer, chargée dans la fenêtre avant la capture du contenu.
- Session Mode : session créée à la volée pour une page isolée, ou réutilisation d'un Session ID et d'un Window ID quand tu es déjà en pleine navigation.
- Auto-Terminate Session : désactivé, la session reste vivante et c'est toi qui la termines plus tard.
File
5 opérationsDelete a file
file.deleteFileCe que tu vois dans n8n
Notes & cas d'usage
Supprime d'Airtop un fichier téléversé dès que le workflow n'en a plus l'usage, ce qui garde la liste courte et prévisible pour les exécutions suivantes.
Paramètres clés
- File ID : l'identifiant du fichier à supprimer, en général repris de l'étape d'envoi sous la forme
{{ $json.fileId }}plutôt que saisi à la main.
Get a file
file.getCe que tu vois dans n8n
Notes & cas d'usage
Récupère les détails d'un fichier téléversé, et si tu le demandes le fichier lui-même, pour que le nœud suivant reçoive de vrais octets et pas seulement des métadonnées.
Paramètres clés
- File ID : quel fichier récupérer, le même identifiant que celui renvoyé par l'envoi ou par l'attente de téléchargement.
- Output Binary File : activé, le nœud sort le fichier au format binaire dès qu'il est prêt au téléchargement, ce qu'il faut avant de le mettre en pièce jointe.
Get many files
file.getManyCe que tu vois dans n8n
Notes & cas d'usage
Liste les détails de plusieurs fichiers téléversés d'un coup, la façon la plus directe de faire le point sur ce qu'une série d'exécutions a laissé derrière elle.
Paramètres clés
- Return All : coché, n8n enchaîne les pages jusqu'à lister tous les fichiers ; décoché, Limit plafonne le nombre renvoyé.
- Session IDs : une liste séparée par des virgules pour filtrer ; laissée vide, ce sont les fichiers de toutes les sessions qui reviennent.
- Output Files in Single Item : un item contenant tous les fichiers, ou un item par fichier pour boucler dessus.
Load a file
file.loadCe que tu vois dans n8n
Notes & cas d'usage
Injecte dans une fenêtre active un fichier déjà présent dans Airtop, pour que le champ de sélection de la page le reçoive comme si quelqu'un l'avait choisi dans un dossier.
Paramètres clés
- File ID : le fichier à charger, avec le Session ID de la session visée et le Window ID de la fenêtre où se trouve le champ.
- Element Description : description facultative du champ de fichier à manipuler, par exemple la zone de sélection de fichier.
- Include Hidden Elements : utile quand le vrai champ se cache derrière un bouton stylisé.
Upload a file
file.uploadCe que tu vois dans n8n
Notes & cas d'usage
Fait entrer un fichier dans la session, soit récupéré depuis une adresse, soit repris des données binaires d'un nœud précédent, avec ouverture immédiate du champ de fichier si tu le souhaites.
Paramètres clés
- File Name : le nom que prend le fichier dans la session ; dans une même session, tous les fichiers chargés doivent porter des noms uniques.
- Source : URL va chercher le fichier à l'adresse donnée dans URL, Binary lit la Binary Property qui contient les données.
- File Type : Customer Upload par défaut, à côté de Browser Download, Screenshot et Video.
- Trigger File Input : désactivé, le fichier arrive dans la session sans ouvrir aucune boîte de dialogue.
Interaction
5 opérationsClick an element
interaction.clickCe que tu vois dans n8n
Notes & cas d'usage
Décris un bouton, l'opération le trouve et clique dessus. Ni sélecteur CSS ni XPath, ce qui change tout sur les sites qui renomment leurs classes à chaque mise en production.
Paramètres clés
- Element Description : sois précis, l'exemple du champ parle du bouton vert « save » en haut de page.
- Click Type : Left Click par défaut, avec Double Click et Right Click disponibles.
- Visual Scope : Viewport analyse la vue courante, Page le document entier, Scan traite les sites où le mode Page coince.
- Wait Until Event After Navigation : Fully Loaded par défaut, DOM Only Loaded rend la main plus vite.
Fill form
interaction.fillCe que tu vois dans n8n
Notes & cas d'usage
Remplit plusieurs champs en une fois. Tu décris les valeurs en langage courant et l'opération les répartit sur le formulaire qu'elle voit dans la fenêtre.
Paramètres clés
- Form Data : les informations à saisir, écrites comme une phrase, par exemple un nom puis une adresse e-mail à la suite.
- Session ID et Window ID : la fenêtre qui affiche le formulaire, en général celle qu'un nœud précédent a ouverte.
{{ $json.email }}.Hover on an element
interaction.hoverCe que tu vois dans n8n
Notes & cas d'usage
Amène le pointeur sur un élément que tu décris, ce qui fait apparaître les menus et les infobulles qui n'existent que tant que la souris reste dessus.
Paramètres clés
- Element Description : la cible du survol, l'exemple du champ évoque la photo de profil ronde en haut à droite.
- Visual Scope : Auto convient à la plupart des pages, Viewport limite l'analyse à ce qui est affiché.
- Wait Until Event After Navigation : choisis une condition plus rapide quand le survol ouvre un menu sans rien charger.
Scroll on page
interaction.scrollCe que tu vois dans n8n
Notes & cas d'usage
Fait venir du contenu à l'écran, soit en décrivant où aller, soit en défilant d'une certaine quantité vers un bord de la page.
Paramètres clés
- Scroll Mode : Automatic défile jusqu'à un élément que tu décris, Manual définit la direction et la quantité.
- Element Description : en mode Automatic, la cible en langage courant, par exemple la section intitulée « Contact Us ».
- Scroll To Edge et Scroll By : si les deux sont définis, le déplacement vers le bord passe en premier et la quantité ensuite ; Vertically et Horizontally portent les directions.
- Scrollable Area : défiler à l'intérieur d'un élément, une barre latérale gauche par exemple.
Type text
interaction.typeCe que tu vois dans n8n
Notes & cas d'usage
Tape une chaîne dans la fenêtre et peut appuyer sur Entrée derrière, ce qui règle les barres de recherche et les connexions à un seul champ en un nœud.
Paramètres clés
- Text : ce qu'il faut saisir, souvent construit depuis l'item entrant avec une expression du type
{{ $json.query }}. - Element Description : facultatif ici, et à remplir quand plusieurs champs cohabitent à l'écran, par exemple la barre de recherche en haut de page.
- Press Enter Key : activé, la recherche part sans étape de clic supplémentaire.
Session
4 opérationsCreate a session
session.createCe que tu vois dans n8n
Notes & cas d'usage
Ouvre le navigateur cloud et renvoie un Session ID, la valeur que réclament toutes les autres opérations. Rien n'est obligatoire ici : les valeurs par défaut suffisent.
Paramètres clés
- Profile Name : charge ou crée un profil nommé, pour retrouver un état connecté.
- Idle Timeout : les minutes d'inactivité avant l'arrêt de la session.
- Proxy : None, Integrated pour le proxy fourni par Airtop, ou Proxy URL avec ta propre adresse dans Proxy URL ; Country choisit le pays de sortie.
- Keep Same IP : garde la même adresse, garantie jusqu'à 30 minutes.
- Auto Solve Captchas et Extension IDs : traitement des captchas, et extensions Chrome chargées dans la session.
Save a profile on session termination
session.saveCe que tu vois dans n8n
Notes & cas d'usage
Marque une session en cours pour qu'à son arrêt, l'état de navigation accumulé, cookies et stockage local compris, soit écrit dans un profil nommé.
Paramètres clés
- Profile Name : le nom d'enregistrement ; il ne doit contenir que des caractères alphanumériques et des traits d'union, donc un espace ou un souligné sera refusé.
- Session ID : la session à capturer, reprise de l'étape de création.
Terminate a session
session.terminateCe que tu vois dans n8n
Notes & cas d'usage
Coupe une session volontairement plutôt que d'attendre que l'inactivité s'en charge. Les sessions s'arrêtent d'elles-mêmes selon l'Idle Timeout défini à la création, ou ici quand le workflow le décide.
Paramètres clés
- Session ID : la session à couper, généralement celle que le workflow a ouverte au départ et transportée de nœud en nœud depuis.
Wait for a download
session.waitForDownloadCe que tu vois dans n8n
Notes & cas d'usage
Met le workflow en pause tant qu'un fichier déclenché dans la session n'est pas disponible, puis renvoie son identifiant et son URL de téléchargement, de quoi travailler concrètement au nœud suivant.
Paramètres clés
- Session ID : la session où le téléchargement a été lancé, en général juste après un clic sur un bouton d'export.
- Timeout : le temps d'attente en secondes avant que le fichier soit disponible, à augmenter quand le site fabrique le document à la demande.
Window
6 opérationsClose a window
window.closeCe que tu vois dans n8n
Notes & cas d'usage
Ferme une fenêtre alors que la session continue de tourner, ce qui permet à un traitement multi-onglets de libérer ce dont il n'a plus besoin sans perdre son état connecté.
Paramètres clés
- Window ID : la fenêtre à fermer, et Session ID pour indiquer à quelle session elle appartient.
Create a window
window.createCe que tu vois dans n8n
Notes & cas d'usage
Ajoute une fenêtre de navigateur dans une session existante et peut atterrir directement sur une page, ce qui économise une étape de navigation.
Paramètres clés
- URL : la page d'arrivée ; laissée vide, c'est la page d'accueil de Google qui s'affiche par défaut.
- Get Live View : renvoie l'URL de la vue en direct de la fenêtre, avec Include Navigation Bar pour laisser une personne naviguer entre les pages.
- Screen Resolution : force la taille de la fenêtre, écrite sous la forme
1280x720, et Disable Resize la verrouille. - Wait Until : Load, DOM Content Loaded, Complete pour toutes les iframes, ou No Wait pour rendre la main tout de suite.
Get live view
window.getLiveViewCe que tu vois dans n8n
Notes & cas d'usage
Renvoie les informations d'une fenêtre, dont l'URL de sa vue en direct, l'adresse depuis laquelle une personne regarde et pilote le navigateur en temps réel.
Paramètres clés
- Session ID et Window ID : la fenêtre à exposer.
- Include Navigation Bar : affiche la barre pour que celui qui regarde puisse naviguer lui-même.
- Screen Resolution et Disable Resize : figent la taille de la vue, pratique quand une capture doit correspondre à une mise en page connue.
List windows
window.listCe que tu vois dans n8n
Notes & cas d'usage
Renvoie toutes les fenêtres actuellement ouvertes dans une session, le moyen le plus rapide de savoir ce qu'un traitement long a accumulé.
Paramètres clés
- Session ID : la session à inspecter, et le seul champ que l'opération réclame.
Load a page
window.loadCe que tu vois dans n8n
Notes & cas d'usage
Fait naviguer une fenêtre déjà ouverte vers une autre adresse, ce qui conserve la session, le profil et les cookies pendant que la page change.
Paramètres clés
- URL : l'adresse à ouvrir dans cette fenêtre, souvent issue de l'item précédent sous la forme
{{ $json.url }}. - Wait Until : Fully Loaded par défaut, DOM Only Loaded rend la main dès que la structure est là, Complete attend toutes les iframes, No Wait ne patiente pas.
Take screenshot
window.takeScreenshotCe que tu vois dans n8n
Notes & cas d'usage
Capture ce que la fenêtre affiche à cet instant, ce qui donne au workflow une preuve visuelle là où le texte seul ne suffit pas.
Paramètres clés
- Session ID et Window ID : la fenêtre à capturer.
- Output Binary Image : activé, l'image sort en fichier binaire prêt à être joint ou envoyé ; désactivé, elle sort en chaîne encodée en base64.
Besoin d'aide pour automatiser Airtop avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
