launch_session
Launch a new browser session with anti-detection. Optionally navigate to an initial URL and configure headless mode, profile, proxy, or download directory.
Instructions
Launch a new browser session via Botasaurus with anti-detection enabled.
The browser stays alive across all subsequent tool calls until close_session is called. Optionally navigate to an initial URL.
Args:
url: Initial URL to navigate to after launch. If omitted, opens a blank page.
headless: Run browser in headless mode. Default: false (headed, for observation).
profile: Optional Chrome profile for session persistence.
A bare name (e.g., 'work-portal') creates a Scout-managed profile
at /.scout/profiles// that persists cookies, localStorage,
and all browser state across sessions.
An absolute path (e.g., 'C:\Users...\User Data') uses an
existing Chrome profile directory directly.
If omitted, a temporary profile is used and deleted on close.
proxy: Optional proxy URL (e.g., 'http://user:pass@host:port').
WARNING: Using a proxy triggers botasaurus-driver's proxy authentication
subsystem, which imports javascript-fixes — a package that runs
'npm install' at import time without a lockfile. Only use proxy in
trusted environments where Node.js is installed.
download_dir: Directory for downloaded files. Default: '/.scout/downloads'.
Relative paths are resolved from the server's working directory.
connection_mode: How to connect to Chrome. 'launch' (default) starts a new
browser instance. 'extension' connects to your existing
Chrome via the Scout extension, preserving logged-in sessions.
allowed_domains: Optional list of domains allowed for fill_secret credential
typing and cross-origin navigation (extension mode).
Example: ['example.com', 'login.example.com'].
If omitted, fill_secret works on any domain (with a warning).
allow_localhost_port: Optional port number (1-65535) to allow localhost/loopback
navigation on. Example: 3000 permits http://localhost:3000 only.
If omitted, localhost is blocked. The SCOUT_ALLOW_LOCALHOST env var
overrides this to allow all ports.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | ||
| headless | No | ||
| profile | No | ||
| proxy | No | ||
| download_dir | No | ||
| connection_mode | No | launch | |
| allowed_domains | No | ||
| allow_localhost_port | No |