clawbrowser

Use when the agent needs to drive a browser through the Microsoft Playwright CLI (playwright-cli) for navigation, form interactions, screenshots, recordings, data extraction, session management, or debugging without loading a full MCP browser. It trains the agent on the CLI commands, snapshots, and session/config habits that make Playwright CLI reliable for scripted browsing.

1. Zainstaluj Playwright CLI globalnie na swoim systemie, uruchamiając npm install -g @playwright/cli@latest, a następnie sprawdź dostępność polecenia playwright-cli --help — to wyświetli wszystkie dostępne opcje i komendy.

2. Skonfiguruj plik playwright-cli.json w swoim projekcie, aby ustawić nazwę przeglądarki, opcje uruchamiania, rozmiar okna, timeout'y, katalogi wyjściowe i ustawienia nagrywania — dzięki temu nie będziesz musiał powtarzać parametrów w każdym poleceniu. Jeśli chcesz zobaczyć interfejs przeglądarki zamiast trybu headless, dodaj flagę --headed do polecenia open lub ustaw headless na false w konfiguracji.

3. Rozpocznij sesję przeglądarki poleceniem playwright-cli open , gdzie to adres strony, którą chcesz otworzyć. Jeśli potrzebujesz izolacji sesji, dodaj flagę --session=nazwa.

4. Po załadowaniu strony uruchom playwright-cli snapshot, aby wygenerować referencje elementów (e1, e2 itd.) — zawsze rób snapshot przed interakcją z elementami i ponownie po zmianach w DOM.

5. Używaj snapshot'ów do nawigacji, klikania, wypełniania formularzy i ekstrakcji danych — każde polecenie interakcji odwołuje się do identyfikatorów elementów z ostatniego snapshot'u.

6. Dla bardziej złożonych scenariuszy wykorzystaj opcje nagrywania i debugowania dostępne w CLI — zawsze miej dostęp do playwright-cli --help, aby odświeżyć sobie dostępne komendy przed próbą nowej akcji.