browser_create_context

Path to a browser profile JSON file (or upload file via multipart/form-data). If the file exists, loads fingerprints, cookies, and settings. If not, creates a new profile and saves it to this path. Encrypted profiles (from browser_download_profile) are automatically detected and decrypted.

Filter profiles by operating system. If set, only profiles matching this OS will be used. Options: 'windows', 'macos', 'linux'

Filter profiles by GPU vendor/model. If set, only profiles with matching GPU will be used. Examples: 'nvidia', 'amd', 'intel'

Screen resolution for the browser context. Format: 'WIDTHxHEIGHT'. If not set, a random screen size is selected from the monitor catalog.

Override browser timezone. IANA timezone format (e.g., 'America/New_York', 'Europe/London', 'Asia/Tokyo'). If not set, falls back to: 1) proxy-detected timezone (if proxy configured with spoof_timezone), 2) VM profile timezone, 3) system default. This parameter works without proxy configuration.

Override browser locale / language. BCP-47 tag (e.g., 'de-DE', 'fr-FR', 'en-GB'). Sets navigator.language, navigator.languages, and the Accept-Language header consistently so the page (and any consent/CMP UI) renders in that language. If not set, the VM profile's locale is used.

Enable or disable resource blocking (ads, trackers, analytics). When enabled, blocks requests to known ad networks, trackers, and analytics services. Default: true (enabled)

Rendering mode for this context. 'pixel' (default): human pixel render only, identical to today. 'agent': agent-native accessibility render (pixel pipeline suppressed at the tool layer). 'both': agent render and pixels available for screenshot/video. Opt-in and additive; defaults to 'pixel' which preserves existing behavior exactly.

Optional display DPR hint (1.0-3.0). The effective context DPR is sourced from the VM profile, so this is validated and honored-as-noop within range; a value outside 1.0-3.0 is REJECTED with a clear error instead of silently corrupting the context.

Pin this context to a specific row in the chrome_versions table (FK by id, 1..N matching INSERT order sorted by major). Use chrome_version_major instead if you'd rather think in terms of '147'. Mutually exclusive with chrome_version_major; chrome_version_id wins when both are set. 0 / unset = random selection across all chrome_version_ids matching the os/gpu/screen filters.

Pin this context to a specific Chrome major. Resolved to chrome_version_id by looking up the chrome_versions row whose major matches. Options: '143', '144', '145', '146', '147', '148', '149', '150' (current 8-major roster).

Type of proxy server to use. Options: 'http', 'https', 'socks4', 'socks5', 'socks5h', 'gae', 'owl_tunnel'. Use 'socks5h' for remote DNS resolution (recommended for privacy). Use 'owl_tunnel' for an Owl residential tunnel (raw SOCKS5->QUIC splice to a paired sidecar; set proxy_id, not host/port)

Owl Tunnel proxy identity (32-hex, the 'proxy-XXXX' target) when proxy_type='owl_tunnel'. Selects which paired residential sidecar to exit through. Ignored for other proxy types

Proxy server hostname or IP address (e.g., '127.0.0.1' or 'proxy.example.com')

Proxy server port number (e.g., 8080 for HTTP proxy, 9050 for Tor)

Username for proxy authentication. Only required if the proxy server requires credentials

Password for proxy authentication. Only required if the proxy server requires credentials

Automatically spoof browser timezone to match proxy location (detected via IP geolocation). Default: true when proxy is configured

Manually set timezone instead of proxy auto-detection. IANA format like 'America/New_York', 'Europe/London'. Takes precedence over proxy_spoof_timezone. The top-level 'timezone' parameter takes precedence over both

Path to custom CA certificate file (.pem, .crt, .cer) for SSL interception proxies. Required when using Charles Proxy, mitmproxy, or similar HTTPS inspection tools

Path to CA private key file for GAE/private app proxy MITM. Required for generating per-domain certificates when using 'gae' proxy type

Trust the custom CA certificate for SSL interception. Enable when using Charles Proxy, mitmproxy, or similar tools that intercept HTTPS traffic. Default: false

Explicitly mark this proxy as a Tor connection. Enables circuit isolation so each context gets a unique exit node IP. Auto-detected if proxy is localhost:9050 or localhost:9150 with socks5/socks5h

Tor control port for circuit isolation. Used to send SIGNAL NEWNYM to get a new exit node. Default: auto-detect (tries 9051 then 9151). Set to -1 to disable circuit isolation

Password for Tor control port authentication. Leave empty to use cookie authentication (default) or no auth

Enable or disable LLM features for this context. When enabled, allows using AI-powered tools like browser_query_page, browser_summarize_page, and browser_nla. Default: true

Use the built-in llama-server for LLM inference. When true, uses the bundled local model. Set to false to use an external LLM provider. Default: true

External LLM API endpoint URL (e.g., 'https://api.openai.com/v1' for OpenAI). Only used when llm_use_builtin is false

External LLM model name (e.g., 'gpt-4-vision-preview' for OpenAI). Only used when llm_use_builtin is false

API key for the external LLM provider. Required when using external LLM endpoint

Mark the LLM as a third-party provider (OpenAI-compatible API). Automatically inferred as true when llm_endpoint is set. Default: false