browser-use

pip install browser-use
playwright install chromium

# browse.py — AI agent that browses the web
from browser_use import Agent
from langchain_openai import ChatOpenAI

agent = Agent(
    task="Go to github.com/trending and find the top 3 Python repositories today. Return their names, descriptions, and star counts.",
    llm=ChatOpenAI(model="gpt-4o"),
)

result = await agent.run()
print(result)

# task.py — Complex multi-step web task
from browser_use import Agent
from langchain_anthropic import ChatAnthropic

agent = Agent(
    task="""
    1. Go to news.ycombinator.com
    2. Find the top 5 stories about AI
    3. For each story, click through and summarize the article in 2 sentences
    4. Return a structured list with: title, URL, summary, points
    """,
    llm=ChatAnthropic(model="claude-sonnet-4-20250514"),
    max_steps=50,  # Maximum actions the agent can take
)

result = await agent.run()

# controlled.py — Custom browser settings and hooks
from browser_use import Agent, Controller, Browser, BrowserConfig

# Custom browser config
browser = Browser(config=BrowserConfig(
    headless=True,
    disable_security=False,
    extra_chromium_args=["--disable-blink-features=AutomationControlled"],
))

# Controller with action hooks
controller = Controller()

@controller.action("Save extracted data to file")
def save_data(data: str, filename: str):
    with open(filename, "w") as f:
        f.write(data)
    return f"Saved to {filename}"

agent = Agent(
    task="Find the latest Python release version from python.org and save it to version.txt",
    llm=ChatOpenAI(model="gpt-4o"),
    browser=browser,
    controller=controller,
)

result = await agent.run()

# extract.py — Extract structured data from websites
from browser_use import Agent
from pydantic import BaseModel

class Product(BaseModel):
    name: str
    price: float
    rating: float
    url: str

agent = Agent(
    task="""
    Go to amazon.com and search for "mechanical keyboard".
    Extract the first 5 results with name, price, rating, and URL.
    Return as JSON.
    """,
    llm=ChatOpenAI(model="gpt-4o"),
)

result = await agent.run()
# Parse result into Product models

# form.py — Fill out web forms
agent = Agent(
    task="""
    Go to the job application page at https://careers.example.com/apply.
    Fill in the form with:
    - Name: Test User
    - Email: test@example.com
    - Position: Senior Developer
    - Experience: 5 years
    - Cover letter: "I am excited to join your team..."
    Do NOT submit the form. Just fill it in and take a screenshot.
    """,
    llm=ChatOpenAI(model="gpt-4o"),
    save_conversation_path="./logs/",
)

result = await agent.run()