The Complete Production SOP: How to Deploy and Run Playwright Stealth Browser Fingerprint Masking in Autonomous AI Agents

---
name: "playwright-stealth-fingerprint"
description: "Bypass advanced bot detection and Cloudflare Turnstile with Playwright Stealth."
triggers:
  - "bypass cloudflare bot detection playwright"
  - "hide navigator.webdriver playwright"
  - "emulate human mouse movement"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

import { chromium } from 'playwright-extra';
import stealthPlugin from 'puppeteer-extra-plugin-stealth';

const stealth = stealthPlugin();
stealth.enabledEvasions.delete('iframe.contentWindow'); // Prevent breaking modern framework iframes
chromium.use(stealth);

export async function getStealthContext() {
  const browser = await chromium.launch({
    headless: true,
    args: [
      '--disable-blink-features=AutomationControlled',
      '--no-sandbox',
      '--disable-setuid-sandbox'
    ]
  });
  return browser.newContext({
    userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36',
    viewport: { width: 1920, height: 1080 },
    deviceScaleFactor: 1,
    locale: 'en-US',
    timezoneId: 'America/New_York'
  });
}

import { Page } from 'playwright';

export async function humanClick(page: Page, selector: string): Promise<void> {
  const element = await page.waitForSelector(selector, { state: 'visible' });
  const box = await element.boundingBox();
  if (!box) throw new Error(`Target ${selector} not rendered in layout.`);

  const targetX = box.x + box.width * (0.3 + Math.random() * 0.4);
  const targetY = box.y + box.height * (0.3 + Math.random() * 0.4);

  await page.mouse.move(targetX, targetY, { steps: Math.floor(15 + Math.random() * 10) });
  await page.waitForTimeout(100 + Math.random() * 150);
  await page.mouse.down();
  await page.waitForTimeout(50 + Math.random() * 60);
  await page.mouse.up();
}

import { getStealthContext } from '../src/scraper/browserFactory';

async function testEvasion() {
  const context = await getStealthContext();
  const page = await context.newPage();
  await page.goto('https://bot.sannysoft.com/', { waitUntil: 'networkidle' });
  
  const webdriver = await page.evaluate(() => navigator.webdriver);
  if (webdriver !== false && webdriver !== undefined) {
    console.error('FATAL: navigator.webdriver leaked as true');
    process.exit(1);
  }
  console.log('PASSED: Stealth fingerprint verified successfully.');
  await context.close();
}

testEvasion();