- Web Unlocker — bezstanowy odczyt i ekstrakcja danych. Najlepszy wybór, gdy chcesz szybko pobrać zawartość strony bez utrzymywania sesji przeglądarki.
- Cloud Browser — interakcja ze stanem sesji. Najlepszy wybór, gdy potrzebujesz nawigacji, klikania, wpisywania tekstu, zrzutów ekranu lub wieloetapowych procesów, które trwają między kolejnymi poleceniami.
Instalacja
Dane uwierzytelniające
Dwa różne zestawy danych uwierzytelniających Gologin obsługują dwa tryby:Plik konfiguracyjny
Dane uwierzytelniające przechowuj w pliku~/.gologin-web-access/config.json:
config init. Polecenie nie jest interaktywne: przekaż klucze jako flagi albo pobierze je ze zmiennych środowiskowych opisanych powyżej. Następnie sprawdzi klucze w API Gologin:
--no-validate, aby pominąć sprawdzanie kluczy. Jeśli plik konfiguracyjny już istnieje, config init pozostawi go bez zmian, chyba że dodasz --force.
Szybki start — odczyt strony
Szybki start — interakcja ze stroną
Opis poleceń — scraping / read
Te polecenia korzystają z Web Unlocker. Są bezstanowe — nie utrzymują sesji przeglądarki.Pojedyncza strona
Typowe opcje:
--format text|markdown|html, --source auto|unlocker|browser, --fallback none|browser
Operacje wsadowe
Opcje operacji wsadowych:
--format, --source, --only-main-content, --retry <n>, --backoff-ms <ms>, --summary, --output <path>, --strict
Domyślnie batch-scrape kończy działanie z kodem 0 przy częściowym powodzeniu. Dodaj --strict, aby polecenie kończyło się błędem przy dowolnym niepowodzeniu.
Wyszukiwanie i odkrywanie
Opcje:
--limit <n>, --max-depth <n>, --concurrency <n>, --only-main-content
Asynchroniczne zadania crawl
Śledzenie zmian
Runbooki
Opis poleceń — browser / interact
Te polecenia korzystają z Cloud Browser. Utrzymują sesję ze stanem za pośrednictwem lokalnego demona.Zarządzanie sesjami
Opcje:
--profile <id>, aby użyć wybranego profilu Gologin.
Odczyt strony
Interakcja
Nawigacja
Karty
Pliki cookie i pamięć lokalna
Zaawansowane
Przypadki użycia i przykłady
Pobranie strony z cennikiem konkurencji
nextActionHint sugeruje przejście do trybu przeglądarki.
Budowa korpusu badawczego na podstawie dokumentacji
Monitorowanie zmian na stronach
Wyodrębnianie ustrukturyzowanych danych za pomocą schematu
Zdefiniuj, co chcesz wyodrębnić. Schemat przypisuje każde pole wyjściowe do selektora CSS:selector— selektor CSStype—text(domyślnie),html,attrlubexistsattribute— nazwa atrybutu, gdytypema wartośćattrall—truezwraca wszystkie dopasowania w postaci listyfields— zagnieżdżony schemat stosowany wewnątrz każdego dopasowania
batch-extract.
Wyszukiwanie w sieci i pobieranie wyników
Logowanie do witryny i interakcja
Gdy samo pobieranie treści nie wystarcza i trzeba klikać, wpisywać tekst oraz nawigować:Analiza lokalnych dokumentów
Nie tylko strony internetowe — możesz analizować także pliki PDF, dokumenty Word i arkusze Excel:Automatyzacja wieloetapowych procesów za pomocą runbooków
Zdefiniuj sekwencję kroków w pliku JSON i odtwarzaj ją, kiedy chcesz:Routing źródła
Polecenia obsługujące opcję--source mogą korzystać z różnych backendów:
Ustrukturyzowane dane wyjściowe
scrape-json zwraca bogate metadane, w tym:
title,description,headings,headingsByLevel,links- Klasyfikację wyniku:
ok,empty,incomplete,authwall,challenge,blocked,cookie_wall nextActionHint— sugerowany kolejny krok, gdy strona nie jest w pełni dostępna
search zwraca requestedLimit, returnedCount, warnings, cacheTtlMs oraz position dla każdego wyniku.
Powiązane materiały
- Web Unlocker SDK — SDK dla TypeScript do użycia programistycznego
- Czym jest Web Unlocker — omówienie produktu
- Agent Browser CLI — CLI wyłącznie do obsługi przeglądarki dla agentów AI
- Lokalne środowisko uruchomieniowe — Agent Browser CLI z lokalnymi profilami Orbita
- AI Skills — gotowe do użycia umiejętności dla Claude Code
Pakiet npm
gologin-web-access
Kod źródłowy
GologinLabs/gologin-web-access