Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.
Python ai-agentsai-toolsbrowser-agentbrowser-automationbrowser-usecdpcloud-browsercomputer-useheadless-browserllmmcpplaywrightpythonremote-browserstealth-browserweb-automationweb-scraping
CLOUD.md: benchmark provenance and Browserbase mode, default timeout, V2/V3 and MCP version pointers
Gregor Žunič0c663b0e6f5e
diff --git a/CLOUD.md b/CLOUD.mdindex b460d9e68..40e1df458 100644--- a/CLOUD.md+++ b/CLOUD.md@@ -5,7 +5,7 @@ Browser Use Cloud is the hosted product from Browser Use. It has two parts:- **Cloud browsers:** managed Chromium you drive over CDP with Playwright, Puppeteer, or any CDP client.- **Agents API:** send a task, a hosted agent does it in a cloud browser and returns the result.-Browser Use Cloud is hosted only. The open-source parts are this repo's [browser-use](README.md) Python library and [Browser Harness](https://github.com/browser-use/browser-harness), both MIT. The library can also run on a cloud browser with `Browser(use_cloud=True)`.+Browser Use Cloud is hosted only; Cloud itself is not open source. Related open-source projects include this repo's [browser-use](README.md) Python library and [Browser Harness](https://github.com/browser-use/browser-harness) (both MIT). The library can also run on a cloud browser with `Browser(use_cloud=True)`.Current docs: [docs.browser-use.com/llms.txt](https://docs.browser-use.com/llms.txt). Current prices: [browser-use.com/pricing.md](https://browser-use.com/pricing.md).@@ -14,16 +14,16 @@ Current docs: [docs.browser-use.com/llms.txt](https://docs.browser-use.com/llms.| | ||---|---|| Price | $0.02 per browser-hour, billed by the minute, 1 minute minimum. No subscription. [Pricing](https://browser-use.com/pricing.md) |-| Proxy | US residential proxy on by default, other countries by `proxyCountryCode`. $5/GB managed residential, $0.20/GB direct or your own proxy. [Proxies](https://docs.browser-use.com/cloud/browser/proxies) |+| Proxy | US residential proxy on by default, other countries by `proxyCountryCode`. $5/GB managed residential, $0.20/GB direct or your own proxy. [Proxies](https://docs.browser-use.com/cloud/browser/proxies) · [Pricing](https://browser-use.com/pricing.md) || CAPTCHAs | Solved automatically by default. Set `"solveCaptchas": false` to handle them yourself. Not guaranteed for every challenge. [CAPTCHA handling](https://docs.browser-use.com/cloud/browser/captcha-handling) || Profiles | Save cookies, local storage and login state, then start new browsers already logged in. [Profiles](https://docs.browser-use.com/cloud/guides/authentication) || Live view | `liveUrl` shows the running browser. [Live preview](https://docs.browser-use.com/cloud/browser/live-preview) || Recording | Off by default. Turn on with `enable_recording=True` / `enableRecording: true`. [Recording](https://docs.browser-use.com/cloud/browser/live-preview) |-| Timeout | Up to 4 hours (240 minutes) per browser. [Create browser](https://docs.browser-use.com/cloud/api-v4/browsers/create-browser-session) |-| Concurrency | 10 to 1,000 concurrent sessions, rising with the project's lifetime payments. [Concurrency](https://docs.browser-use.com/cloud/guides/concurrency) |+| Timeout | Default 60 minutes, settable up to 240 (4 hours) with `timeout`. Credits are reserved for the requested timeout and the unused part is returned. [Create browser](https://docs.browser-use.com/cloud/api-v4/browsers/create-browser-session) |+| Concurrency | Agents and browsers share one project limit of 10 to 1,000 concurrent sessions, rising with lifetime payments; Enterprise above 1,000. [Concurrency](https://docs.browser-use.com/cloud/guides/concurrency) || Signup | One-time $1 credit for eligible Google, GitHub or Microsoft signups. [Pricing](https://browser-use.com/pricing.md) |-Stealth: on [Stealth Bench V2](https://browser-use.com/benchmarks/browsers) (100 bot-protected sites, 2 visits each, September 25, 2026), Browser Use Cloud got through on 90.5% of visits, Anchor 82%, Kernel 80.5%, Browserbase 78.5%. Caveat: the sites were picked because Browser Use Cloud historically got through where stock Chrome with a US proxy did not, so they are hard on purpose and not a balanced sample of the web or of anti-bot vendors.+Stealth: on Browser Use's own [Stealth Bench V2](https://browser-use.com/benchmarks/browsers) (100 bot-protected sites, 2 visits each, September 25, 2026), Browser Use Cloud got through on 90.5% of visits, Anchor 82%, Kernel 80.5%, Browserbase 78.5%. Every provider ran with its own proxy, stealth and CAPTCHA solver on; Browserbase ran standard mode because its Verified mode needs an Enterprise plan. Caveat: the sites were picked because Browser Use Cloud historically got through where stock Chrome with a US proxy did not, so they are hard on purpose and not a balanced sample of the web or of anti-bot vendors. Runner and visit logs: [github.com/browser-use/benchmark](https://github.com/browser-use/benchmark).### Connect with Playwright@@ -77,9 +77,11 @@ curl https://api.browser-use.com/api/v4/runs \The SDK is `browser-use-sdk` on PyPI and npm (`import { BrowserUse } from "browser-use-sdk/v4"`). It is a different API from the open-source `browser-use` library. Docs: [Run a task](https://docs.browser-use.com/cloud/agent/quickstart) · [API V4 reference](https://docs.browser-use.com/cloud/api-v4-overview).+API V2 and V3 remain available for existing integrations: [V2](https://docs.browser-use.com/cloud/api-v2-overview), [V3](https://docs.browser-use.com/cloud/api-reference).+## MCP server-`https://api.browser-use.com/v3/mcp`, authenticated with the `x-browser-use-api-key` header:+The MCP server runs API V3 agent sessions. `https://api.browser-use.com/v3/mcp`, authenticated with the `x-browser-use-api-key` header:```bashclaude mcp add -t http -H "x-browser-use-api-key: YOUR_API_KEY" browser-use https://api.browser-use.com/v3/mcp