Browser Infrastructure quickstart

Control hosted cloud browser infrastructure for AI agents through the SDK, REST, or CDP.

Browser Infrastructure is hosted cloud browser infrastructure for AI agents, controlled through the SDK, REST, or CDP. A browser’s 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 examples use the V3 SDK browser resource and the V4 REST browser endpoint. See the developer overview when choosing an interface for a new integration.

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

Use the CDP URL with Playwright or Puppeteer.

Browser settings

Configure proxies, screen size, recording, and timeout.