Browser Infrastructure quickstart

pip install --upgrade browser-use-sdk playwright

npm install browser-use-sdk@latest playwright

npm install browser-use-sdk@latest puppeteer-core

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

with BrowserUse() as client:
    session = client.browsers.create(proxy_country_code="us")
    try:
        if not session.cdp_url:
            raise RuntimeError("The browser did not return a CDP URL")
        with sync_playwright() as p:
            browser = p.chromium.connect_over_cdp(session.cdp_url)
            context = browser.contexts[0]
            page = context.pages[0] if context.pages else context.new_page()
            page.goto("https://example.com")
            print(page.title())
    finally:
        client.browsers.stop(session.id)

import { BrowserUse } from "browser-use-sdk/v4";
import { chromium } from "playwright";

const client = new BrowserUse();
const session = await client.browsers.create({ proxyCountryCode: "us" });
try {
  if (!session.cdpUrl) throw new Error("The browser did not return a CDP URL");
  const browser = await chromium.connectOverCDP(session.cdpUrl);
  try {
    const context = browser.contexts()[0];
    const page = context.pages()[0] ?? await context.newPage();
    await page.goto("https://example.com");
    console.log(await page.title());
  } finally {
    await browser.close();
  }
} finally {
  await client.browsers.stop(session.id);
}

import { BrowserUse } from "browser-use-sdk/v4";
import puppeteer from "puppeteer-core";

const client = new BrowserUse();
const session = await client.browsers.create({ proxyCountryCode: "us" });
try {
  if (!session.cdpUrl) throw new Error("The browser did not return a CDP URL");
  const browser = await puppeteer.connect({ browserWSEndpoint: session.cdpUrl });
  try {
    const context = browser.defaultBrowserContext();
    const page = (await context.pages())[0] ?? await context.newPage();
    await page.goto("https://example.com");
    console.log(await page.title());
  } finally {
    await browser.disconnect();
  }
} finally {
  await client.browsers.stop(session.id);
}

# Requires curl and jq. Run this in the shell used by your automation script.
browser=$(curl --fail-with-body -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 "$browser" | jq -er .id)
export BROWSER_USE_CDP_URL=$(echo "$browser" | jq -er .cdpUrl)

# Connect your Playwright or Puppeteer script to BROWSER_USE_CDP_URL.
# Keep this browser running until that script finishes, then stop it below.

browser = client.browsers.create(metadata={"customer": "acme", "env": "prod"})

const browser = await client.browsers.create({
  metadata: { customer: "acme", env: "prod" },
});

curl https://api.browser-use.com/api/v4/browsers \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"metadata": {"customer": "acme", "env": "prod"}}'