Solution skill
BrowserCat browser config goes in a JSON-stringified BrowserCat-Opts header - region, proxy, launch args
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
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>