---
name: ccf-playwright-browser
description: Stealth browser automation using Playwright with snapshot-based environment restoration. Use when browser automation needs anti-bot evasion, snapshot or cookie restoration, proxy support, or human-like navigation behavior.
metadata: {"openclaw":{"emoji":"🎭","os":["linux","darwin","win32"],"requires":{"bins":["node","npx"]},"install":[{"id":"npm-playwright","kind":"npm","package":"playwright","bins":["playwright"],"label":"Install Playwright"}]}}
---



# Playwright Stealth Automation Skill



This skill launches a **stealth Playwright browser** with anti-bot protections and snapshot-based environment restoration.



It bypasses many common detection systems including:



- Cloudflare

- Datadome

- Akamai

- PerimeterX



Capabilities:



- browser snapshot restore

- cookies restore

- localStorage/sessionStorage restore

- navigator fingerprint spoofing

- WebGL fingerprint spoof

- Canvas fingerprint noise

- Audio fingerprint noise

- human mouse movement

- human scrolling

- header spoofing

- proxy support



---



# Installation



```

npm install -g playwright

npx playwright install chromium

```



Linux:



```

sudo npx playwright install-deps chromium

```



---



# Snapshot Input



The browser environment can be restored using a **snapshot JSON**.



Priority order:



```

1 user provided snapshot JSON

2 scripts/snapshot.json

```



If the user provides a JSON snapshot block, it should be passed to the script.



---



# Launching Browser



Agents should initialize the browser by executing:



```

node scripts/init_browser.js

```



If the user provides snapshot JSON, pass it via stdin:



```

node scripts/init_browser.js <<EOF

{snapshot json}

EOF

```



---



# Automation Strategy



Agents should simulate human behavior:



- random delays

- mouse movement

- natural scrolling

- avoid deterministic timing



Example actions after browser launch:



- navigate to a page

- scroll gradually

- move mouse randomly

- wait between actions



---



# Proxy Example



```

HTTP_PROXY=http://127.0.0.1:7890 node scripts/init_browser.js

```



---



# References



Playwright Docs  

https://playwright.dev



API Reference  

https://playwright.dev/docs/api