Is site complex? (SPAs, accordions, cookie dialogs, external redirects, auth)
├── YES → Use pw-writer
│   ├── Token-constrained? → getCleanHTML (40x fewer tokens)
│   ├── Need navigation? → accessibilitySnapshot + aria-ref
│   └── Visual layout complex? → screenshotWithAccessibilityLabels
│
└── NO → Selectors unambiguous? (unique IDs, test-ids)
    ├── YES → Use pw-fast batch_execute (fastest: ~2s)
    └── NO → Use pw-writer (more reliable)

Need to discover hidden APIs?
├── YES → pw-writer network interception
└── NO → DOM-based extraction

// Navigate and wait
await page.goto('https://example.com', { waitUntil: 'domcontentloaded' });
await waitForPageLoad({ page, timeout: 5000 });

// Extract with getCleanHTML (40x fewer tokens than snapshot)
const html = await getCleanHTML({
  locator: page.locator('table.data'),
  search: /price|item/i  // Optional: filter results
});
console.log(html);

// Get accessibility snapshot for navigation
console.log(await accessibilitySnapshot({ page, search: /menu|button/i }));

// Click using aria-ref from snapshot (no quotes on ref value!)
await page.locator('aria-ref=e14').click();
await waitForPageLoad({ page });

{
  "name": "browser_batch_execute",
  "arguments": {
    "steps": [
      { "tool": "browser_navigate", "arguments": { "url": "https://example.com" }},
      { "tool": "browser_type", "arguments": {
        "selectors": [{ "css": "#search" }], "text": "query"
      }},
      { "tool": "browser_click", "arguments": {
        "selectors": [{ "role": "button", "text": "Search" }]
      }}
    ],
    "globalExpectation": { "includeSnapshot": false }
  }
}

// Setup listener
state.responses = [];
page.on('response', async res => {
  if (res.url().includes('/api/')) {
    try {
      state.responses.push({ url: res.url(), body: await res.json() });
    } catch {}
  }
});

// Trigger actions (scroll, click, navigate)
await page.click('button.load-more');

// Analyze captured API responses
console.log(`Captured ${state.responses.length} API calls`);
state.responses.forEach(r => console.log(r.url));

// Cleanup
page.removeAllListeners('response');