browser_new_session
Create a new browser session with stealth features for automated tasks, including proxy, persistence, headless, humanization, and recording options.
Instructions
Create a new stealth browser session and make it current. Returns its id.
Runs PROXYLESS by default. To use a proxy, pass either proxy_url
('http://user:pass@host:port') or proxy_server[+username/password].
no_proxy=True forces proxyless even if an env/default proxy is configured.
persistent: keep cookies/localStorage in a profile dir across runs.
headless: override the configured default (None = use the default).
humanize: per-session cursor humanization — a float caps cursor-move time in seconds
(e.g. 0.25 = fast but still humanized), True = default speed, False = off,
None = use the configured default.
record_har: capture a full network HAR (export with browser_har_export).
record_video: record the session to a native .webm (Chromium only); fetch the path with
browser_video_path. The file is finalized on browser_close_session.
record_video_width / record_video_height: pin the recording resolution (e.g. 1920 x 1080
for HD); when omitted Playwright defaults to 800x450.
har_url_filter: glob to scope what the HAR records (e.g. '**/api/**' or
'**/students/**') so it excludes login/captcha/static noise; default = all.
storage_state: path to a saved cookies/localStorage JSON to reload.
extensions: list of paths to UNPACKED Chromium extension folders to side-load (e.g. a
captcha-solver or a custom extension). Forces a persistent + headful session
(Chromium only side-loads extensions that way); the profile persists so the
extension's own config/login survives.
Most tools auto-create a default session, so calling this is optional.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| persistent | No | ||
| label | No | ||
| headless | No | ||
| humanize | No | ||
| record_har | No | ||
| record_video | No | ||
| record_video_width | No | ||
| record_video_height | No | ||
| har_url_filter | No | ||
| storage_state | No | ||
| extensions | No | ||
| proxy_url | No | ||
| proxy_server | No | ||
| proxy_username | No | ||
| proxy_password | No | ||
| no_proxy | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |