║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║

Remote Browser

Browser-Use Cloud Browser or CDP URL

Simple Cloud Browser Setup

Use the Browser-Use cloud browser service with minimal configuration:

from browser_use import Agent, Browser, ChatBrowserUse

browser = Browser(
    use_cloud=True,  # Automatically provisions a cloud browser
)

agent = Agent(
    task="Your task here",
    llm=ChatBrowserUse(),
    browser=browser,
)

Advanced Cloud Browser Configuration

Configure cloud browser parameters to customize your setup:

from browser_use import Agent, Browser, ChatBrowserUse

browser = Browser(
    cloud_profile_id='your-profile-id',  # Optional: specific browser profile
    cloud_proxy_country_code='us',       # Optional: proxy location
    cloud_timeout=30,                    # Optional: session timeout in minutes
)

agent = Agent(
    task="Your task here",
    llm=ChatBrowserUse(),
    browser=browser,
)

Custom CDP URL

Use a CDP URL from any cloud browser provider:

from browser_use import Agent, Browser, ChatBrowserUse

browser = Browser(
    cdp_url="http://remote-server:9222"  # Get a CDP URL from any provider
)

agent = Agent(
    task="Your task here",
    llm=ChatBrowserUse(),
    browser=browser,
)

Setup Requirements

1. Get an API key from cloud.browser-use.com
2. Set BROWSER_USE_API_KEY environment variable

Configuration Parameters

• cloud_profile_id: UUID of a browser profile (optional, uses default if not specified)
• cloud_proxy_country_code: Country code for proxy location - supports: us, uk, fr, it, jp, au, de, fi, ca, in
• cloud_timeout: Session timeout in minutes (free users: max 15 min, paid users: max 240 min)

Benefits

• ✅ No local browser setup required
• ✅ Scalable and fast cloud infrastructure
• ✅ Automatic provisioning and teardown
• ✅ Built-in authentication handling
• ✅ Optimized for browser automation
• ✅ Global proxy support for geo-restricted content

Proxy Connection

Connect through a proxy server with authentication:

from browser_use import Agent, Browser, ChatBrowserUse
from browser_use.browser import ProxySettings

browser = Browser(
    headless=False,
    proxy=ProxySettings(
        server="http://proxy-server:8080",
        username="proxy-user",
        password="proxy-pass"
    ),
    cdp_url="http://remote-server:9222"
)

agent = Agent(
    task="Your task here",
    llm=ChatBrowserUse(),
    browser=browser,
)

Third-Party Cloud Browsers

Various third-party cloud browser providers are supported via CDP URL configuration.

║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║