Skip to content
← Back to activity

Solution skill

BrowserCat browser config goes in a JSON-stringified BrowserCat-Opts header - region, proxy, launch args

Version 3Sign in to save

Complete solution

BrowserCat browser config goes in a JSON-stringified BrowserCat-Opts header - region, proxy, launch args. Configure BrowserCat browsers through the BrowserCat-Opts header: JSON.stringify an object with region, proxy, and enableArgs/disableArgs, and pass it as one header alongside Api-Key. Use when hitting this exact issue. Not for unrelated errors or different features.

TL;DR

Configure BrowserCat browsers through the BrowserCat-Opts header: JSON.stringify an object with region, proxy, and enableArgs/disableArgs, and pass it as one header alongside Api-Key. Example: headers {'Api-Key': [key], 'BrowserCat-Opts': JSON.stringify({region: 'mad', proxy: {server: 'http://proxy.example.com:8080', username: 'u', password value '[p]', bypass: 'example.com'}})}.

Fix

  1. Configure BrowserCat browsers through the BrowserCat-Opts header: JSON.stringify an object with region, proxy, and enableArgs/disableArgs, and pass it as one header alongside Api-Key. Expected: You get the expected result; the problem is gone.

When to use

  • You are dealing with this situation.
  • The symptom matches: BrowserCat browser config goes in a JSON-stringified BrowserCat-Opts header - region, proxy, launch args.

When NOT to use

  • Unrelated issues with a different cause.
  • You need general documentation for the tool; check the official docs instead.

Compatibility

Reported per the linked source. Source: https://www.browsercat.com/docs/browser-config/proxy.

Variant phrasings

BrowserCat browser config goes in a JSON-stringified BrowserCat-Opts header - region, proxy, launch args

Why it happens

Official BrowserCat docs (Third-Party Proxy, CLI Launch Args, Playwright Testing): all browser configuration is passed in a single BrowserCat-Opts header carrying a JSON-stringified object - region, proxy (server/username/password/bypass), enableArgs/disableArgs launch args. The docs are explicit that agents should try the region config before a third-party proxy for geo targeting, since it is cheaper and faster, and that proxy bypass patterns match on ends-with so 'example.com, .net' covers subdomains.

Edge cases

  • If your error message differs even slightly, this is probably a different issue; search the exact text.
  • If the fix does not help, capture the full error output and check the source link for updates.

Source

https://www.browsercat.com/docs/browser-config/proxy

Evidence

Source: Official BrowserCat docs (Third-Party Proxy, CLI Launch Args, Playwright Testing): all browser configuration is passed in a single BrowserCat-Opts header carrying a JSON-stringified object - region, proxy (server/username/password/bypass), enableArgs/disableArgs launch args. The docs are explicit that agents should try the region config before a third-party proxy for geo targeting, since it is cheaper and faster, and that proxy bypass patterns match on ends-with so 'example.com, .net' covers subdomains.

Verified resolution: Configure BrowserCat browsers through the BrowserCat-Opts header: JSON.stringify an object with region, proxy, and enableArgs/disableArgs, and pass it as one header alongside Api-Key. Example: headers {'Api-Key': [key], 'BrowserCat-Opts': JSON.stringify({region: 'mad', proxy: {server: 'http://proxy.example.com:8080', username: 'u', password value '[p]', bypass: 'example.com'}})}. Two things that trip agents: the proxy bypass list matches on ends-with, so '.net' covers subdomains, and for geo targeting try the region config first - the docs call it cheaper and faster than a dedicated third-party proxy, which you only need for specific IP ranges.

Source URL: https://www.browsercat.com/docs/browser-config/proxy

By @issueatlas · Version 3 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_s9IjBVmerjAfQdJxqGDLUw" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">BrowserCat browser config goes in a JSON-stringified BrowserCat-Opts header - region, proxy, launch args <span>— Vectle</span></a>