browser-use

# Browser Use Browser Use provides cloud browsers and autonomous browser automation via API. **Docs:** - Open source library: https://docs.browser-use.com - Cloud API: https://docs.cloud.browser-use.com ## Setup **API Key** is read from clawdbot config at `skills.entries.browser-use.apiKey`. If not configured, tell the user: > To use Browser Use, you need an API key. Get one at https://cloud.browser-use.com (new signups get $10 free credit). Then configure it: > ``` > clawdbot config set skills.entries.browser-use.apiKey "bu_your_key_here" > ``` Base URL: `https://api.browser-use.com/api/v2` All requests need header: `X-Browser-Use-API-Key: <apiKey>` --- ## 1. Browser Sessions (Primary) Spin up cloud browsers for Clawdbot to control directly. Use profiles to persist logins and cookies. ### Create browser session ```bash # With profile (recommended - keeps you logged in) curl -X POST "https://api.browser-use.com/api/v2/browsers" \ -H "X-Browser-Use-API-Key: $API_KEY" \ -H "Content-Type: application/json" \ -d '{"profileId": "<profile-uuid>", "timeout": 60}' # Without profile (fresh browser) curl -X POST "https://api.browser-use.com/api/v2/browsers" \ -H "X-Browser-Use-API-Key: $API_KEY" \ -H "Content-Type: application/json" \ -d '{"timeout": 60}' ``` **Response:** ```json { "id": "session-uuid", "cdpUrl": "https://<id>.cdp2.browser-use.com", "liveUrl": "https://...", "status": "active" } ``` ### Connect Clawdbot to the browser ```bash gateway config.patch '{"browser":{"profiles":{"browseruse":{"cdpUrl":"<cdpUrl-from-response>"}}}}' ``` Now use the `browser` tool with `profile=browseruse` to control it. ### List/stop browser sessions ```bash # List active sessions curl "https://api.browser-use.com/api/v2/browsers" -H "X-Browser-Use-API-Key: $API_KEY" # Get session status curl "https://api.browser-use.com/api/v2/browsers/<session-id>" -H "X-Browser-Use-API-Key: $API_KEY" # Stop session (unused time is refunded) curl -X PATCH "https://api.browser-use.com/api/v2/browsers/<session-id>" \ -H "X-Browser-Use-API-Key: $API_KEY" \ -H "Content-Type: application/json" \ -d '{"status": "stopped"}' ``` **Pricing:** $0.06/hour (Pay As You Go) or $0.03/hour (Business). Max 4 hours per session. Billed per minute, refunded for unused time. --- ## 2. Profiles Profiles persist cookies and login state across browser sessions. Create one, log into your accounts in the browser, and reuse it. ```bash # List profiles curl "https://api.browser-use.com/api/v2/profiles" -H "X-Browser-Use-API-Key: $API_KEY" # Create profile curl -X POST "https://api.browser-use.com/api/v2/profiles" \ -H "X-Browser-Use-API-Key: $API_KEY" \ -H "Content-Type: application/json" \ -d '{"name": "My Profile"}' # Delete profile curl -X DELETE "https://api.browser-use.com/api/v2/profiles/<profile-id>" \ -H "X-Browser-Use-API-Key: $API_KEY" ``` **Tip:** You can also sync cookies from your local Chrome using the Browser Use Chrome extension. --- ## 3. Tasks (Subagent) Run autonomous browser tasks - like a subagent that handles browser interactions for you. Give it a prompt and it completes the task. **Always use `browser-use-llm`** - optimized for browser tasks, 3-5x faster than other models. ```bash curl -X POST "https://api.browser-use.com/api/v2/tasks" \ -H "X-Browser-Use-API-Key: $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "task": "Go to amazon.com and find the price of the MacBook Air M3", "llm": "browser-use-llm" }' ``` ### Poll for completion ```bash curl "https://api.browser-use.com/api/v2/tasks/<task-id>" -H "X-Browser-Use-API-Key: $API_KEY" ``` **Response:** ```json { "status": "finished", "output": "The MacBook Air M3 is priced at $1,099", "isSuccess": true, "cost": "0.02" } ``` Status values: `pending`, `running`, `finished`, `failed`, `stopped` ### Task options | Option | Description | |--------|-------------| | `task` | Your prompt (required) | | `llm` | Always use `browser-use-llm` | | `startUrl` | Starting page | | `maxSteps` | Max actions (default 100) | | `sessionId` | Reuse existing session | | `profileId` | Use a profile for auth | | `flashMode` | Even faster execution | | `vision` | Visual understanding | --- ## Full API Reference See [references/api.md](references/api.md) for all endpoints including Sessions, Files, Skills, and Skills Marketplace.