Playwright, Puppeteer, Selenium

Control a Browser Use cloud browser directly over CDP.

Every browser runs in a hardened Chromium fork with stealth, anti-fingerprinting, and residential proxies enabled by default.

This page is for direct browser control. To give an AI agent a goal instead, create an API V4 run.

1. Create a browser

session=$(curl -sS https://api.browser-use.com/api/v4/browsers \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"proxyCountryCode":"us"}')

export BROWSER_SESSION_ID=$(echo "$session" | jq -r .id)
export BROWSER_USE_CDP_URL=$(echo "$session" | jq -r .cdpUrl)

2. Connect over CDP

Playwright

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())

Puppeteer

import puppeteer from "puppeteer-core";

const browser = await puppeteer.connect({
  browserWSEndpoint: process.env.BROWSER_USE_CDP_URL!,
});
const [page] = await browser.pages();
await page.goto("https://example.com");
console.log(await page.title());

Selenium

Selenium’s debugger_address only supports local host:port connections. Use Playwright or Puppeteer for remote CDP over WebSocket.

3. Stop the browser

curl -X PATCH \
  "https://api.browser-use.com/api/v4/browsers/$BROWSER_SESSION_ID" \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"stop"}'

browser.close() and disconnecting CDP do not stop the managed browser. Call PATCH /api/v4/browsers/{id} with {"action":"stop"}.

See Create browser session and Update browser session for every browser setting and response field.

PDF rendering

Standalone browser creation accepts "pdfRendererEnabled": false to disable Chrome’s in-tab PDF viewer. PDFs are still saved to the browser session’s download directory. This does not block PDF downloads or reduce their bytes to zero. The setting is not currently exposed in V4 agent browserSettings.

Profiles and browser contexts

To reuse a saved login, supply profileId when creating the browser and use the existing browser context shown above. Creating a fresh incognito context with new_context() / newContext() does not inherit that profile’s cookies. A profile is not a guarantee that the site’s login remains valid, and cookie sync does not import saved passwords or promise a persistent HTTP disk cache. See Sync local and cloud cookies.