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:
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
Zugangsdaten
Token abrufen
- Registrieren Sie sich oder melden Sie sich auf gologin.com an
- Öffnen Sie im Dashboard API & MCP
- Öffnen Sie den Tab API
- Klicken Sie auf New Token
- Kopieren Sie den erzeugten Zugriffstoken
Konfigurationsdatei
~/.gologin-agent-browser/config.json
Architektur
Zwei Teile:gologin-agent-browser-CLI – parst Befehle, wählt die Laufzeitumgebung, startet automatisch den passenden Daemon und gibt kompakte Ausgaben aus- Dauerhafte lokale Daemons, einer pro Laufzeitumgebung – verwalten die aktiven Browsersitzungen, verbinden sich über Playwright
connectOverCDPmit Gologin Cloud Browser oder lokalem Orbita, halten die aktive Seite im Speicher, erstellen Snapshots, lösen Refs auf und erfassen Sitzungsmetadaten
- einem Unix-Socket unter
${TMPDIR:-/tmp}/gologin-agent-browser.sock - lokalem HTTP auf
127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777}
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:
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
Navigation
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.--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-hostund--proxy-port(plus--proxy-mode http|socks4|socks5,--proxy-user,--proxy-pass) - In der Cloud-Laufzeitumgebung akzeptiert
openkein--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-createundprofile-updatedie Option--proxy-country
Verwandte Themen
- Gologin Web Access CLI – einheitliche CLI (Scraping + Browser)
- Lokale Laufzeitumgebung – lokale Orbita-Profile mit dieser CLI ausführen
- Cloud Browser – Erste Schritte – Puppeteer-/Playwright-Beispiele
- AI Skills – Plug-and-play-Skills für Claude Code
npm-Paket
gologin-agent-browser-cli
Quellcode
GologinLabs/agent-browser