Examples

from pydantic import BaseModel

from browser_use import Agent


class Story(BaseModel):
    title: str
    url: str
    points: int


class Stories(BaseModel):
    stories: list[Story]


agent = Agent('Open https://news.ycombinator.com and return the top 5 stories', output_model_schema=Stories)
result = agent.run_sync()
if result.structured_output is None:
    raise SystemExit(f'{result.status}: {result.error}')
for story in result.structured_output.stories:
    print(story.points, story.title, story.url)

196 Goldman Sachs Is Pulling Claude Code from Its Bankers and Traders https://www.thestateofai.com/...
8 Outlook.com Is Quietly Rejecting Email from Domains Without DMARC https://mailroute.net/...
...

from browser_use import Agent

task = """Open https://httpbin.org/forms/post and submit the form with:
customer name Ada Lovelace, telephone 555-0100, email ada@example.com,
a large pizza with bacon and mushroom, delivery time 19:30, instructions "Ring twice".
Return the JSON the page shows after submitting."""

result = Agent(task).run_sync()
print(result.final_result())

{ ..., "form": { "comments": "Ring twice", "custemail": "ada@example.com", "custname": "Ada Lovelace",
  "custtel": "555-0100", "delivery": "19:30", "size": "large", "topping": ["bacon", "mushroom"] } }

import os

from browser_use import Agent

agent = Agent(
    'Log in on https://the-internet.herokuapp.com/login, then return the message the page shows',
    sensitive_data={
        # typed only on this site; the model sees the names, never the values
        'the-internet.herokuapp.com': {
            'username': os.environ.get('APP_USER', 'tomsmith'),
            'password': os.environ.get('APP_PASSWORD', 'SuperSecretPassword!'),
        },
    },
)
print(agent.run_sync().final_result())

You logged into a secure area!

import asyncio

from browser_use import Agent, Browser


async def main():
    sites = ['https://example.com', 'https://www.python.org', 'https://news.ycombinator.com']
    agents = [Agent(f'Return the page title of {url}', browser=Browser()) for url in sites]  # one browser each
    results = await asyncio.gather(*(agent.run(max_steps=10) for agent in agents))
    for url, result in zip(sites, results):
        print(url, '->', result.final_result())


asyncio.run(main())

https://example.com -> Example Domain
https://www.python.org -> Welcome to Python.org
https://news.ycombinator.com -> Hacker News

import tempfile
from pathlib import Path

from browser_use import Agent, Browser

workspace = Path(tempfile.mkdtemp())
(workspace / 'invoice.txt').write_text('Invoice 42: 3 widgets')

agent = Agent(
    'Upload invoice.txt on https://the-internet.herokuapp.com/upload and note the file name the page confirms. '
    'Then download any one .txt file from https://the-internet.herokuapp.com/download.',
    workspace=workspace,
    browser=Browser('chromium'),
)
result = agent.run_sync()
print(result.final_result())
print('downloaded:', result.downloads)  # files in workspace/downloads

Upload confirmed: invoice.txt. Download completed: HUH.txt.
downloaded: [PosixPath('/tmp/tmpnwb43_ht/downloads/HUH.txt')]

import sqlite3

from browser_use import Agent, Tools

db = sqlite3.connect('jobs.db')
db.execute('CREATE TABLE IF NOT EXISTS jobs (title TEXT, url TEXT)')
tools = Tools()


@tools.action('Save one job posting to our database')
async def save_job(title: str, url: str) -> str:
    db.execute('INSERT INTO jobs VALUES (?, ?)', (title, url))
    db.commit()
    return f'saved: {title}'


agent = Agent('Open https://news.ycombinator.com/jobs and save the first 3 job postings with save_job', tools=tools)
print(agent.run_sync().final_result())
print(db.execute('SELECT title FROM jobs').fetchall())

Saved the first 3 Hacker News job postings: UpCodes, Mbodi AI, and Bild AI.
[("UpCodes (YC S17) is hiring SDR's to sell AI compliance software",), ('Mbodi AI (YC P25) Is Hiring Research and Robotic Engineers',), ...]

from browser_use import Agent, Browser

browser = Browser(
    cloud_proxy_country_code='de',  # residential proxy in Germany
    cloud_timeout=10,  # minutes; the server stops the browser after this
)
agent = Agent('Open https://ipinfo.io/json and return the country and city it shows', browser=browser)
print(agent.run_sync().final_result())

Country: Germany (DE)
City: Duisburg

import asyncio
import tempfile

from playwright.async_api import async_playwright

from browser_use import Agent, Browser


async def main():
    async with async_playwright() as p:
        # a persistent context: Playwright's pages and the agent's tabs share cookies
        context = await p.chromium.launch_persistent_context(
            tempfile.mkdtemp(), headless=True, args=['--remote-debugging-port=9242']
        )
        page = context.pages[0]
        await page.goto('https://the-internet.herokuapp.com/login')  # the scripted part
        await page.fill('#username', 'tomsmith')
        await page.fill('#password', 'SuperSecretPassword!')
        await page.click('button[type=submit]')
        await page.wait_for_url('**/secure')

        agent = Agent(  # the part that needs judgment
            'Open https://the-internet.herokuapp.com/secure and return the heading and the message it shows',
            browser=Browser(cdp_url='http://127.0.0.1:9242'),
        )
        result = await agent.run()
        print(result.final_result())
        await context.close()


asyncio.run(main())

Heading: Secure Area
Message: Welcome to the Secure Area. When you are done click logout below.