browser-automation

name	browser-automation
description	Browser automation via Playwright MCP for tasks requiring an interactive web session: login, click flows, screenshots, form-fill, multi-step scraping. Complement to the scraping skill (tier 4). [WHAT] Playwright skill for: fetching content behind login, filling forms (government services, subscriptions), screenshots for evidence preservation (OSINT, source verification), interactive scraping of heavy SPAs. Headless by default; headed mode when needed. [WHEN] Use when: browser automation, playwright, click on, fill form, screenshot of site, login-required scrape, "log in to X and fetch", multi-step flow, "fetch behind paywall via subscription". NOT for: simple GET requests (use scraping tier 1-3), background jobs (Playwright is synchronous). [LANGUAGE] English and other languages.
argument-hint	[task with URL and steps]
allowed-tools	mcp__playwright__browser_navigate, mcp__playwright__browser_click, mcp__playwright__browser_type, mcp__playwright__browser_snapshot, mcp__playwright__browser_take_screenshot, mcp__playwright__browser_fill_form, mcp__playwright__browser_evaluate, mcp__playwright__browser_wait_for, mcp__playwright__browser_close, Read, Write

Browser automation

Role: interactive browser automation via Playwright MCP.

Workflows

1. Fetch behind login

1. browser_navigate → login page
2. browser_fill_form (username, password)
3. browser_click → submit
4. browser_wait_for → success element
5. browser_navigate → target URL
6. browser_snapshot → markdown extraction

Auth convention: credentials are read from ~/.claude/.env, never hardcoded. If credentials are missing, ask the user.

2. Screenshot for evidence preservation

OSINT use: capture site state at a given moment.

browser_navigate → URL
browser_take_screenshot → ~/Pictures/ogmios/evidence/[YYYY-MM-DDTHH:MM]_[domain].png

Add a metadata file with URL, timestamp, sha256 of the screenshot.

3. Filling government / service forms

Common use: tedious forms (insurance claims, subscriptions, government applications).

browser_fill_form with {selector: value} mapping

ALWAYS verify with browser_snapshot before submit. The user must be able to review.

4. Multi-step scraping (SPA)

For sites where tier 3 (BrightData) fails due to JS rendering or multi-page navigation.

loop:
  browser_navigate
  browser_wait_for
  browser_snapshot
  → extract data
  → click "next"

5. Browser-agent mode

For complex tasks ("log in to site X and fetch all reports I haven't read"), delegate to a browser agent (Playwright MCP via agent flow). Convention: the agent must be interruptible between steps.

Security

• Never save credentials in logs (sanitize output)
• Never leave a headed browser open (always browser_close at the end)
• Ask the user before login to sensitive accounts (bank, government)
• Preserved screenshots: user-only path, never shared

Output format

Task	Output
Scrape	Markdown to stdout/file
Screenshot	PNG in ~/Pictures/ogmios/evidence/
Form-fill	Confirmation + screenshot of success page
Multi-step	JSON array with extracted data

Version history

• v3.0 (2026-05-02): initial public release.