browser

Browser Automation

Minimal Chrome DevTools Protocol (CDP) helpers for browser automation without MCP server setup.

Setup

Install dependencies before first use:

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

Scripts

All scripts connect to Chrome on 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; })()'

Use single expressions or IIFE for multiple statements.

screenshot.js - Capture Screenshot

scripts/screenshot.js

Returns { path, filename } of saved PNG in temp directory.

pick.js - Visual Element Picker

scripts/pick.js "Click the submit button"

Returns element metadata: tag, id, classes, text, href, selector, rect.

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