- Web Unlocker — zustandsloses Lesen und Extrahieren. Ideal, wenn Sie Seiteninhalte schnell abrufen möchten, ohne eine Browser-Sitzung aufrechtzuerhalten.
- Cloud Browser — zustandsbehaftete Interaktion. Ideal, wenn Sie Navigation, Klicks, Texteingaben, Screenshots oder mehrstufige Abläufe benötigen, die über mehrere Befehle hinweg bestehen bleiben.
Installation
Zugangsdaten
Zwei verschiedene Gologin-Zugangsdaten steuern die beiden Modi:Konfigurationsdatei
Speichern Sie die Zugangsdaten in~/.gologin-web-access/config.json:
config init. Der Befehl ist nicht interaktiv: Übergeben Sie die Schlüssel als Flags, oder er übernimmt sie aus den oben genannten Umgebungsvariablen. Anschließend prüft er die Schlüssel gegen die Gologin-APIs:
--no-validate überspringen Sie die Schlüsselprüfung. Wenn die Konfigurationsdatei bereits existiert, lässt config init sie unverändert, sofern Sie nicht --force hinzufügen.
Schnellstart — eine Seite lesen
Schnellstart — mit einer Website interagieren
Befehlsreferenz — Scraping / Read
Diese Befehle nutzen Web Unlocker. Sie sind zustandslos — es wird keine Browser-Sitzung aufrechterhalten.Einzelne Seite
Gängige Optionen:
--format text|markdown|html, --source auto|unlocker|browser, --fallback none|browser
Batch-Operationen
Batch-Optionen:
--format, --source, --only-main-content, --retry <n>, --backoff-ms <ms>, --summary, --output <path>, --strict
Standardmäßig gibt batch-scrape bei teilweisem Erfolg den Exit-Code 0 zurück. Mit --strict schlägt der Befehl bei jedem Fehler fehl.
Suche und Discovery
Optionen:
--limit <n>, --max-depth <n>, --concurrency <n>, --only-main-content
Asynchrone Crawl-Jobs
Änderungsverfolgung
Runbooks
Befehlsreferenz — Browser / Interact
Diese Befehle nutzen Cloud Browser. Sie halten über einen lokalen Daemon eine zustandsbehaftete Sitzung aufrecht.Sitzungsverwaltung
Optionen:
--profile <id>, um ein bestimmtes Gologin-Profil zu verwenden.
Seiteninhalt lesen
Interaktion
Navigation
Tabs
Cookies und Speicher
Erweitert
Anwendungsfälle und Beispiele
Die Preisseite eines Wettbewerbers scrapen
nextActionHint empfiehlt den Wechsel in den Browser-Modus.
Einen Recherche-Korpus aus einer Dokumentationsseite aufbauen
Seiten auf Änderungen überwachen
Strukturierte Daten mit einem Schema extrahieren
Legen Sie fest, was extrahiert werden soll. Das Schema ordnet jedes Ausgabefeld einem CSS-Selektor zu:selector— CSS-Selektortype—text(Standard),html,attroderexistsattribute— Attributname, wenntypeden Wertattrhatall—truegibt alle Treffer als Liste zurückfields— ein verschachteltes Schema, das innerhalb jedes Treffers angewendet wird
batch-extract funktioniert das auch über viele Seiten hinweg.
Das Web durchsuchen und Ergebnisse scrapen
Bei einer Website anmelden und interagieren
Wenn Scraping nicht ausreicht — Sie müssen klicken, tippen oder navigieren:Lokale Dokumente parsen
Nicht nur Webseiten — auch PDFs, Word-Dokumente und Excel-Dateien lassen sich parsen:Mehrstufige Workflows mit Runbooks automatisieren
Definieren Sie eine Abfolge von Schritten in JSON und spielen Sie sie erneut ab:Source-Routing
Befehle, die--source unterstützen, können über verschiedene Backends geleitet werden:
Strukturierte Ausgabe
scrape-json liefert umfangreiche Metadaten, darunter:
title,description,headings,headingsByLevel,links- Klassifizierung des Ergebnisses (Outcome):
ok,empty,incomplete,authwall,challenge,blocked,cookie_wall nextActionHint— empfohlener nächster Schritt, wenn die Seite nicht vollständig zugänglich ist
search gibt requestedLimit, returnedCount, warnings, cacheTtlMs sowie pro Ergebnis position zurück.
Siehe auch
- Web Unlocker SDK — TypeScript-SDK für die programmatische Nutzung
- Was ist Web Unlocker — Produktübersicht
- Agent Browser CLI — reine Browser-CLI für KI-Agents
- Lokale Laufzeit — Agent Browser CLI mit lokalen Orbita-Profilen
- AI Skills — Plug-and-play-Skills für Claude Code
npm-Paket
gologin-web-access
Quellcode
GologinLabs/gologin-web-access