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
Captcha hint: explicit cdp_url decides cloud; tests cover hint silencing on launch failure, no mocks
Gregor Zunicef62b60e6fdc
diff --git a/browser_use/agent/service.py b/browser_use/agent/service.pyindex 4bfd19844..997c679cc 100644--- a/browser_use/agent/service.py+++ b/browser_use/agent/service.py@@ -2166,9 +2166,13 @@ class Agent(Generic[Context, AgentStructuredOutput]):session = self.browser_sessionif session is not None:profile = session.browser_profile- host = urlparse(session.cdp_url or '').hostname or ''- if profile.use_cloud or profile.cloud_browser_params is not None or host.endswith('.browser-use.com'):- return # already on a Browser Use cloud browser+ if session.cdp_url:+ # start() connects to an explicit cdp_url even when use_cloud=True, so trust the host+ on_browser_use_cloud = (urlparse(session.cdp_url).hostname or '').endswith('.browser-use.com')+ else:+ on_browser_use_cloud = profile.use_cloud or profile.cloud_browser_params is not None+ if on_browser_use_cloud:+ returnself._cloud_captcha_hint_logged = Trueself.logger.warning('Agent was blocked by a captcha. Cloud browsers include stealth fingerprinting and proxy rotation to avoid this.\n'diff --git a/tests/ci/test_cloud_hints.py b/tests/ci/test_cloud_hints.pyindex 15d9f539a..84b384cc9 100644--- a/tests/ci/test_cloud_hints.py+++ b/tests/ci/test_cloud_hints.py@@ -1,12 +1,11 @@"""Cloud browser messages: a clear missing-key error and captcha hints only where they help."""import logging-from unittest.mock import AsyncMock, patchimport pytestfrom browser_use import Agent-from browser_use.browser.cloud.cloud import CloudBrowserAuthError, CloudBrowserClient, resolve_api_key+from browser_use.browser.cloud.cloud import CloudBrowserAuthError, resolve_api_keyfrom browser_use.browser.profile import BrowserProfilefrom browser_use.browser.session import BrowserSessionfrom browser_use.sync.auth import CloudAuthConfig@@ -47,11 +46,9 @@ def test_resolve_api_key_prefers_env_then_saved_login(no_api_key, monkeypatch):async def test_use_cloud_without_key_fails_before_any_request(no_api_key):session = BrowserSession(use_cloud=True)- with patch.object(CloudBrowserClient, 'create_browser', new_callable=AsyncMock) as create_browser:- with pytest.raises(CloudBrowserAuthError) as exc_info:- await session.start()+ with pytest.raises(CloudBrowserAuthError) as exc_info:+ await session.start()- create_browser.assert_not_awaited()message = str(exc_info.value)assert 'BROWSER_USE_API_KEY is not set' in messageassert 'https://cloud.browser-use.com/new-api-key?utm_source=oss&utm_medium=use_cloud' in message@@ -81,9 +78,10 @@ def _captcha_hints(records) -> int:({'use_cloud': True}, 0),({'cdp_url': 'wss://0e5c5a0e-1111-2222-3333-444455556666.cdp1.browser-use.com'}, 0),({'cdp_url': 'wss://connect.example-provider.com'}, 1),+ ({'use_cloud': True, 'cdp_url': 'wss://connect.example-provider.com'}, 1),],)-async def test_captcha_hint_only_for_non_browser_use_browsers_and_once_per_run(records, session_kwargs, expected):+async def test_captcha_hint_only_for_non_browser_use_browsers_and_deduplicated(records, session_kwargs, expected):agent = Agent(task='t', llm=create_mock_llm(), browser_session=BrowserSession(**session_kwargs))agent._log_cloud_captcha_hint()@@ -99,3 +97,16 @@ async def test_cloud_hints_can_be_silenced(records, monkeypatch):agent._log_cloud_captcha_hint()assert _captcha_hints(records) == 0+++async def test_local_launch_failure_hint_can_be_silenced(records, monkeypatch, tmp_path):+ monkeypatch.setenv('BROWSER_USE_CLOUD_HINTS', 'false')+ session = BrowserSession(browser_profile=BrowserProfile(headless=True, executable_path=str(tmp_path / 'no-such-chrome')))++ try:+ with pytest.raises(Exception):+ await session.start()+ finally:+ await session.kill()++ assert not any('Local browser failed to start' in r.getMessage() for r in records)