Quick start

pip install browser-use-sdk
# In a managed environment (Debian/Docker "externally-managed-environment", PEP 668),
# use a venv: python3 -m venv .venv && source .venv/bin/activate && pip install browser-use-sdk
# or: uv pip install browser-use-sdk

npm install browser-use-sdk

import asyncio
from browser_use_sdk.v3 import AsyncBrowserUse

async def main():
    client = AsyncBrowserUse()
    result = await client.run("List the top 20 posts on Hacker News today with their points")
    print(result.output)

asyncio.run(main())

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

const client = new BrowserUse();
const result = await client.run("List the top 20 posts on Hacker News today with their points");
console.log(result.output);

import asyncio
from browser_use_sdk.v3 import AsyncBrowserUse
from playwright.async_api import async_playwright

async def main():
    client = AsyncBrowserUse()
    browser = await client.browsers.create()
    print(browser.cdp_url)   # CDP endpoint for Playwright/Puppeteer/Selenium
    print(browser.live_url)  # watch the session in a browser tab

    async with async_playwright() as p:
        pw = await p.chromium.connect_over_cdp(browser.cdp_url)
        page = pw.contexts[0].pages[0]
        await page.goto("https://news.ycombinator.com")
        titles = await page.locator(".titleline > a").all_inner_texts()
        print(titles[:5])
        await pw.close()

    await client.browsers.stop(browser.id)

asyncio.run(main())

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

const client = new BrowserUse();
const browser = await client.browsers.create();
console.log(browser.cdpUrl);  // CDP endpoint for Playwright/Puppeteer/Selenium
console.log(browser.liveUrl); // watch the session in a browser tab

const pw = await chromium.connectOverCDP(browser.cdpUrl);
const page = pw.contexts()[0].pages()[0];
await page.goto("https://news.ycombinator.com");
const titles = await page.locator(".titleline > a").allInnerTexts();
console.log(titles.slice(0, 5));
await pw.close();

await client.browsers.stop(browser.id);