Playwriter

Browser automation via MCP. Requires Chrome extension installed and clicked on target tab.

Tools

execute

Run Playwright code with access to page, context, state (persistent), and utility functions.

// Single-line format with semicolons
await page.goto('https://example.com', { waitUntil: 'domcontentloaded' });

reset

Reset CDP connection when errors occur or pages show as about:blank.

Core Patterns

Check Page State (do this after actions)

console.log('url:', page.url()); console.log(await accessibilitySnapshot({ page }).then(x => x.split('\n').slice(0, 30).join('\n')));

Click Elements (use aria-ref from snapshot)

await page.locator('aria-ref=e13').click();

Fill Input

await page.locator('input[name="email"]').fill('test@example.com');

Screenshot

await page.screenshot({ path: 'shot.png', scale: 'css' });

Visual Screenshot with Labels

await screenshotWithAccessibilityLabels({ page });

Utility Functions

Function	Purpose
accessibilitySnapshot({ page, search? })	Get structured text of interactive elements
screenshotWithAccessibilityLabels({ page })	Screenshot with Vimium-style element labels
getCleanHTML({ locator })	Get cleaned semantic HTML
getLatestLogs({ page?, count?, search? })	Retrieve browser console logs
waitForPageLoad({ page })	Smart load detection
getCDPSession({ page })	Send raw CDP commands

Rules

• Multiple calls: Break complex logic into separate execute calls
• Never close: Don't call browser.close() or context.close()
• No bringToFront: Never call unless user asks
• Always verify: Check page state after clicks/navigation
• Persist data: Use state.myVar = value across calls