Quick start

Run a hosted agent or launch a cloud browser.

Browser Use Agents

Give an agent a task and get the result.

Browser Infrastructure

Launch a cloud browser and connect to it from your code.

Both Cloud paths use API V4. Choose whether Browser Use drives the browser or your Playwright/Puppeteer code connects directly over CDP. For a local agent, use the open-source library.

Get an API key and export it:

export BROWSER_USE_API_KEY=your_key

Install the SDK

Skip this step if you use curl.

Python

pip install --upgrade browser-use-sdk playwright

Run Browser Use Agents

Python

from browser_use_sdk.v4 import BrowserUse

with BrowserUse() as client:
    run = client.runs.create("Find the top Hacker News story")
    result = client.runs.wait_for_completion(run.id)
    print(result.result)

Use Browser Infrastructure

Launch a browser, connect to its CDP URL, then stop it:

Python

from browser_use_sdk.v4 import BrowserUse
from playwright.sync_api import sync_playwright

client = BrowserUse()
browser = client.browsers.create(proxy_country_code="us")
print(browser.cdp_url)

with sync_playwright() as p:
    chrome = p.chromium.connect_over_cdp(browser.cdp_url)
    page = chrome.new_page()
    page.goto("https://example.com")
    print(page.title())

# When finished:
client.browsers.stop(browser.id)

Closing Playwright, Puppeteer, or CDP does not stop the browser. Use client.browsers.stop(browser.id) or call PATCH /api/v4/browsers/{id} with {"action":"stop"}.

Copy for an LLM

Give your coding agent the compact API V4 context.