browse_session_start
Start an isolated, short-lived browser session with anti-detection and configurable fingerprint spoofing for private browsing and automated web tasks.
Instructions
Start an isolated short-lived browser session.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| os | No | Optional OS to spoof. Can be 'windows', 'macos', or 'linux'. If not specified, will rotate between all OS types. | |
| args | No | Additional browser command-line arguments to pass to the browser. Rejected unless CAMOUFOX_MCP_ALLOW_UNSAFE_OPTIONS=1; denied args are always rejected. | |
| geoip | No | Automatically detect geolocation based on IP address. | |
| proxy | No | Proxy configuration for routing browser traffic through an HTTP(S) proxy. Proxy servers are checked against the same local-network URL policy as page requests. | |
| locale | No | Browser locale (e.g., 'en-US', 'fr-FR'). | |
| window | No | Set fixed window size [width, height] instead of random generation. An empty array [] is accepted and treated as if the window parameter was not specified. | |
| timeout | No | Timeout in milliseconds for page load (5-300 seconds). | |
| headless | No | Run browser in headless mode. Auto-detects best mode for environment if not specified. | |
| humanize | No | Enable realistic cursor movements and human-like behavior for better stealth and anti-detection. | |
| viewport | No | Custom viewport dimensions. | |
| block_webgl | No | Block WebGL to prevent fingerprinting and tracking. | |
| block_images | No | Block all images for faster loading, reduced bandwidth, and lightweight browsing. | |
| block_webrtc | No | Block WebRTC entirely for enhanced privacy and stealth. | |
| disable_coop | No | Disable Cross-Origin-Opener-Policy for sites that require it. | |
| enable_cache | No | Cache pages, requests, etc. Uses more memory but improves performance when revisiting pages. | |
| waitStrategy | No | Wait strategy for page load. Defaults to 'domcontentloaded'. 'load' waits for all resources, 'networkidle' waits for network activity to finish. | domcontentloaded |
| captchaPolicy | No | Challenge handling policy. 'detect' reports signals, 'pause' returns state for human action, 'fail' returns an error, 'attempt' returns enhanced challenge metadata, interactive elements, a bounded screenshot, and a suggested strategy. When CAPTCHA_AUTONOMOUS=true, responses are marked for LLM-assisted handling and include provider-specific challengePlaybook context when known. | |
| exclude_addons | No | List of default addons to exclude (e.g., ['ublock_origin']). Rejected unless CAMOUFOX_MCP_ALLOW_UNSAFE_OPTIONS=1. | |
| includeConsole | No | Include bounded page console diagnostics in the JSON response. | |
| includeNetwork | No | Include bounded network diagnostics in the JSON response. | |
| stealthProfile | No | Convenience profile for common Camoufox browser settings. Explicit options override profile values. | normal |
| firefox_user_prefs | No | Custom Firefox user preferences to set. Rejected unless CAMOUFOX_MCP_ALLOW_UNSAFE_OPTIONS=1; denied prefs are always rejected. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| browser | Yes | ||
| expiresAt | Yes | ||
| sessionId | Yes | ||
| selectedOS | Yes | ||
| headlessMode | Yes | ||
| captchaPolicy | Yes | ||
| stealthProfile | No |