Przejdź do głównej treści
Gologin Agent Browser CLI zamienia profile przeglądarki Gologin w trwałe środowisko uruchomieniowe, którym agenci AI mogą sterować za pomocą skryptów. Sesje działają w Gologin Cloud Browser lub w Orbita na Twoim komputerze. Narzędzie udostępnia zwięzłe migawki stron, interakcję opartą na refach, pamięć sesji oraz wynik przyjazny dla powłoki. W przeciwieństwie do pisania kodu Puppeteer/Playwright od zera, to CLI daje agentom gotowy zestaw poleceń do automatyzacji przeglądarki — bez kodu szablonowego i bez własnej obsługi sesji.

Środowisko w chmurze lub lokalne

CLI ma dwa środowiska uruchomieniowe z tymi samymi poleceniami. Oba korzystają z profili, fingerprintów i proxy Gologin, a demon utrzymuje sesje przy życiu między kolejnymi wywołaniami CLI. Środowisko wybierasz dla pojedynczego polecenia za pomocą --runtime cloud|local|auto albo ustawiasz raz zmienną GOLOGIN_AGENT_BROWSER_RUNTIME:
Domyślnie (auto) polecenia profili, runbooków i zadań działają lokalnie, a wszystkie pozostałe w chmurze. Po otwarciu sesji lokalnej przekazuj --runtime local także do kolejnych poleceń. Wymagania i polecenia dostępne tylko lokalnie znajdziesz w sekcji Local runtime.

Instalacja

Lub uruchom bez instalacji globalnej:
Wymaga Node.js w wersji 18 lub nowszej. Środowisko lokalne wymaga Node.js w wersji 20 lub nowszej.

Dane uwierzytelniające

Jak uzyskać token

  1. Zarejestruj się lub zaloguj na gologin.com
  2. Otwórz API & MCP w panelu
  3. Otwórz kartę API
  4. Kliknij New Token
  5. Skopiuj wygenerowany token dostępu

Plik konfiguracyjny

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

Architektura

Składa się z dwóch części:
  1. CLI gologin-agent-browser — analizuje polecenia, wybiera środowisko, automatycznie uruchamia odpowiedni demon i wyświetla zwięzły wynik
  2. Trwałe lokalne demony, po jednym na każde środowisko — zarządzają aktywnymi sesjami przeglądarki, łączą się z Gologin Cloud Browser lub lokalną Orbita przez Playwright connectOverCDP, trzymają aktywną stronę w pamięci, budują migawki, rozwiązują refy i śledzą metadane sesji
Transport jest wyłącznie lokalny. Demon chmurowy nasłuchuje na:
  • gnieździe Unix pod ścieżką ${TMPDIR:-/tmp}/gologin-agent-browser.sock
  • lokalnym HTTP pod adresem 127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777}
W środowisku chmurowym, jeśli nie podasz ID profilu, demon tworzy tymczasowy profil Gologin w chmurze za pośrednictwem API.

Jak działają refy

snapshot wyświetla zwięzły widok strony i przypisuje refy, takie jak @e1, @e2, @e3, elementom interaktywnym. Możesz działać na nich bezpośrednio:
Refy działają w trybie „best-effort” i po nawigacji lub większych zmianach w DOM należy wygenerować je ponownie. Polecenia przyjmują też selektory CSS zamiast refów. Na stronach dynamicznych lepszym rozwiązaniem zapasowym niż nieaktualne refy jest zwykle find: lokalizuje element na aktywnej stronie i wykonuje na nim akcję w jednym kroku.

Szybki start


Przykład pętli agenta

Typowa pętla agenta AI:

Pełna lista poleceń

Diagnostyka

Zarządzanie sesjami

Odczyt strony

Interakcja

Klawiatura i przewijanie

Nawigacja

Karty

Ciasteczka i pamięć lokalna

Zaawansowane

Profile, proxy i API Gologin

Te polecenia wywołują API Gologin z użyciem Twojego tokena i nie wymagają demona przeglądarki.
Dodaj --help do dowolnego polecenia, aby wyświetlić jego sposób użycia.

Tylko środowisko lokalne

profiles, profile, profile-create, profile-update, profile-import, profile-sync, profile-delete, run, batch, jobs i job służą do zarządzania lokalnymi profilami, runbookami i historią zadań. Zobacz Local runtime.

Aliasy


Zastosowania i przykłady

Sprawdź, czy Twoja strona przechodzi testy anti-detect

Zaloguj się do aplikacji webowej i pobierz dane z panelu

Wypełnij wieloetapowy formularz

Rób zrzuty ekranu stron konkurencji

Wyszukiwanie na stronie, która blokuje scraping

Niektóre strony wymagają wykonania JavaScriptu, zalogowania się lub interakcji, zanim pokażą wyniki. Użyj przeglądarki, aby przeprowadzić wyszukiwanie:

Zapisywanie i przywracanie stanu sesji

Wyeksportuj ciasteczka i pamięć lokalną, aby użyć ich w kolejnych sesjach:

Sesje równoległe

Używaj jawnych identyfikatorów --session dla niezależnych zadań w chmurze. Porządkuj za pomocą close --all lub sessions --prune --older-than-ms.

Zasady dotyczące proxy

  • Profile ze skonfigurowanym proxy: proxy jest ustawione w profilu w panelu Gologin lub przez API, na przykład proxy add-gologin <profileId> --country us
  • Tymczasowe profile w chmurze: bez proxy albo z własnym proxy za pomocą --proxy-host i --proxy-port (oraz --proxy-mode http|socks4|socks5, --proxy-user, --proxy-pass)
  • W środowisku chmurowym open nie przyjmuje --proxy-country. Aby korzystać z ruchu proxy Gologin z danego kraju, dodaj proxy Gologin do profilu i otwórz go z --profile
  • W środowisku lokalnym open, profile-create i profile-update przyjmują --proxy-country

Powiązane materiały

Pakiet npm

gologin-agent-browser-cli

Kod źródłowy

GologinLabs/agent-browser