From 69ad029d39e64ebb30a7ecf26c07cd6a7d7be51f Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Wed, 11 Mar 2026 04:02:13 +0000 Subject: [PATCH 1/2] docs: emphasize default proxy behavior MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Gregor Žunič --- docs/cloud/guides/proxies-and-stealth.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/cloud/guides/proxies-and-stealth.mdx b/docs/cloud/guides/proxies-and-stealth.mdx index 1bada1e41..87806302d 100644 --- a/docs/cloud/guides/proxies-and-stealth.mdx +++ b/docs/cloud/guides/proxies-and-stealth.mdx @@ -57,9 +57,9 @@ const result = await client.run("Get the price of iPhone 16 on amazon.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 @@ -97,10 +97,10 @@ Proxy is a session-level setting. All tasks in the same session use the same pro ## Disabling proxies - Disabling the proxy is not recommended. Residential proxies are a core part of Browser Use's stealth infrastructure and significantly reduce the chance of being blocked or fingerprinted. Only disable them if you have a specific reason (e.g. testing against localhost, or your target site allowlists your server IP). + Only disable proxies for localhost testing or sites that allowlist your server IP. They reduce blocks and fingerprinting. -To opt out of the built-in proxy, pass `proxyCountryCode` as `null` explicitly. This works for sessions, tasks (via `sessionSettings`), and browser sessions. +To disable the built-in proxy, set `proxyCountryCode` to `null` on sessions, tasks (via `sessionSettings`), or browser sessions. ```python Python From 917d3b32a8f992656a2fb1ae815d48d9da0c8dbc Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Wed, 11 Mar 2026 04:06:29 +0000 Subject: [PATCH 2/2] docs: use warning callout for default proxy MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Gregor Žunič --- docs/cloud/guides/proxies-and-stealth.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/cloud/guides/proxies-and-stealth.mdx b/docs/cloud/guides/proxies-and-stealth.mdx index 87806302d..6a8c1cfbb 100644 --- a/docs/cloud/guides/proxies-and-stealth.mdx +++ b/docs/cloud/guides/proxies-and-stealth.mdx @@ -57,9 +57,9 @@ const result = await client.run("Get the price of iPhone 16 on amazon.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