Zum Hauptinhalt springen
Die Local Agent Browser CLI ist jetzt Teil der Agent Browser CLI. Das npm-Paket gologin-local-agent-browser-cli ist veraltet: Installieren Sie gologin-agent-browser-cli und verwenden Sie --runtime local. Skripte, die gologin-local-agent-browser aufrufen, funktionieren weiterhin, siehe Von der Local Agent Browser CLI migrieren.
Die Agent Browser CLI hat zwei Runtimes mit denselben Befehlen. Die Runtime cloud führt Sessions in Gologin Cloud Browser aus. Die Runtime local führt sie in Orbita, dem Gologin-Browser, auf Ihrem eigenen Rechner aus. Diese Seite behandelt die lokale Runtime. Snapshots, Refs und die übrigen Befehle funktionieren wie auf der Seite Agent Browser CLI beschrieben.

Wann lokal, wann Cloud?


Voraussetzungen

  • Node.js 20 oder höher. Die lokale Runtime startet Orbita über das Gologin Node.js SDK, das Node.js 20 benötigt.
  • Ein Gologin-API-Token in GOLOGIN_TOKEN. Siehe Token abrufen.
  • Eine Profil-ID für jede Session. Anders als die Cloud-Runtime erstellt die lokale Runtime keine temporären Profile.
  • Orbita. Ist es noch nicht installiert, lädt das Gologin SDK es beim ersten Start nach ~/.gologin/browser herunter. Befindet sich Orbita an einem anderen Ort, setzen Sie GOLOGIN_EXECUTABLE_PATH.

Installation

Das Paket installiert zwei Befehle:
  • gologin-agent-browser führt Browser-Sessions in der Cloud aus, sofern Sie nicht die lokale Runtime wählen.
  • gologin-local-agent-browser ist ein Kompatibilitäts-Alias, der Befehle in der lokalen Runtime ausführt.

Lokale Runtime wählen

Übergeben Sie --runtime local an einen Befehl oder legen Sie die Runtime einmal für die gesamte Shell fest:
--local und ein vorangestelltes local funktionieren ebenfalls: gologin-agent-browser local open https://example.com --profile your_profile_id.
Session-Befehle wie snapshot, click und close gehen an die Cloud-Runtime, sofern Sie nicht die lokale Runtime wählen. Nachdem Sie eine lokale Session geöffnet haben, übergeben Sie --runtime local an jeden folgenden Befehl oder setzen Sie GOLOGIN_AGENT_BROWSER_RUNTIME=local.
Gologin-API-Befehle wie api, browser und proxy rufen unabhängig von der Runtime immer direkt die API auf.

Umgebungsvariablen

Die lokale Runtime speichert ihre Konfiguration, die Profilliste und den Job-Verlauf in ~/.gologin-local-agent-browser/, demselben Ordner, den auch die alte CLI verwendet hat.

Schnellstart

--visible (oder --headed) und --headless (oder --background) legen den Fenstermodus für ein einzelnes open fest. open-visible und open-background sind Kurzformen dafür.

Browserbefehle

Die Session-Befehle sind dieselben wie in der Cloud-Runtime: snapshot, click, type, fill, find, wait, press, scroll, tabs, cookies, storage-export, eval, screenshot, pdf, upload und weitere. Siehe die Befehlsreferenz. back, forward und reload funktionieren derzeit nur in der Cloud-Runtime. find sucht ein Element auf der aktuellen Seite und führt in einem Schritt eine Aktion darauf aus. Nutzen Sie es, wenn Refs auf dynamischen Seiten veralten:

Profilbefehle

Diese Befehle laufen auch ohne --runtime local in der lokalen Runtime: profile-create und profile-update akzeptieren eine Vorlage für einen Anwendungsfall und einen Proxy. --proxy-country us fügt einen Gologin-Proxy hinzu, --proxy-host zusammen mit --proxy-port legt Ihren eigenen fest.

Runbooks und Batch-Jobs

Ein Runbook ist eine JSON-Datei mit einer Liste von CLI-Schritten:
Führen Sie es für ein Profil oder parallel für viele Profile aus:
targets.json listet die Profile auf:
Prüfen Sie die Ergebnisse mit jobs und job <jobId>. --status akzeptiert running, ok, partial oder failed:

Von der Local Agent Browser CLI migrieren

  • Skripte, die gologin-local-agent-browser aufrufen, funktionieren weiterhin. Der Befehl stammt jetzt aus gologin-agent-browser-cli.
  • Profile, Konfiguration und Job-Verlauf in ~/.gologin-local-agent-browser/ bleiben an ihrem Platz.
  • Für KI-Agenten installieren Sie den Agent Browser Skill. Er deckt beide Runtimes ab, der separate Local-Agent-Browser-Skill ist veraltet.

Verwandte Themen

npm-Paket

gologin-agent-browser-cli

Quellcode

GologinLabs/agent-browser