# Playwright Undetected Skill

> A Claude skill from dalbit-mir/playwright-undetected-skill.

- **Type:** Skill
- **Install:** `agentstack add skill-dalbit-mir-playwright-undetected-skill-playwright-undetected-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [dalbit-mir](https://agentstack.voostack.com/s/dalbit-mir)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [dalbit-mir](https://github.com/dalbit-mir)
- **Source:** https://github.com/dalbit-mir/playwright-undetected-skill

## Install

```sh
agentstack add skill-dalbit-mir-playwright-undetected-skill-playwright-undetected-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Playwright Undetected - Browser Automation Skill

Patchright-based browser automation with bot detection bypass. Localhost, dev servers, web app testing, screenshots, UI interactions - all in one skill.

## Triggers

**URL/Network:**
- localhost (http://localhost:*, http://127.0.0.1:*)
- Local IPs (192.168.x.x, 10.x.x.x, 172.16-31.x.x)
- Dev server ports (3000, 5173, 8080, 4200, 5000, etc.)

**Web App Testing:**
- "test the app", "check the site"
- "open localhost", "view in browser"
- "take screenshot", "capture screen"
- "check UI", "view page"
- QA, E2E testing, dev build verification

**Browser Interaction:**
- "click", "press button"
- "type", "fill form"
- "login", "sign up"
- "open menu", "click tab"
- "scroll", "navigate"

**Visual Verification:**
- "how does it look?", "is it working?"
- "check design", "verify layout"
- "responsive test", "screen size"
- "check rendering", "verify component"

**Development Workflow:**
- Verify changes after code edits
- Frontend debugging
- Real-time dev feedback
- Pre-deployment checks

## Core: Server Mode (Session Persistence!)

**Problem**: executor.py terminates process on each call -> browser session lost
**Solution**: server.py runs background server -> session persists

### Start Server (Required!)

```bash
cd ~/.claude/skills/playwright-undetected
python server.py start &
```

### Server Commands

```bash
# Check status
python server.py status

# Stop server
python server.py stop

# Call tool
python server.py call '{"tool": "...", "args": {...}}'
```

## Usage

### 1. Navigate + Screenshot (Most Common Pattern)

```bash
cd ~/.claude/skills/playwright-undetected

# Start server (if not running)
python server.py start &
sleep 2

# Navigate to page
python server.py call '{"tool": "navigate", "args": {"url": "http://localhost:3000"}}'

# Take screenshot
python server.py call '{"tool": "screenshot", "args": {"path": "screenshot.png", "full_page": true}}'
```

### 2. Click + Interaction

```bash
# Click element
python server.py call '{"tool": "click", "args": {"selector": "button.submit"}}'
python server.py call '{"tool": "click", "args": {"selector": "#menu-btn"}}'
python server.py call '{"tool": "click", "args": {"selector": "body"}}'  # Click anywhere

# Type text
python server.py call '{"tool": "type", "args": {"selector": "#email", "text": "test@test.com"}}'
python server.py call '{"tool": "type", "args": {"selector": "input[name=password]", "text": "password123"}}'
```

### 3. Get Information

```bash
# Current URL
python server.py call '{"tool": "get_url"}'

# Page title
python server.py call '{"tool": "get_title"}'

# Element text
python server.py call '{"tool": "get_text", "args": {"selector": ".error-message"}}'
```

### 4. Wait

```bash
# Wait for element to appear
python server.py call '{"tool": "wait_for", "args": {"selector": ".loading-complete", "timeout": 10000}}'
```

## Tool Reference

| Tool | Description | Args |
|------|-------------|------|
| launch | Start browser | headless: bool (default: false) |
| close | Close browser | - |
| navigate | Go to URL | url: string (required) |
| screenshot | Save to file | path: string, full_page: bool |
| click | Click element | selector: string (required) |
| type | Type text | selector: string, text: string |
| get_text | Get element text | selector: string |
| wait_for | Wait for element | selector: string, timeout: int |
| get_url | Get current URL | - |
| get_title | Get page title | - |

## Examples

### Login Test

```bash
cd ~/.claude/skills/playwright-undetected
python server.py start &
sleep 2

# Navigate to login page
python server.py call '{"tool": "navigate", "args": {"url": "http://localhost:3000/login"}}'
python server.py call '{"tool": "screenshot", "args": {"path": "login_page.png"}}'

# Fill form
python server.py call '{"tool": "type", "args": {"selector": "#email", "text": "admin@test.com"}}'
python server.py call '{"tool": "type", "args": {"selector": "#password", "text": "admin123"}}'
python server.py call '{"tool": "screenshot", "args": {"path": "login_filled.png"}}'

# Submit
python server.py call '{"tool": "click", "args": {"selector": "button[type=submit]"}}'
sleep 2
python server.py call '{"tool": "screenshot", "args": {"path": "login_result.png"}}'
```

### App Navigation

```bash
# Enter app
python server.py call '{"tool": "navigate", "args": {"url": "http://localhost:3000"}}'
python server.py call '{"tool": "click", "args": {"selector": "body"}}'  # Click to enter
sleep 2
python server.py call '{"tool": "screenshot", "args": {"path": "app_main.png", "full_page": true}}'

# Explore features
python server.py call '{"tool": "click", "args": {"selector": ".create-btn"}}'
python server.py call '{"tool": "screenshot", "args": {"path": "after_action.png"}}'
```

## Selector Tips

```css
/* ID */
#submit-btn

/* Class */
.nav-menu
button.primary

/* Attribute */
input[type=email]
button[data-testid="login"]
a[href="/about"]

/* Text content */
text=Login
text=Submit

/* Combined */
form#login button[type=submit]
.sidebar .menu-item:first-child
```

## Technical Specs

- **Engine**: patchright (undetected playwright fork)
- **Browser**: Google Chrome (channel: 'chrome')
- **Bot Detection Bypass**: YES (Cloudflare, reCAPTCHA, etc.)
- **Localhost Support**: YES
- **Private IP Support**: YES
- **Server Port**: 9222

## Troubleshooting

**"Server not running" error:**
```bash
python server.py start &
sleep 2
```

**Browser not visible:**
- headless=False is default, browser window should appear
- In server mode, browser persists in background

**Session disconnected:**
- Use server.py instead of executor.py
- Server keeps session alive once started

**Element not found:**
- Use wait_for to wait first
- Verify selector in DevTools

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [dalbit-mir](https://github.com/dalbit-mir)
- **Source:** [dalbit-mir/playwright-undetected-skill](https://github.com/dalbit-mir/playwright-undetected-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-dalbit-mir-playwright-undetected-skill-playwright-undetected-skill
- Seller: https://agentstack.voostack.com/s/dalbit-mir
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.