Browser Infrastructure quickstart

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

Every browser includes stealth, proxies, live preview, and recording. Its CDP URL is a WebSocket endpoint for remotely controlling Chrome.

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

Launch a browser

The browser-management resource currently uses the explicit V3 SDK namespace. The equivalent REST endpoint is API V4.

Python

from browser_use_sdk.v3 import BrowserUse

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

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

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

Connect over CDP

Point Playwright or Puppeteer at the CDP URL. Nothing else changes in your code. The snippets read BROWSER_USE_CDP_URL; if you launched with the SDK above, pass browser.cdp_url / browser.cdpUrl instead of the variable.

Python

import os
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(os.environ["BROWSER_USE_CDP_URL"])
    page = browser.contexts[0].pages[0]
    page.goto("https://example.com")
    print(page.title())

Selenium cannot connect to a remote WebSocket CDP URL; use Playwright or Puppeteer. Stop the browser when you are done (see the warning above), and the session ends with a live preview and recording you can open from the dashboard.

Playwright, Puppeteer, Selenium

Full connection guide and stop semantics.

Browser settings

Configure proxies, screen size, recording, and timeout.