Enable AI to control your browser 🤖
Deutsch | Español | français | 日本語 | 한국어 | Português | Русский | 中文
🤖 Quickstart
With uv (Python>=3.11):
# We ship every day - use the latest version!
uv pip install browser-use
Download chromium using playwright's shortcut:
uvx playwright install chromium --with-deps --no-shell
Create a .env file and add your API key. Don't have one? Start with a free Gemini key.
GEMINI_API_KEY=
Run your first agent:
from browser_use import Agent, ChatGoogle
from dotenv import load_dotenv
load_dotenv()
agent = Agent(
task="Find the number of stars of the browser-use repo",
llm=ChatGoogle(model="gemini-2.5-flash"),
# browser=Browser(use_cloud=True), # Uses Browser-Use cloud for the browser
)
agent.run_sync()
Check out the library docs and cloud docs for more settings.
Demos
Task: Add grocery items to cart, and checkout.
Prompt: Read my CV & find ML jobs, save them to a file, and then start applying for them in new tabs, if you need help, ask me.'
https://github.com/user-attachments/assets/171fb4d6-0355-46f2-863e-edb04a828d04
For more examples see the examples folder.
MCP Integration
Browser-use supports the Model Context Protocol (MCP), enabling integration with Claude Desktop and other MCP-compatible clients.
Use as MCP Server with Claude Desktop
Add browser-use to your Claude Desktop configuration: This gives Claude Desktop access to browser automation tools for web scraping, form filling, and more.
{
"mcpServers": {
"browser-use": {
"command": "uvx",
"args": ["browser-use[cli]", "--mcp"],
"env": {
"OPENAI_API_KEY": "sk-..."
}
}
}
}
See the MCP documentation for more details.