Passer au contenu principal
Gologin Agent Browser CLI transforme les profils de navigateur Gologin en un environnement d’exécution persistant et scriptable pour les agents IA. Les sessions s’exécutent dans Gologin Cloud Browser ou dans Orbita sur votre propre machine. Il fournit des instantanés de page compacts, des interactions basées sur des références, une mémoire de session et une sortie adaptée au shell. Contrairement à l’écriture de code Puppeteer/Playwright à partir de zéro, cette CLI offre aux agents un ensemble de commandes prêt à l’emploi pour l’automatisation du navigateur : pas de code répétitif, pas de code de gestion de session.

Exécution dans le cloud ou en local

La CLI propose deux environnements d’exécution avec les mêmes commandes. Les deux utilisent les profils, les empreintes et les proxys Gologin, et un démon maintient les sessions actives entre les appels à la CLI. Choisissez l’environnement d’exécution pour chaque commande avec --runtime cloud|local|auto, ou définissez une fois GOLOGIN_AGENT_BROWSER_RUNTIME :
Par défaut (auto), les commandes de profil, de runbook et de tâche s’exécutent en local, et toutes les autres s’exécutent dans le cloud. Une fois qu’une session locale est ouverte, passez aussi --runtime local aux commandes suivantes. Consultez Exécution locale pour connaître les prérequis et les commandes réservées au mode local.

Installation

Ou exécutez-la sans installation globale :
Nécessite Node.js >= 18. L’exécution locale nécessite Node.js 20 ou une version ultérieure.

Identifiants

Obtenir un jeton

  1. Inscrivez-vous ou connectez-vous sur gologin.com
  2. Ouvrez API & MCP dans le tableau de bord
  3. Ouvrez l’onglet API
  4. Cliquez sur Nouveau jeton
  5. Copiez le jeton d’accès généré

Fichier de configuration

~/.gologin-agent-browser/config.json

Architecture

Deux composants :
  1. La CLI gologin-agent-browser : analyse les commandes, choisit l’environnement d’exécution, démarre automatiquement le démon correspondant et affiche une sortie compacte
  2. Des démons locaux persistants, un par environnement d’exécution : ils gèrent les sessions de navigateur actives, se connectent à Gologin Cloud Browser ou à Orbita en local via Playwright connectOverCDP, conservent la page active en mémoire, construisent les instantanés, résolvent les références et suivent les métadonnées de session
Le transport est uniquement local. Le démon cloud écoute sur :
  • Un socket Unix à ${TMPDIR:-/tmp}/gologin-agent-browser.sock
  • Un serveur HTTP local sur 127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777}
Dans l’environnement d’exécution cloud, si vous ne fournissez pas d’ID de profil, le démon crée un profil cloud Gologin temporaire via l’API.

Fonctionnement des références

snapshot affiche une vue compacte de la page et attribue des références telles que @e1, @e2, @e3 aux éléments interactifs. Vous agissez directement dessus :
Les références sont fournies au mieux et doivent être régénérées après une navigation ou une modification importante du DOM. Les commandes acceptent aussi des sélecteurs CSS à la place des références. Sur les pages dynamiques, find est généralement une meilleure solution de repli que des références obsolètes : il localise l’élément sur la page active et agit dessus en une seule étape.

Démarrage rapide


Exemple de boucle d’agent

Une boucle typique d’agent IA :

Référence complète des commandes

Diagnostic

Gestion des sessions

Lecture de la page

Interaction

Clavier et défilement

Onglets

Cookies et stockage

Avancé

Profils, proxys et API Gologin

Ces commandes appellent l’API Gologin avec votre jeton et n’ont pas besoin du démon du navigateur.
Ajoutez --help à n’importe quelle commande pour afficher son mode d’emploi.

Exécution locale uniquement

profiles, profile, profile-create, profile-update, profile-import, profile-sync, profile-delete, run, batch, jobs et job gèrent les profils locaux, les runbooks et l’historique des tâches. Consultez Exécution locale.

Alias


Cas d’usage et exemples

Vérifier si votre site réussit les tests anti-détection

Se connecter à une application web et extraire les données du tableau de bord

Remplir un formulaire en plusieurs étapes

Faire des captures d’écran des pages de concurrents

Effectuer une recherche sur un site qui bloque le scraping

Certains sites exigent l’exécution de JavaScript, une connexion ou une interaction avant d’afficher les résultats. Utilisez le navigateur pour effectuer la recherche :

Enregistrer et restaurer l’état d’une session

Exportez les cookies et le stockage pour les réutiliser d’une session à l’autre :

Sessions parallèles

Utilisez des ID --session explicites pour des tâches cloud indépendantes. Nettoyez avec close --all ou sessions --prune --older-than-ms.

Règles relatives aux proxys

  • Profils préconfigurés : le proxy est défini sur le profil via le tableau de bord ou l’API Gologin, par exemple proxy add-gologin <profileId> --country us
  • Profils cloud temporaires : aucun proxy, ou votre propre proxy avec --proxy-host et --proxy-port (ainsi que --proxy-mode http|socks4|socks5, --proxy-user, --proxy-pass)
  • Dans l’environnement d’exécution cloud, open n’accepte pas --proxy-country. Pour utiliser le trafic d’un proxy Gologin depuis un pays donné, ajoutez un proxy Gologin à un profil et ouvrez-le avec --profile
  • Dans l’environnement d’exécution local, open, profile-create et profile-update acceptent --proxy-country

Voir aussi

Package npm

gologin-agent-browser-cli

Code source

GologinLabs/agent-browser