Browser Automation

Setup

npm install --prefix ~/.claude/skills/browser/browser ws

Scripts

localhost:9222

start.js - Launch Chrome

scripts/start.js              # Fresh profile
scripts/start.js --profile    # Use persistent profile (keeps cookies/auth)

nav.js - Navigate

scripts/nav.js https://example.com        # Navigate current tab
scripts/nav.js https://example.com --new  # Open in new tab

eval.js - Execute JavaScript

scripts/eval.js 'document.title'
scripts/eval.js '(() => { const x = 1; return x + 1; })()'

screenshot.js - Capture Screenshot

scripts/screenshot.js

{ path, filename }

pick.js - Visual Element Picker

scripts/pick.js "Click the submit button"

Workflow

1. Launch Chrome:

   scripts/start.js --profile

   for authenticated sessions
2. Navigate:

   scripts/nav.js <url>

3. Inspect:

   scripts/eval.js 'document.querySelector(...)'

4. Capture:

   scripts/screenshot.js

   or

   scripts/pick.js

5. Return gathered data

Key Points

• All operations run locally - credentials never leave the machine
• Use

  --profile

  flag to preserve cookies and auth tokens
• Scripts return structured JSON for agent consumption