Proxies & Stealth

Configure anti-detect browsers with CAPTCHA solving and residential proxies in 195+ countries.

Stealth by default

Every Browser Use Cloud session runs on stealth infrastructure. No configuration needed.

• Anti-detect browser fingerprinting — undetectable as automation
• Automatic CAPTCHA solving — CAPTCHAs are handled transparently
• Ad and cookie banner blocking — clean pages, faster execution
• Cloudflare / anti-bot bypass — works on protected sites

Stealth is always on. You do not need to configure anything. If you are searching for “captcha” — it is handled automatically.

Country proxies

A US residential proxy is always active by default — no configuration needed. To route through a different country, set proxyCountryCode on the session or inline via sessionSettings.

Python

from browser_use_sdk import AsyncBrowserUse

client = AsyncBrowserUse()

# Via session — US proxy is the default, override to route through Germany
session = await client.sessions.create(proxy_country_code="de")
result = await client.run("Get the price of iPhone 16 on amazon.de", session_id=session.id)

# Or inline via session_settings (auto-creates session)
result = await client.run(
    "Get the price of iPhone 16 on amazon.de",
    session_settings={"proxyCountryCode": "de"},
)

import { BrowserUse } from "browser-use-sdk";

const client = new BrowserUse();

// Via session — US proxy is the default, override to route through Germany
const session = await client.sessions.create({ proxyCountryCode: "de" });
const result = await client.run("Get the price of iPhone 16 on amazon.de", {
  sessionId: session.id,
});

// Or inline
const result = await client.run("Get the price of iPhone 16 on amazon.de", {
  sessionSettings: { proxyCountryCode: "de" },
});

Common country codes: us, gb, de, fr, jp, au, br, in, kr, ca, es, it, nl, se, sg.

The default is always us. This applies to auto-sessions (run() without a session_id), manually created sessions, and browser sessions — unless you explicitly set a different country code.

Custom proxy

Bring your own proxy server (HTTP or SOCKS5).

Python

from browser_use_sdk import AsyncBrowserUse, CustomProxy

client = AsyncBrowserUse()
session = await client.sessions.create(
    custom_proxy=CustomProxy(
        url="http://proxy.example.com:8080",
        username="user",
        password="pass",
    ),
)

import { BrowserUse } from "browser-use-sdk";

const client = new BrowserUse();
const session = await client.sessions.create({
  customProxy: {
    url: "http://proxy.example.com:8080",
    username: "user",
    password: "pass",
  },
});

Proxy is a session-level setting. All tasks in the same session use the same proxy. See Models & Pricing for proxy costs.

Disabling proxies

Only disable proxies for localhost testing or sites that allowlist your server IP. They reduce blocks and fingerprinting.

To disable the built-in proxy, set proxyCountryCode to null on sessions, tasks (via sessionSettings), or browser sessions.

Python

from browser_use_sdk import AsyncBrowserUse, SessionSettings

client = AsyncBrowserUse()

# Session — no proxy
session = await client.sessions.create(proxy_country_code=None)

# Task with inline session settings — no proxy
result = await client.run(
    "Go to http://localhost:3000 and check the homepage",
    session_settings=SessionSettings(proxy_country_code=None),
)

# Browser session — no proxy
browser = await client.browsers.create(proxy_country_code=None)

import { BrowserUse } from "browser-use-sdk";

const client = new BrowserUse();

// Session — no proxy
const session = await client.sessions.create({ proxyCountryCode: null });

// Task with inline session settings — no proxy
const result = await client.run("Go to http://localhost:3000 and check the homepage", {
  sessionSettings: { proxyCountryCode: null },
});

// Browser session — no proxy
const browser = await client.browsers.create({ proxyCountryCode: null });

For the V3 API:

Python

from browser_use_sdk.v3 import AsyncBrowserUse

client = AsyncBrowserUse()
result = await client.run(
    "Go to http://localhost:3000 and check the homepage",
    proxy_country_code=None,
)

import { BrowserUse } from "browser-use-sdk/v3";

const client = new BrowserUse();
const result = await client.run("Go to http://localhost:3000 and check the homepage", {
  proxyCountryCode: null,
});

The US proxy is active by default on every session. To disable it for an auto-session (v2), pass sessionSettings with proxyCountryCode: null — omitting sessionSettings entirely leaves the default US proxy on.