Passer au contenu principal
Local Agent Browser CLI fait désormais partie d’Agent Browser CLI. Le package npm gologin-local-agent-browser-cli est obsolète : installez gologin-agent-browser-cli et utilisez --runtime local. Les scripts qui appellent gologin-local-agent-browser continuent de fonctionner, voir Migrer depuis Local Agent Browser CLI.
Agent Browser CLI propose deux runtimes avec les mêmes commandes. Le runtime cloud exécute les sessions dans Gologin Cloud Browser. Le runtime local les exécute dans Orbita, le navigateur de Gologin, sur votre propre machine. Cette page présente le runtime local. Les snapshots, les refs et les autres commandes fonctionnent comme décrit sur la page Agent Browser CLI.

Quand utiliser local ou cloud


Prérequis

  • Node.js 20 ou version ultérieure. Le runtime local lance Orbita via le SDK Node.js de Gologin, qui nécessite Node.js 20.
  • Un jeton d’API Gologin dans GOLOGIN_TOKEN. Voir Obtenir un jeton.
  • Un ID de profil pour chaque session. Contrairement au runtime cloud, le runtime local ne crée pas de profils temporaires.
  • Orbita. S’il n’est pas encore installé, le SDK Gologin le télécharge dans ~/.gologin/browser au premier lancement. Si Orbita se trouve ailleurs, définissez GOLOGIN_EXECUTABLE_PATH.

Installation

Le package installe deux commandes :
  • gologin-agent-browser exécute les sessions de navigateur dans le cloud, sauf si vous choisissez le mode local.
  • gologin-local-agent-browser est un alias de compatibilité qui exécute les commandes dans le runtime local.

Choisir le runtime local

Ajoutez --runtime local à une commande, ou définissez le runtime une seule fois pour tout le shell :
--local et un local placé en premier fonctionnent aussi : gologin-agent-browser local open https://example.com --profile your_profile_id.
Les commandes de session comme snapshot, click et close sont envoyées au runtime cloud, sauf si vous choisissez le mode local. Après avoir ouvert une session locale, ajoutez --runtime local à chaque commande suivante, ou définissez GOLOGIN_AGENT_BROWSER_RUNTIME=local.
Les commandes de l’API Gologin comme api, browser et proxy appellent toujours directement l’API, quel que soit le runtime.

Variables d’environnement

Le runtime local conserve sa configuration, sa liste de profils et son historique de tâches dans ~/.gologin-local-agent-browser/, le même dossier que celui de l’ancien CLI.

Démarrage rapide

--visible (ou --headed) et --headless (ou --background) définissent le mode d’affichage de la fenêtre pour un seul open. open-visible et open-background en sont les raccourcis.

Commandes de navigateur

Les commandes de session sont les mêmes que dans le runtime cloud : snapshot, click, type, fill, find, wait, press, scroll, tabs, cookies, storage-export, eval, screenshot, pdf, upload et d’autres. Consultez la référence des commandes. Pour l’instant, back, forward et reload ne fonctionnent que dans le runtime cloud. find repère un élément sur la page active et agit dessus en une seule étape. Utilisez-le lorsque les refs deviennent obsolètes sur les pages dynamiques :

Commandes de profil

Ces commandes s’exécutent dans le runtime local, même sans --runtime local : profile-create et profile-update acceptent un modèle adapté à un cas d’usage et un proxy. --proxy-country us ajoute un proxy Gologin, --proxy-host avec --proxy-port définit votre propre proxy.

Runbooks et tâches par lots

Un runbook est un fichier JSON contenant une liste d’étapes CLI :
Exécutez-le sur un seul profil, ou sur plusieurs profils en parallèle :
targets.json liste les profils :
Consultez les résultats avec jobs et job <jobId>. --status accepte running, ok, partial ou failed :

Migrer depuis Local Agent Browser CLI

  • Les scripts qui appellent gologin-local-agent-browser continuent de fonctionner. La commande provient désormais de gologin-agent-browser-cli.
  • Les profils, la configuration et l’historique des tâches dans ~/.gologin-local-agent-browser/ restent à leur place.
  • Pour les agents IA, installez la compétence Agent Browser. Elle couvre les deux runtimes, et la compétence Local Agent Browser distincte est obsolète.

Voir aussi

Package npm

gologin-agent-browser-cli

Code source

GologinLabs/agent-browser