browser_open
Launches a Chrome session using nodriver to bypass bot detection, with optional proxy routing. Creates an isolated browser instance as the required first step for automated web testing.
Instructions
Launch a new Chrome browser session with anti-bot bypass (nodriver CDP). Call this BEFORE any other browser_* tool.
TYPICAL STARTUP SEQUENCE:
manage_proxy(action="start") — start the proxy first
browser_open(proxy_port=8082) — launch Chrome routed through proxy
browser_go(url="https://target.com") — navigate
Each session is an independent Chrome instance. You can run multiple sessions simultaneously for multi-user testing (e.g. "victim" and "attacker" sessions for IDOR/privilege escalation).
The browser uses nodriver which bypasses Cloudflare, DataDome, and other bot detection automatically.
Args: session_name: Unique name for this session (default: "default"). Use different names for multiple sessions. proxy_port: Route all browser traffic through mitmproxy on this port (default 8082). Must match the port used in manage_proxy. Set to 0 to disable proxy routing. headless: Run Chrome without a visible window (default true). Set false for visual debugging.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "browser_open"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| headless | No | ||
| proxy_port | No | ||
| session_name | No | default |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |