Ś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:
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
Dane uwierzytelniające
Jak uzyskać token
- Zarejestruj się lub zaloguj na gologin.com
- Otwórz API & MCP w panelu
- Otwórz kartę API
- Kliknij New Token
- Skopiuj wygenerowany token dostępu
Plik konfiguracyjny
~/.gologin-agent-browser/config.json
Architektura
Składa się z dwóch części:- CLI
gologin-agent-browser— analizuje polecenia, wybiera środowisko, automatycznie uruchamia odpowiedni demon i wyświetla zwięzły wynik - 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
- gnieździe Unix pod ścieżką
${TMPDIR:-/tmp}/gologin-agent-browser.sock - lokalnym HTTP pod adresem
127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777}
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:
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.--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-hosti--proxy-port(oraz--proxy-mode http|socks4|socks5,--proxy-user,--proxy-pass) - W środowisku chmurowym
opennie 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-createiprofile-updateprzyjmują--proxy-country
Powiązane materiały
- Gologin Web Access CLI — zunifikowane CLI (scraping + przeglądarka)
- Local runtime — uruchamianie lokalnych profili Orbita za pomocą tego CLI
- Cloud Browser Getting Started — przykłady dla Puppeteer/Playwright
- AI Skills — gotowe do użycia umiejętności dla Claude Code
Pakiet npm
gologin-agent-browser-cli
Kod źródłowy
GologinLabs/agent-browser