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.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/browserau premier lancement. Si Orbita se trouve ailleurs, définissezGOLOGIN_EXECUTABLE_PATH.
Installation
gologin-agent-browserexécute les sessions de navigateur dans le cloud, sauf si vous choisissez le mode local.gologin-local-agent-browserest 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 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 :targets.json liste les profils :
jobs et job <jobId>. --status accepte running, ok, partial ou failed :
Migrer depuis Local Agent Browser CLI
- Les scripts qui appellent
gologin-local-agent-browsercontinuent de fonctionner. La commande provient désormais degologin-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
- Agent Browser CLI — référence complète des commandes et runtime cloud
- Gologin Web Access CLI — commandes de scraping et de navigateur dans un seul CLI
- AI Skills — compétences pour Claude Code et d’autres agents
- SDK Node.js — exécutez des profils depuis votre propre code
Package npm
gologin-agent-browser-cli
Code source
GologinLabs/agent-browser