git:20260115.3ef4b5e to git:20260115.f779126

---

name: browser-automation

description: Local Python-based browser automation toolkit using Playwright. Provides command-line tools for navigating, interacting with, and testing web applications without using MCP protocols. Supports clicking, typing, hovering, screenshots, content extraction, and JavaScript execution.

license: ISC

---

# Browser Automation Skill

This skill provides local browser automation capabilities using Python and Playwright. All browser automation is performed locally via CLI commands - **no MCP servers required**.

## Prerequisites

Install Playwright Python library:

```bash

pip install playwright

playwright install chromium

```

## Available Tools

### browser_navigate

Navigate to a URL and wait for the page to load.

**Usage:**

```bash

```

**Example:**

```bash

```

### browser_click

Click an element on a page using a CSS selector or text match.

**Usage:**

```bash

```

**Parameters:**

- `url`: URL to navigate to

- `selector`: CSS selector for the element

- `--text`: (Optional) Text to match instead of using selector

**Examples:**

```bash

# Click by selector

# Click by text

```

### browser_type

Type text into an input field, with optional form submission.

**Usage:**

```bash

```

**Parameters:**

- `url`: URL to navigate to

- `selector`: CSS selector for the input field

- `text`: Text to type

- `--submit`: (Optional) Press Enter after typing

**Examples:**

```bash

# Type into field

# Type and submit

```

### browser_screenshot

Capture a screenshot of the current page.

**Usage:**

```bash

```

**Parameters:**

- `url`: URL to navigate to

- `path`: Output file path for the screenshot

- `--full_page`: (Optional) Capture the entire scrollable page

**Examples:**

```bash

# Viewport screenshot

# Full page screenshot

```

### browser_get_content

Extract text or HTML content from the page or a specific element.

**Usage:**

```bash

```

**Parameters:**

- `url`: URL to navigate to

- `--selector`: (Optional) CSS selector, defaults to 'body'

- `--html`: (Optional) Return HTML instead of text

**Examples:**

```bash

# Get all page text

# Get specific element text

# Get HTML

```

### browser_hover

Hover over an element to trigger hover states or tooltips.

**Usage:**

```bash

```

**Parameters:**

- `url`: URL to navigate to

- `selector`: CSS selector for the element

**Example:**

```bash

```

### browser_evaluate

Execute custom JavaScript code in the browser context.

**Usage:**

```bash

```

**Parameters:**

- `url`: URL to navigate to

- `script`: JavaScript code to execute

**Examples:**

```bash

# Get page title

# Get element count

# Manipulate DOM

```

## Best Practices

1. **Always use full URLs**: Include the protocol (http:// or https://)

2. **Wait for content**: The tool automatically waits for 'networkidle' state

3. **Use robust selectors**: Prefer ID selectors (#id) or specific CSS classes

4. **Error handling**: All commands exit with non-zero status on failure and print errors to stderr

5. **Headless mode**: All operations run in headless Chromium by default

## Common Patterns

### Form Automation

```bash

# Fill out a multi-field form

```

### Visual Testing

```bash

```

### Content Extraction

```bash

# Extract and process page content

```

## Architecture

- **Stateless design**: Each command launches a new browser instance

- **No persistent sessions**: Browser closes after each operation

- **Local execution**: All automation runs locally, no remote MCP servers

- **Simple I/O**: Results printed to stdout, errors to stderr

## Troubleshooting

If you encounter issues:

1. **Install Playwright browsers**: Run `playwright install chromium`

2. **Check Python version**: Requires Python 3.8+

3. **Verify URL accessibility**: Ensure the target URL is reachable

4. **Inspect selectors**: Use browser DevTools to verify CSS selectors

## Related Resources

- Examples: `assets/skills/webapp-testing/examples/`

- Playwright Documentation: https://playwright.dev/python/