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 :
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
Identifiants
Obtenir un jeton
- Inscrivez-vous ou connectez-vous sur gologin.com
- Ouvrez API & MCP dans le tableau de bord
- Ouvrez l’onglet API
- Cliquez sur Nouveau jeton
- Copiez le jeton d’accès généré
Fichier de configuration
~/.gologin-agent-browser/config.json
Architecture
Deux composants :- 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 - 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
- Un socket Unix à
${TMPDIR:-/tmp}/gologin-agent-browser.sock - Un serveur HTTP local sur
127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777}
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 :
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
Navigation
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.--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-hostet--proxy-port(ainsi que--proxy-mode http|socks4|socks5,--proxy-user,--proxy-pass) - Dans l’environnement d’exécution cloud,
openn’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-createetprofile-updateacceptent--proxy-country
Voir aussi
- Gologin Web Access CLI — CLI unifiée (scraping + navigateur)
- Exécution locale — exécutez des profils Orbita locaux avec cette CLI
- Cloud Browser : premiers pas — exemples Puppeteer/Playwright
- Compétences IA — compétences prêtes à l’emploi pour Claude Code
Package npm
gologin-agent-browser-cli
Code source
GologinLabs/agent-browser