Overview

The agent is a hosted loop: it reads the page, decides an action, executes it, and repeats until the task is complete. You send a task, you get a result.

from browser_use_sdk import BrowserUse

client = BrowserUse()
result = client.run("List the top 5 posts on Hacker News with their points")
print(result.output)

Each run gets its own stealth cloud browser with proxies and CAPTCHA handling already on. No browser management, no selectors, no waiting logic.

When to use the agent

The agent fits tasks where you care about the outcome, not the exact clicks: data extraction from sites that change layout, workflows across several pages, form submission, or anything you’d rather describe than script. If you need pixel-exact control or deterministic repetition, drive a browser session directly instead, or record an agent run once and replay it with cache scripts.

What the agent can do

Structured output — get results as typed JSON matching your schema
Follow-up tasks — continue in the same browser with context intact
Streaming — watch steps as they happen
Workspaces — files the agent reads and writes during a run
Human-in-the-loop — take over the browser mid-task, then hand back
Models — pick the LLM that drives the loop
Cache scripts — record a run, replay it without LLM calls

Start with the agent quickstart.

Get Started

Pillars

More

When to use the agent

What the agent can do

Next

​When to use the agent

​What the agent can do

​Next

When to use the agent

What the agent can do

Next