WS /connect
Auto-creates a browser when a CDP client connects. The browser is cleaned up when the WebSocket disconnects (2-second grace period).
URL: ws://localhost:9222/connect
Auth: None (local mode) or api_key query parameter (remote mode)
Query parameters
Section titled “Query parameters”| Parameter | Default | Description |
|---|---|---|
headless | true | true or false |
os | linux | Fingerprint OS: windows, linux, android, macos |
browser_name | chrome | Browser fingerprint type |
browser_version_min | (latest) | Minimum Chrome version |
browser_version_max | (latest) | Maximum Chrome version |
proxy | (none) | Proxy URL |
browser_language | (auto) | Accept-Language value |
ui_language | (auto) | Browser UI locale |
screen_width_min | (auto) | Minimum screen width |
screen_height_min | (auto) | Minimum screen height |
api_key | (none) | Required in remote mode |
Example
Section titled “Example”ws://localhost:9222/connect?headless=true&os=windows&proxy=http://user:pass@host:port