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

import { chromium } from "playwright";

const browser = await chromium.connectOverCDP(
  process.env.BROWSER_USE_CDP_URL!,
);
const page = browser.contexts()[0].pages()[0];
await page.goto("https://example.com");
console.log(await 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.