Get Started

BrowserWorker lets you remotely automate real browsers via API using Chrome Extensions. Send HTTP requests to control browsers — click buttons, fill forms, upload files, take screenshots, and more.

How It Works

Your App / n8n / cURL
    ↓ POST /v1/ (Bearer Token)
BrowserWorker API Server
    ↓ Dispatches task to worker
Chrome Extension (on any PC)
    ↓ Executes actions in real browser
    ↓ Returns result
API Server → Your App

Quick Start

1. Create an Account

Sign up at my.browserworker.app using Google Sign-in or email/password.

2. Install the Chrome Extension

1. Download the BrowserWorker Chrome Extension
2. Open chrome://extensions/ and enable Developer Mode
3. Load the extension

3. Connect a Worker

1. In the dashboard, copy your Worker API Key
2. Open the extension popup and paste the key
3. Enter a worker name (e.g., "My PC")
4. Click Register

Your worker should now appear as online in the dashboard.

4. Get Your Bearer Token

In the dashboard, find your Bearer Token under the API section. This is used to authenticate API requests.

5. Send Your First Request

curl -X POST https://api.browserworker.app/v1/ \
  -H "Authorization: Bearer YOUR_BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "actions": [
      { "openNewTab": "https://example.com" },
      { "screenshot": "viewport" }
    ]
  }'

Response

{
  "success": true,
  "taskId": "task_abc123_1711234567",
  "workerId": "-Om8E6V_dV3w8mb27ikb",
  "workerName": "My PC",
  "data": {
    "success": true,
    "url": "https://files.browserworker.app/screenshots/..."
  },
  "duration": 3200
}

Example: Fill a Form and Submit

curl -X POST https://api.browserworker.app/v1/ \
  -H "Authorization: Bearer YOUR_BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "actions": [
      { "openNewTab": "https://example.com/login" },
      { "fill": ["input[name=email]", "user@example.com"] },
      { "fill": ["input[name=password]", "mypassword"] },
      { "click": "button[type=submit]" },
      { "waitForElement": ".dashboard" },
      { "screenshot": "viewport" }
    ],
    "timeout": 30000
  }'

Example: Extract Data from a Page

curl -X POST https://api.browserworker.app/v1/ \
  -H "Authorization: Bearer YOUR_BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "actions": [
      { "openNewTab": "https://example.com/products" },
      { "waitForElement": ".product-card" },
      {
        "extractAll": ".product-card",
        "options": {
          "fieldMap": {
            "title": "h3",
            "price": ".price",
            "link": ["a", "href"]
          },
          "save": "products"
        }
      },
      { "getSavedData": ["products"] }
    ]
  }'

What's Next?

• How It Works — Understand the architecture
• API Reference — Full request/response documentation
• Actions — All 37 supported browser actions
• Configuration — Timeouts, error handling, and more