Quick start

pip install --upgrade browser-use-sdk playwright

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

from browser_use_sdk.v4 import BrowserUse

with BrowserUse() as client:
    run = client.runs.create("Find the top Hacker News story")
    result = client.runs.wait_for_completion(run.id)
    print(result.result)

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

const client = new BrowserUse();
const run = await client.runs.create({
  task: "Find the top Hacker News story",
});
const result = await client.runs.waitForCompletion(run.id);
console.log(result.result);

curl https://api.browser-use.com/api/v4/runs \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task":"Find the top Hacker News story"}'

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

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

with sync_playwright() as p:
    chrome = p.chromium.connect_over_cdp(browser.cdp_url)
    page = chrome.new_page()
    page.goto("https://example.com")
    print(page.title())

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

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

const client = new BrowserUse();
const browser = await client.browsers.create({ proxyCountryCode: "us" });
console.log(browser.cdpUrl);

const chrome = await puppeteer.connect({
  browserWSEndpoint: browser.cdpUrl,
});
const page = await chrome.newPage();
await page.goto("https://example.com");
console.log(await page.title());

// When finished:
await client.browsers.stop(browser.id);

browser=$(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 "$browser" | jq -r .id)
export BROWSER_USE_CDP_URL=$(echo "$browser" | jq -r .cdpUrl)

# Connect Playwright or Puppeteer to $BROWSER_USE_CDP_URL, then stop:
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"}'