# Browser Use

> Documentation for Browser Use Cloud Agent and Browser APIs, and the separate open-source Python library.

> ## Agent Instructions
> Use https://docs.browser-use.com/llms.txt and its linked .md pages for current documentation. The managed full bundle is https://docs.browser-use.com/.well-known/llms-full.txt and can be cached for up to 24 hours. Do not use the obsolete /cloud/llms*.txt or /open-source/llms*.txt static exports.
> Choose Cloud API V4 for new agent integrations; V2 is the lower-cost option for simple tasks. Keep V3 examples explicitly versioned. The open-source browser-use library and hosted browser-use-sdk have different APIs.
> Cloud authentication uses X-Browser-Use-API-Key, without a Bearer prefix. Install or upgrade browser-use-sdk and use its explicit v4 import for V4. Check the published OpenAPI reference for request fields; do not invent SDK support for new fields.
> Cloud concurrency and HTTP request rate are separate. Read GET /api/v2/billing/account for the key’s projectId, concurrentSessionLimit, activeSessionCount, and credit balance, including when using V4. Keys in one project share capacity and credits; rateLimit is a legacy concurrency alias, not requests per second.
> Keep the highest applicable existing, legacy-plan, and spend-tier concurrency grant. Current spend tiers are 10 / 50 / 250 / 500 / 1000 at $0 / $200 / $1000 / $5000 / $25000 in qualifying project payments. Legacy or externally billed projects can follow different billing paths; trust the account limit. See https://docs.browser-use.com/cloud/guides/concurrency.md.
> Budget polling across the project: the standard general bucket is 25 requests/second, including V4 event reads and full run reads. Selected status reads have a separate higher bucket. Use bounded workers, stagger polls, respect Retry-After, and drain hasMore event pages after terminal status. A busy V4 session returns 409; its queue holds 10 pending messages and is not a project-wide batch queue.
> A completed run or closed CDP connection does not immediately stop its cloud browser. Stop unneeded owned browsers with PATCH /api/v4/browsers/{id} and {"action":"stop"}. A client wait timeout does not cancel the server-side run.
> Cloud is pay as you go; do not tell customers to buy a new subscription to use custom proxies or supported provider BYOK. Usage funding and model eligibility still apply. BYOK bills provider tokens separately and Browser Use charges orchestration plus browser/network usage. See https://docs.browser-use.com/cloud/guides/billing.md.
> Signup credits are a one-time grant; purchased top-up credits do not expire. Check the API key’s project before diagnosing missing credits. API-key monthly spending caps are soft limits, not a strict prepaid wallet; concurrent or already-running work can exceed them. Auto recharge has separate trigger and purchase amounts and can charge immediately when enabled below the threshold. Use https://browser-use.com/pricing for current rates.

## Docs

- [Quick start](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/quickstart.md): Run a hosted agent or launch a cloud browser.
- [Which Browser Use do I need?](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/which-product.md): Run Browser Use on your machine, run the full stack in our cloud, or bring your own agent and use only the hosted browser.
- [Choosing an Agent](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/choosing-an-agent.md): Compare Browser Use Cloud agents on accuracy, speed and price, and pick the right one for your task.
- [Prompt for Vibecoders](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/vibecoding.md): Current Cloud documentation, API schemas, concurrency, and billing guidance for AI coding agents.
- [Run a task](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/agent/quickstart.md): Give a high-accuracy browser agent a goal and get the result.
- [Models](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/agent/models.md): Choose a V4 model and understand its token pricing.
- [Thinking levels](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/agent/thinking-levels.md): Configure model reasoning depth across API V2, V3, and V4.
- [Structured output](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/agent/structured-output.md): Ask for JSON and validate the V4 result in your application.
- [Sessions](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/agent/sessions.md): Continue one conversation across multiple V4 runs.
- [Workspaces & files](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/agent/workspaces.md): Persist files across V4 runs and conversations.
- [Rerunnable scripts](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/agent/scripts.md): Save a Browser Use task as a rerunnable script for repeated live data extraction and self-healing runs.
- [Human in the loop](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/agent/human-in-the-loop.md): Open the live browser, take over, then continue the same session.
- [Observability](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/agent/observability.md): Poll ordered V4 events to monitor a run or build a custom UI.
- [Browser Infrastructure quickstart](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/browser/quickstart.md): Launch a cloud browser and connect to it from your code.
- [Stealth](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/browser/stealth.md): Best stealth on the planet. We fork Chromium to give agents access to all websites.
- [CAPTCHA handling](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/browser/captcha-handling.md): Cloud browsers solve supported CAPTCHA challenges automatically.
- [Proxies](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/browser/proxies.md): Configure residential or custom proxies for API V4 browsers and agent runs.
- [Live preview & recording](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/browser/live-preview.md): Watch an API V4 run in real time or record its browser.
- [Playwright, Puppeteer, Selenium](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/browser/playwright-puppeteer-selenium.md): Control a Browser Use cloud browser directly over CDP.
- [Profiles](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/guides/authentication.md): Reuse cookies and browser state in API V4 runs.
- [Sync local and cloud cookies](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/guides/profile-sync.md): Sync a local login, then use it in an API V4 run.
- [2FA](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/guides/2fa.md): Handle two-factor authentication in API V4 runs.
- [1Password & 2FA](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/guides/1password.md): Auto-fill passwords and TOTP codes from 1Password in API tasks.
- [Secrets](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/guides/secrets.md): Pass domain-scoped credentials to the agent securely.
- [Claude Code](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/tutorials/integrations/claude-code.md): Give Claude Code cloud browser automation with Browser Use.
- [Claude Managed Agents](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/tutorials/integrations/claude-managed-agents.md): Give Anthropic's Claude Managed Agents a stealth cloud browser via the Browser Use CLI.
- [OpenClaw](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/tutorials/integrations/openclaw.md): Give OpenClaw agents browser automation with Browser Use — via CDP or the CLI skill.
- [Hermes Agent](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/tutorials/integrations/hermes-agent.md): Give Hermes Agent cloud browser automation with Browser Use.
- [MCP Server](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/guides/mcp-server.md): Run browser automation tasks from your AI coding assistant. Connect to Claude, Cursor, Windsurf, or any MCP client.
- [Webhooks](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/guides/webhooks.md): Receive V2 task and V3 session notifications and verify the webhook signature.
- [x402 (pay-per-request)](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/guides/x402.md): Pay for Browser Use Cloud with crypto (USDC on Base). ~30 seconds from wallet to first request.
- [x402 agent wallets](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/guides/x402-agent-wallets.md): Pay for Browser Use Cloud from an agent-native wallet: AgentCash (local wallet, MCP) or Coinbase's Agentic Wallet (hosted wallet, CLI).
- [Get a Browser Use API Key](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/agent-signup.md): Agent signup is off. Create an API key in Cloud, or use x402 without a human.
- [Concurrency and limits](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/guides/concurrency.md): Preserved legacy allowances, spend tiers, browser lifetime, polling budgets, queues, and retry guidance.
- [Billing and credits](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/guides/billing.md): Pay-as-you-go credits, project balances, BYOK charges, auto recharge, and API-key spending caps.
- [FAQ](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/faq.md): Common questions and solutions.
- [Agent (v2)](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/legacy/agent.md): V2 agent models and file handling.
- [Public share links (v2)](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/legacy/public-share.md): Generate shareable URLs for agent sessions using the v2 API.
- [Skills](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/legacy/skills.md): Retired. Existing skills still run; new skills are no longer created.
- [API Reference](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/api-v4-overview.md): Authenticate and start using the Browser Use API v4 — the current REST API for long-horizon agents.
- [API Reference](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/api-reference.md): Authenticate and start using the Browser Use REST API.
- [n8n](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/tutorials/integrations/n8n.md): Use Browser Use as an HTTP node in n8n workflows.
- [Chat UI](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/tutorials/chat-ui.md): Full end-to-end example. Build a chat UI with live browser preview, follow-up tasks, recording, and streaming messages.
- [Grow Therapy provider search](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/tutorials/grow-therapy-compare.md): Search Grow Therapy for therapists by location, insurance, and specialty — with cached reruns.
- [API key](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/cloud/api-v2-overview.md): Set your API key to access the Browser Use v2 REST API.
- [Browser Use Open Source](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/introduction.md): Python library for AI browser automation with 79k+ GitHub stars. Connect any LLM and run locally or self-hosted.
- [Human Quickstart](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/quickstart.md): Install and run your first AI browser agent in minutes. Python setup with pip, environment variables, and a working example.
- [Prompts for Vibecoders](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/vibecoding.md): Complete Python SDK reference for AI coding agents. Paste into Claude Code, Cursor, or Copilot for instant integration.
- [Supported Models](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/supported-models.md): Choose between Claude, Gemini, Llama, DeepSeek, and more. Configuration examples for each provider.
- [Browser Use CLI](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/browser-use-cli.md): Direct browser control for coding agents.
- [Browser Use Terminal](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/browser-use-terminal.md): Use the terminal app for browser agents, or use the same runtime from Python.
- [Configuration](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/customize/agent/basics.md): Configure the agent — set your LLM, define tasks, add custom tools, and control behavior with Python.
- [Prompting Guide](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/customize/agent/prompting-guide.md): Write effective prompts for the agent. Tips for task descriptions, multi-step workflows, and getting reliable structured output.
- [Output Format](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/customize/agent/output-format.md): Control agent output — structured results, step history, action logs, and extracted content from browser automation tasks.
- [All Parameters](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/customize/agent/all-parameters.md): Complete reference for all agent configuration options — LLM settings, prompts, tools, output format, and callbacks.
- [Configuration](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/customize/browser/basics.md): Configure the browser instance — headless mode, viewport size, proxy settings, and Playwright launch options.
- [Authentication](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/customize/browser/authentication.md): Log into websites using real browser profiles, saved storage state, and 2FA codes for authenticated automation.
- [Real Browser](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/customize/browser/real-browser.md): Connect to your existing Chrome browser to preserve login sessions, cookies, and extensions for authenticated tasks.
- [Remote Browser](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/customize/browser/remote.md): Connect to remote browsers via CDP — use with the Cloud, Browserbase, or any remote Chrome instance.
- [All Parameters](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/customize/browser/all-parameters.md): Complete reference for all browser configuration options — launch args, proxy, viewport, user data, and CDP settings.
- [Overview](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/customize/tools/basics.md): Learn about built-in browser actions and custom tools.
- [Available Tools](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/customize/tools/available.md): Built-in tools — click, type, scroll, extract, navigate, and more. Full list of default agent actions.
- [Add Tools](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/customize/tools/add.md): Extend agents with custom Python functions. Add API calls, file operations, or any custom logic as agent tools.
- [Remove Tools](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/customize/tools/remove.md): Exclude default tools to restrict agent capabilities.
- [Response Format](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/customize/tools/response.md): Customize how tools return data to the agent. Control response formatting, extraction, and content filtering.
- [MCP Server](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/customize/integrations/mcp-server.md): Run browser-use as a local Model Context Protocol server. Connect AI models to browser automation through the MCP standard.
- [Basics](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/legacy/actor/basics.md): Low-level Playwright-like browser automation with direct and full CDP control and precise element interactions
- [Examples](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/legacy/actor/examples.md): Comprehensive examples for Browser Actor automation tasks including forms, JavaScript, mouse operations, and AI features
- [All Parameters](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/legacy/actor/all-parameters.md): Complete API reference for Browser Actor classes, methods, and parameters including BrowserSession, Page, Element, and Mouse
- [Quickstart](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/legacy/sandbox/quickstart.md): Run browser automation in the cloud
- [Events](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/legacy/sandbox/events.md): Monitor execution with callbacks
- [All Parameters](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/legacy/sandbox/all-parameters.md): Sandbox configuration reference
- [Fast Agent](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/templates/fast-agent.md): Optimize agent performance for maximum speed and efficiency.
- [Follow up tasks](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/templates/follow-up-tasks.md): Follow up tasks with the same browser session.
- [Parallel Agents](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/templates/parallel-browser.md): Run multiple agents in parallel with separate browser instances
- [Playwright Integration](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/templates/playwright-integration.md): Advanced example showing Playwright and Browser-Use working together
- [Sensitive Data](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/templates/sensitive-data.md): Handle secret information securely and avoid sending PII & passwords to the LLM.
- [Secure Setup](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/templates/secure.md): Azure OpenAI with data privacy and security configuration.
- [More Examples](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/templates/more-examples.md): Explore additional examples and use cases on GitHub.
- [Ad-Use (Ad Generator)](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/apps/ad-use.md): Generate Instagram image ads and TikTok video ads from landing pages using browser agents, Google's Nano Banana 🍌, and Veo3.
- [Vibetest-Use (Automated QA)](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/apps/vibetest-use.md): Run multi-agent Browser-Use tests to catch UI bugs, broken links, and accessibility issues before they ship.
- [News-Use (News Monitor)](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/apps/news-use.md): Monitor news websites and extract articles with sentiment analysis using browser agents and Google Gemini.
- [Msg-Use (WhatsApp Sender)](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/apps/msg-use.md): AI-powered WhatsApp message scheduler using browser agents and Gemini. Schedule personalized messages in natural language.
- [Overview](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/skills/overview.md): Install Browser Use as an agent skill. Drop browser automation, cloud, QA, and payments into Claude Code, Cursor, and any agent that supports SKILL.md.
- [browser-use](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/skills/browser-use.md): Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the agent needs to navigate websites, interact with web pages, fill forms, take screenshots, or extract information.
- [cloud](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/skills/cloud.md): Documentation reference for using Browser Use Cloud — the hosted API and SDK for browser automation.
- [open-source](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/skills/open-source.md): Documentation reference for writing Python code using the browser-use open-source library.
- [qa](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/skills/qa.md): QA-test a website or web app and return a 1–5 quality score (5 = flawless, 1 = broken) with evidence.
- [remote-browser](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/skills/remote-browser.md): Controls a local browser from a sandboxed remote machine. Use when the agent runs in a sandbox (no GUI) and needs to navigate, interact, screenshot, or expose local dev servers via tunnels.
- [x402](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/examples/skills/x402.md): Set up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
- [Local Development Setup](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/development/setup/local-setup.md): Set up for local development. Clone the repo, install dependencies, and run tests to start contributing.
- [Contribution Guide](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/development/setup/contribution-guide.md): How to contribute — code standards, PR process, testing requirements, and submitting your first pull request.
- [Lifecycle Hooks](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/customize/hooks.md): Hook into agent lifecycle events — before/after actions, navigation, extraction, and error handling callbacks.
- [Observability](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/development/monitoring/observability.md): Trace agent execution steps and capture browser session recordings.
- [OpenLIT](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/development/monitoring/openlit.md): Complete observability with OpenLIT tracing.
- [Telemetry](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/development/monitoring/telemetry.md): Understanding Browser Use's telemetry
- [Costs](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/development/monitoring/costs.md): Track token usage and API costs for your browser automation tasks
- [Get Help](https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/open-source/development/get-help.md): Get help — join 20k+ developers on Discord, search GitHub issues, or ask the community.