browserless-agent

What this skill does

# Browserless Agent 🌐

A comprehensive web automation skill for OpenClaw that provides 30+ browser actions including navigation, data extraction, form filling, screenshot capture, PDF generation, file handling, and advanced web scraping capabilities.

## 🚀 Features

- **Navigation**: Full control over page navigation, redirects, and history
- **Data Extraction**: Get text, attributes, HTML, computed styles, and structured data
- **Form Automation**: Type text, click buttons, select options, upload files
- **Visual Capture**: Screenshots (full page, element-only, viewport)
- **Content Generation**: Save pages as PDF with custom options
- **Advanced Interactions**: Hover, drag-drop, keyboard shortcuts, scrolling
- **Multi-tab Support**: Manage multiple pages and windows
- **Network Control**: Intercept requests, modify headers, block resources
- **Storage Access**: Manage cookies, localStorage, sessionStorage
- **Dynamic Content**: Wait for selectors, network idle, custom conditions
- **iFrames**: Interact with nested frame content
- **Browser State**: Emulate devices, set geolocation, handle dialogs

## 🔧 Configuration

This skill requires the `BROWSERLESS_URL` environment variable to be configured in OpenClaw.
Optionally, you can also set `BROWSERLESS_TOKEN` for authentication.

**To set it up:**
1. Open OpenClaw settings
2. Navigate to Skills → browserless-agent
3. Enter your Browserless base URL in the API Key field
4. (Optional) Add BROWSERLESS_TOKEN in the env section for token authentication

**Configuration Examples:**

### Cloud Service (with token):
```
BROWSERLESS_URL=wss://chrome.browserless.io
BROWSERLESS_TOKEN=your-token-here
```

### Local Service (no token):
```
BROWSERLESS_URL=ws://localhost:3000
```

### Custom Endpoint:
```
BROWSERLESS_URL=wss://your-host.com/playwright/chromium
BROWSERLESS_TOKEN=optional-token
```

The skill will automatically:
- Add `/playwright/chromium` if endpoint is not specified
- Append token as query parameter if `BROWSERLESS_TOKEN` is set
- Work with or without authentication token

Get your Browserless service at: [browserless.io](https://browserless.io)

Get your Browserless service at: [browserless.io](https://browserless.io)

## 📖 Available Actions

### Navigation & Page Control

#### `navigate`
Navigate to a URL.
```json
{"url": "https://example.com"}
```

#### `go_back`
Navigate to previous page in history.
```json
{}
```

#### `go_forward`
Navigate to next page in history.
```json
{}
```

#### `reload`
Reload the current page.
```json
{"hard": false}
```

#### `wait_for_load`
Wait for page to finish loading.
```json
{"timeout": 30000}
```

### Data Extraction

#### `get_text`
Extract text content from element(s).
```json
{"selector": "h1", "all": false}
```

#### `get_attribute`
Get attribute value from element(s).
```json
{"selector": "img", "attribute": "src", "all": false}
```

#### `get_html`
Get inner or outer HTML of element(s).
```json
{"selector": "article", "outer": false, "all": false}
```

#### `get_value`
Get input value from form element(s).
```json
{"selector": "input[name='email']"}
```

#### `get_style`
Get computed CSS style property.
```json
{"selector": ".box", "property": "background-color"}
```

#### `get_multiple`
Extract multiple pieces of data at once.
```json
{
  "extractions": [
    {"name": "title", "selector": "h1", "type": "text"},
    {"name": "image", "selector": "img", "type": "attribute", "attribute": "src"},
    {"name": "price", "selector": ".price", "type": "text"}
  ]
}
```

### Interaction & Input

#### `type_text`
Type text into an element.
```json
{"selector": "input[type='search']", "text": "hello world", "delay": 0, "clear": true}
```

#### `click`
Click on an element.
```json
{"selector": "button.submit", "force": false, "delay": 0}
```

#### `double_click`
Double-click on an element.
```json
{"selector": ".item"}
```

#### `right_click`
Right-click (context menu) on an element.
```json
{"selector": ".context-target"}
```

#### `hover`
Move mouse over an element.
```json
{"selector": ".menu-item"}
```

#### `focus`
Focus on an element.
```json
{"selector": "input"}
```

#### `select_option`
Select option(s) in a dropdown.
```json
{"selector": "select", "values": ["option1", "option2"]}
```

#### `check`
Check a checkbox or radio button.
```json
{"selector": "input[type='checkbox']"}
```

#### `uncheck`
Uncheck a checkbox.
```json
{"selector": "input[type='checkbox']"}
```

#### `upload_file`
Upload file(s) to file input.
```json
{"selector": "input[type='file']", "files": ["path/to/file.pdf"]}
```

#### `press_key`
Press keyboard key(s).
```json
{"key": "Enter"}
```
Common keys: Enter, Tab, Escape, ArrowDown, Control+A, etc.

#### `keyboard_type`
Type text with keyboard (supports shortcuts).
```json
{"text": "Hello World"}
```

### Scrolling & Position

#### `scroll_to`
Scroll to specific position.
```json
{"x": 0, "y": 500}
```

#### `scroll_into_view`
Scroll element into viewport.
```json
{"selector": ".footer"}
```

#### `scroll_to_bottom`
Scroll to bottom of page.
```json
{}
```

#### `scroll_to_top`
Scroll to top of page.
```json
{}
```

### Visual & Capture

#### `screenshot`
Take screenshot of page or element.
```json
{
  "path": "screenshot.png",
  "full_page": true,
  "selector": null,
  "quality": 90,
  "type": "png"
}
```

#### `pdf`
Generate PDF from current page.
```json
{
  "path": "page.pdf",
  "format": "A4",
  "landscape": false,
  "margin": {"top": "1cm", "right": "1cm", "bottom": "1cm", "left": "1cm"},
  "print_background": true
}
```

### Evaluation & Execution

#### `evaluate`
Execute JavaScript in page context.
```json
{"expression": "document.title"}
```

#### `evaluate_function`
Execute JavaScript function with arguments.
```json
{
  "function": "(x, y) => x + y",
  "args": [5, 10]
}
```

### Waiting & Timing

#### `wait_for_selector`
Wait for element to appear.
```json
{"selector": ".dynamic-content", "timeout": 10000, "state": "visible"}
```
States: visible, hidden, attached, detached

#### `wait_for_timeout`
Wait for specified milliseconds.
```json
{"timeout": 2000}
```

#### `wait_for_function`
Wait for JavaScript expression to return truthy.
```json
{
  "expression": "() => document.readyState === 'complete'",
  "timeout": 10000
}
```

#### `wait_for_navigation`
Wait for navigation to complete.
```json
{"timeout": 30000, "wait_until": "networkidle"}
```
wait_until options: load, domcontentloaded, networkidle

### Element State Checking

#### `is_visible`
Check if element is visible.
```json
{"selector": ".modal"}
```

#### `is_enabled`
Check if element is enabled.
```json
{"selector": "button"}
```

#### `is_checked`
Check if checkbox/radio is checked.
```json
{"selector": "input[type='checkbox']"}
```

#### `element_exists`
Check if element exists in DOM.
```json
{"selector": ".optional-element"}
```

#### `element_count`
Count elements matching selector.
```json
{"selector": ".list-item"}
```

### Storage & Cookies

#### `get_cookies`
Get all cookies or specific cookie.
```json
{"name": "session_id"}
```

#### `set_cookie`
Set a cookie.
```json
{
  "name": "user_preference",
  "value": "dark_mode",
  "domain": "example.com",
  "path": "/",
  "expires": 1735689600,
  "httpOnly": false,
  "secure": true,
  "sameSite": "Lax"
}
```

#### `delete_cookies`
Delete cookies.
```json
{"name": "session_id"}
```
Omit name to delete all cookies.

#### `get_local_storage`
Get localStorage item.
```json
{"key": "user_data"}
```

#### `set_local_storage`
Set localStorage item.
```json
{"key": "theme", "value": "dark"}
```

#### `clear_local_storage`
Clear all localStorage.
```json
{}
```

### Network & Requests

#### `set_extra_headers`
Set extra HTTP headers for all requests.
```json
{
  "headers": {
    "Authorization": "Bearer token123",
    "X-Custom-Header": "value"
  }
}
```

#### `block_resources`
Block specific resource types.
```json
{"types": ["image", "stylesheet", "font"]}
```
Types: document, stylesheet, image, media, font,