Zum Hauptinhalt springen
Die Gologin Agent Browser CLI macht aus Gologin-Browserprofilen eine dauerhafte, skriptbare Laufzeitumgebung für KI-Agenten. Sitzungen laufen in Gologin Cloud Browser oder in Orbita auf Ihrem eigenen Rechner. Die CLI bietet kompakte Seiten-Snapshots, ref-basierte Interaktion, Sitzungsspeicher und shell-freundliche Ausgaben. Anders als bei Puppeteer-/Playwright-Code, den Sie selbst von Grund auf schreiben müssen, erhalten Agenten mit dieser CLI eine fertige Befehlsschnittstelle für die Browser-Automatisierung – ohne Boilerplate und ohne Code für die Sitzungsverwaltung.

Cloud- oder lokale Laufzeitumgebung

Die CLI bietet zwei Laufzeitumgebungen mit denselben Befehlen. Beide nutzen Gologin-Profile, Fingerprints und Proxys, und ein Daemon hält Sitzungen über mehrere CLI-Aufrufe hinweg am Leben. Wählen Sie die Laufzeitumgebung pro Befehl mit --runtime cloud|local|auto oder legen Sie einmalig GOLOGIN_AGENT_BROWSER_RUNTIME fest:
Standardmäßig (auto) werden Profil-, Runbook- und Job-Befehle lokal ausgeführt, alles andere in der Cloud. Sobald Sie eine lokale Sitzung geöffnet haben, übergeben Sie --runtime local auch an die nachfolgenden Befehle. Anforderungen und Befehle, die nur lokal verfügbar sind, finden Sie unter Lokale Laufzeitumgebung.

Installation

Oder ohne globale Installation ausführen:
Erfordert Node.js >= 18. Die lokale Laufzeitumgebung benötigt Node.js 20 oder höher.

Zugangsdaten

Token abrufen

  1. Registrieren Sie sich oder melden Sie sich auf gologin.com an
  2. Öffnen Sie im Dashboard API & MCP
  3. Öffnen Sie den Tab API
  4. Klicken Sie auf New Token
  5. Kopieren Sie den erzeugten Zugriffstoken

Konfigurationsdatei

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

Architektur

Zwei Teile:
  1. gologin-agent-browser-CLI – parst Befehle, wählt die Laufzeitumgebung, startet automatisch den passenden Daemon und gibt kompakte Ausgaben aus
  2. Dauerhafte lokale Daemons, einer pro Laufzeitumgebung – verwalten die aktiven Browsersitzungen, verbinden sich über Playwright connectOverCDP mit Gologin Cloud Browser oder lokalem Orbita, halten die aktive Seite im Speicher, erstellen Snapshots, lösen Refs auf und erfassen Sitzungsmetadaten
Der Transport erfolgt ausschließlich lokal. Der Cloud-Daemon lauscht auf:
  • einem Unix-Socket unter ${TMPDIR:-/tmp}/gologin-agent-browser.sock
  • lokalem HTTP auf 127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777}
Wenn Sie in der Cloud-Laufzeitumgebung keine Profil-ID angeben, erstellt der Daemon über die API ein temporäres Gologin-Cloud-Profil.

So funktionieren Refs

snapshot gibt eine kompakte Seitenansicht aus und weist interaktiven Elementen Refs wie @e1, @e2, @e3 zu. Mit diesen Refs steuern Sie die Elemente direkt:
Refs funktionieren nach bestem Bemühen und sollten nach einer Navigation oder größeren DOM-Änderungen neu erzeugt werden. Statt Refs akzeptieren die Befehle auch CSS-Selektoren. Auf dynamischen Seiten ist find meist die bessere Alternative zu veralteten Refs: Es sucht das Element auf der Live-Seite und führt die Aktion in einem Schritt aus.

Schnellstart


Beispiel für eine Agenten-Schleife

Eine typische Schleife eines KI-Agenten:

Vollständige Befehlsreferenz

Diagnose

Sitzungsverwaltung

Seiteninhalte lesen

Interaktion

Tastatur und Scrollen

Tabs

Cookies und Speicher

Erweitert

Profile, Proxys und die Gologin-API

Diese Befehle rufen die Gologin-API mit Ihrem Token auf und benötigen den Browser-Daemon nicht.
Mit --help können Sie bei jedem Befehl die Verwendung anzeigen lassen.

Nur in der lokalen Laufzeitumgebung

profiles, profile, profile-create, profile-update, profile-import, profile-sync, profile-delete, run, batch, jobs und job verwalten lokale Profile, Runbooks und den Job-Verlauf. Siehe Lokale Laufzeitumgebung.

Aliasse


Anwendungsfälle und Beispiele

Prüfen, ob Ihre Website Anti-Detect-Tests besteht

In einer Web-App anmelden und Dashboard-Daten auslesen

Ein mehrstufiges Formular ausfüllen

Screenshots von Seiten der Konkurrenz erstellen

Auf einer Website suchen, die Scraping blockiert

Manche Websites verlangen JavaScript-Ausführung, eine Anmeldung oder Interaktion, bevor sie Ergebnisse anzeigen. Nutzen Sie in diesem Fall den Browser für die Suche:

Sitzungsstatus speichern und wiederherstellen

Exportieren Sie Cookies und Storage, um sie sitzungsübergreifend wiederzuverwenden:

Parallele Sitzungen

Verwenden Sie für unabhängige Cloud-Aufgaben explizite --session-IDs. Räumen Sie mit close --all oder sessions --prune --older-than-ms auf.

Proxy-Regeln

  • Vorkonfigurierte Profile: Der Proxy wird über das Gologin-Dashboard oder die API am Profil festgelegt, zum Beispiel mit proxy add-gologin <profileId> --country us
  • Temporäre Cloud-Profile: kein Proxy oder Ihr eigener Proxy mit --proxy-host und --proxy-port (plus --proxy-mode http|socks4|socks5, --proxy-user, --proxy-pass)
  • In der Cloud-Laufzeitumgebung akzeptiert open kein --proxy-country. Für Gologin-Proxy-Traffic aus einem bestimmten Land fügen Sie einem Profil einen Gologin-Proxy hinzu und öffnen es mit --profile
  • In der lokalen Laufzeitumgebung akzeptieren open, profile-create und profile-update die Option --proxy-country

Verwandte Themen

npm-Paket

gologin-agent-browser-cli

Quellcode

GologinLabs/agent-browser