browse_forms
Read-only
Navigate to any URL and return all form fields and submit controls, enabling automated form interaction with anti-detection browsing.
Instructions
Navigate once and return form fields and submit controls.
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. | |
| url | Yes | The URL to navigate to. Must be a fully qualified http or https URL. | |
| 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. | |
| maxForms | No | Maximum forms to return. | |
| selector | No | Optional CSS selector to limit extraction to one matching element. | |
| viewport | No | Custom viewport dimensions. | |
| maxFields | No | Maximum fields to return across all forms. | |
| 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 |
|---|---|---|---|
| url | Yes | ||
| forms | Yes | ||
| title | No | ||
| status | No | ||
| message | No | ||
| maxForms | Yes | ||
| selector | No | ||
| maxFields | Yes | ||
| truncated | Yes | ||
| contentType | No | ||
| diagnostics | No | ||
| challengeType | No | ||
| selectorFound | Yes | ||
| captchaIframes | No | ||
| captchaDetected | No | ||
| challengeSignals | No | ||
| challengeHandling | No | ||
| challengePlaybook | No | ||
| challengeProvider | No | ||
| suggestedStrategy | No | ||
| requiresUserAction | No | ||
| interactiveElements | No |