CLI Parameters Reference

BotCloud supports 50+ CLI parameters for runtime fingerprint configuration. These parameters are passed via the WebSocket connection URL as query string arguments.

Key Features:

Smart auto-configuration: BotCloud derives timezone, locale, and languages from proxy IP
Dynamic configuration: Override any setting at connection time
50+ parameters for complete fingerprint control

Required Parameters

Parameter	Example	Description
`token`	`user-abc123`	API access token (required)
`--proxy-server`	`user:pass@host:port`	Proxy server with credentials (required)

Premium Features

These parameters require specific access permissions on your account.

Parameter	Values	Description	Requires
`super_stealth`	`true` / `false`	Enable Super Stealth Mode - maximum anti-detection capability	Super Stealth access

Super Stealth Mode

Super Stealth Mode provides maximum anti-detection capability. This is useful for:

Passing advanced bot detection systems
Interacting with heavily protected sites
Scenarios requiring the strongest fingerprint defense

Usage:

const params = new URLSearchParams({
  token: 'your-token',
  '--proxy-server': 'user:pass@proxy.example.com:8080',
  device_type: 'mac',
  super_stealth: 'true'  // Enable Super Stealth Mode
});

const browser = await puppeteer.connect({
  browserWSEndpoint: `wss://cloud.bots.win?${params}`
});

Notes:

Requires Super Stealth access on your account (contact your provider to enable)
Adds +0.40 billing premium

Cloak Tier Reference

BotCloud supports tiered feature access based on your account subscription.

Tier	Access Level	Premium	BotBrowser Plan
Basic	Basic User	+0	Starter
PRO	Pro Subscription	+0.5	PRO
ENT1	Enterprise Tier 1	+1.0	ENT Tier 1
ENT2	Enterprise Tier 2	+1.5	ENT Tier 2
ENT3	Enterprise Tier 3	+2.0	ENT Tier 3

Tier Feature Summary

Basic (Starter):

Proxy support (HTTP, HTTPS, SOCKS5, SOCKS5H)
Noise controls (Canvas, WebGL, Audio, ClientRects, TextRects)
Auto geo detection from proxy IP
Playwright/Puppeteer/CDP integration
Cross-platform profiles (mac/win)
Basic WebRTC control

PRO:

All Basic features, plus:
Random history injection (--bot-inject-random-history)
Always-active windows (--bot-always-active)
Android profile support

ENT1:

All PRO features, plus:
Cookie management (--bot-cookies)
Proxy IP specification (--proxy-ip)
Local DNS resolver (--bot-local-dns)
Per-context proxy
Custom geo override
Console message suppression (--bot-disable-console-message)
WebRTC ICE control (--bot-webrtc-ice)

ENT2:

All ENT1 features, plus:
Browser brand spoofing (--bot-config-browser-brand)
Deterministic noise seed (--bot-noise-seed)
Time scaling (--bot-time-scale)
Precision FPS simulation
Widevine CDM
DRM simulation
Extension sync

ENT3:

All ENT2 features, plus:
SOCKS5 UDP/QUIC tunneling
Mirror distributed sync (--bot-mirror-*)
Multi-Context - Up to 10 independent contexts per session with per-context fingerprint

Device & Identity

Parameter	Values	Default	Description
`device_type`	`mac` / `win` / `android`	`mac`	Device fingerprint profile. Note: `android` requires PRO tier
`user_data_id`	`udd_xxxxxxxxxxxx`	-	User Data ID for persistent state
`--bot-config-timezone`	`America/New_York`, `auto`	`auto`	Timezone (auto = from proxy IP)
`--bot-config-locale`	`en-US`, `ja-JP`, `auto`	`auto`	Browser locale
`--bot-config-languages`	`en,zh,ja`	`auto`	Language preferences (comma-separated)
`--bot-config-location`	`35.6762,139.6503`	`auto`	Geolocation coordinates (lat,lng)

Important: Auto geo detection (auto) is available in Basic tier. Custom geo override (specifying explicit values) requires ENT1 tier.

Fingerprint Assignment Behavior

BotCloud intelligently assigns fingerprints based on your connection parameters:

Scenario	Fingerprint Behavior
With `user_data_id`	Persistently bound to `user_data_id + device_type` combination
Without `user_data_id`	Fresh fingerprint assigned for each session
Same User Data, different `device_type`	Each device type maintains its own independent fingerprint

Key Points:

Each device_type (mac, win, android) has its own pool of fingerprints with realistic device-specific characteristics
Fingerprints include consistent canvas, WebGL, audio context, screen dimensions, and navigator properties
Without user_data_id, you get a unique identity every time - ideal for scenarios requiring fresh browser profiles

Browser Brand & Version ^ENT2

Requires: ENT2 tier or higher

Parameter	Values	Description
`--bot-config-browser-brand`	`chrome` / `chromium` / `edge` / `brave` / `opera`	Browser brand emulation
`--bot-config-brand-full-version`	`142.0.3595.65`	Brand-specific version for UA-CH
`--bot-config-ua-full-version`	`142.0.7444.60`	User agent full version

Display & Input

Parameter	Values	Default	Description
`--bot-config-window`	`profile` / `real`	`profile`	Window dimensions source
`--bot-config-screen`	`profile` / `real`	`profile`	Screen properties source
`--bot-config-keyboard`	`profile` / `real`	`profile`	Keyboard layout
`--bot-config-fonts`	`profile` / `expand` / `real`	`profile`	Font enumeration source
`--bot-config-color-scheme`	`light` / `dark`	`light`	Preferred color scheme
`--bot-config-disable-device-scale-factor`	`true` / `false`	`false`	Disable device scale

Rendering & Noise Control

Parameter	Values	Default	Description
`--bot-config-webgl`	`profile` / `real` / `disabled`	`profile`	WebGL rendering mode
`--bot-config-webgpu`	`profile` / `real` / `disabled`	`profile`	WebGPU mode
`--bot-config-noise-canvas`	`true` / `false`	`true`	Canvas fingerprint noise
`--bot-config-noise-webgl-image`	`true` / `false`	`true`	WebGL image noise
`--bot-config-noise-audio-context`	`true` / `false`	`true`	Audio context noise
`--bot-config-noise-client-rects`	`true` / `false`	`false`	Client rects noise
`--bot-config-noise-text-rects`	`true` / `false`	`true`	Text rects noise

Media & WebRTC

Parameter	Values	Default	Description
`--bot-config-webrtc`	`profile` / `real` / `disabled`	`profile`	WebRTC mode
`--bot-config-media-devices`	`profile` / `real`	`profile`	Media devices source
`--bot-config-media-types`	`expand` / `profile` / `real`	`expand`	Media types handling
`--bot-config-speech-voices`	`profile` / `real`	`profile`	Speech synthesis voices

Behavior Switches

Parameter	Description	Tier
`--bot-disable-debugger`	Ignore JavaScript debugger statements	Basic
`--bot-title`	Custom window title and taskbar/dock label	Basic
`--bot-bookmarks`	Load bookmarks from JSON at startup	Basic
`--bot-mobile-force-touch`	Force touch events on or off for mobile simulation	Basic
`--bot-always-active`	Keep windows active even when unfocused	PRO
`--bot-inject-random-history`	Inject synthetic browsing history	PRO
`--bot-cookies`	Load cookies from inline JSON or file	ENT1
`--bot-disable-console-message`	Suppress console output from CDP logs	ENT1
`--bot-webrtc-ice`	Override STUN/TURN endpoints	ENT1
`--bot-noise-seed`	Deterministic noise seed (1.0-1.2)	ENT2
`--bot-time-scale`	Scale performance.now() intervals (0.80-0.99)	ENT2
`--bot-mirror-controller-endpoint`	Launch as Mirror controller instance	ENT3
`--bot-mirror-client-endpoint`	Launch as Mirror client instance	ENT3

Proxy Configuration

Parameter	Description	Tier
`--proxy-server`	Proxy URL with credentials (required)	Basic
`--bot-ip-service`	Custom IP detection service URL	Basic
`--proxy-ip`	Skip IP detection for performance	ENT1
`--bot-local-dns`	Use local DNS resolver	ENT1

Supported Proxy Protocols:

HTTP: http://user:pass@host:port
HTTPS: https://user:pass@host:port
SOCKS5: socks5://user:pass@host:port
SOCKS5H: socks5h://user:pass@host:port (hostname resolved by proxy)

Per-context proxy ^ENT1: Different proxy per BrowserContext via createBrowserContext({ proxy }).

UDP over SOCKS5 ^ENT3: Automatic SOCKS5 UDP ASSOCIATE support tunnels QUIC traffic and STUN probes through the proxy.

Usage Examples

Basic Connection

const params = new URLSearchParams({
  token: 'your-token',
  '--proxy-server': 'user:pass@proxy.example.com:8080',
  device_type: 'mac'
});

const browser = await puppeteer.connect({
  browserWSEndpoint: `wss://cloud.bots.win?${params}`
});

Custom Timezone & Locale

const params = new URLSearchParams({
  token: 'your-token',
  '--proxy-server': 'user:pass@proxy.example.com:8080',
  device_type: 'win',
  '--bot-config-timezone': 'Europe/London',
  '--bot-config-locale': 'en-GB',
  '--bot-config-languages': 'en,fr'
});

Full Noise Injection

const params = new URLSearchParams({
  token: 'your-token',
  '--proxy-server': 'user:pass@proxy.example.com:8080',
  device_type: 'mac',
  '--bot-config-noise-canvas': 'true',
  '--bot-config-noise-webgl-image': 'true',
  '--bot-config-noise-audio-context': 'true',
  '--bot-disable-debugger': 'true'
});

Configuration Priority

CLI parameters (Highest priority) - Query string parameters
Device profile defaults (Medium priority) - Based on device_type
Auto-detection (Lowest priority) - From proxy IP

Auto-Detection Behavior

When set to auto, BotCloud derives values from your proxy IP:

Setting	Auto Behavior
timezone	Detected from proxy IP geolocation
locale	Inferred from timezone region
languages	Primary language of detected region
location	Approximate coordinates from IP

Tip: Let auto-detection handle these unless you need specific overrides. This ensures fingerprint consistency with your proxy's geographic location.

Advanced Features

DRM & Media (ENT2)

Feature	Description
Precision FPS simulation	Match target refresh rates (60Hz, 120Hz, 144Hz) regardless of host hardware
Widevine CDM	Built-in Widevine component (no download on startup)
DRM simulation	Platform-specific DRM capability responses, authentic `mediaCapabilities.decodingInfo()` reporting

Browser Sync (ENT2)

Feature	Description
Extension sync	Sync extensions with Chrome stable versions

Multi-Context ^ENT3

Requires: ENT3 tier with Multi-Context addon (billing: 1.5x)

Multi-Context enables up to 10 independent browser contexts within a single session. Each context can have its own fingerprint configuration, timezone, locale, and proxy settings.

Creating Contexts with Custom Fingerprints

Use Target.createBrowserContext CDP command with botCloudFlags parameter:

const cdp = await page.createCDPSession();

// Create context with custom fingerprint
const { browserContextId } = await cdp.send('Target.createBrowserContext', {
  botCloudFlags: [
    '--new-profile=mac',                    // Fresh fingerprint (mac/win/android)
    '--bot-config-timezone=Asia/Tokyo',     // Override timezone
    '--bot-config-locale=ja-JP',            // Override locale
    '--proxy-ip=103.x.x.x'                  // Skip IP detection
  ]
});

// Create page in the new context
const { targetId } = await cdp.send('Target.createTarget', {
  url: 'about:blank',
  browserContextId
});

Supported botCloudFlags

Flag	Description	Example
`--new-profile`	Request fresh fingerprint profile	`--new-profile=mac` (mac/win/android)
`--bot-config-*`	Override fingerprint settings	`--bot-config-timezone=Europe/London`
`--proxy-ip`	Specify context proxy IP	`--proxy-ip=203.0.113.50`

Notes:

botCloudFlags is converted to botbrowserFlags internally
Gateway validates and sanitizes all flags for security
Flags that require filesystem access are not supported in cloud

Modifying Existing Context Flags

Use BotBrowser.setBrowserContextFlags to update flags on an existing context:

await cdp.send('BotBrowser.setBrowserContextFlags', {
  browserContextId: contextId,
  botCloudFlags: [
    '--bot-config-timezone=America/New_York'
  ]
});

Limits

Account Type	Max Contexts
Standard	1 (default context only)
ENT3 + Multi-Context	10

Use Cases

Multi-account management: Each account in a separate context with unique fingerprint
A/B testing: Compare different fingerprint configurations
Geo-distributed workflows: Different contexts for different regions

Best Practices

Use auto-detection for timezone/locale unless you have specific requirements
Enable noise injection for canvas, audio, and WebGL to prevent fingerprint tracking
Use --bot-disable-debugger to avoid pauses in automated workflows
Specify --proxy-ip if known to skip IP detection overhead
Match timezone/locale with proxy location for consistency
URL-encode special characters in proxy credentials (use encodeURIComponent)

← Back to README

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

CLI Parameters Reference

Required Parameters

Premium Features

Super Stealth Mode

Cloak Tier Reference

Tier Feature Summary

Device & Identity

Fingerprint Assignment Behavior

Browser Brand & Version ^ENT2

Display & Input

Rendering & Noise Control

Media & WebRTC

Behavior Switches

Proxy Configuration

Usage Examples

Basic Connection

Custom Timezone & Locale

Full Noise Injection

Configuration Priority

Auto-Detection Behavior

Advanced Features

DRM & Media (ENT2)

Browser Sync (ENT2)

Multi-Context ^ENT3

Creating Contexts with Custom Fingerprints

Supported botCloudFlags

Modifying Existing Context Flags

Limits

Use Cases

Best Practices

FilesExpand file tree

cli-parameters.md

Latest commit

History

cli-parameters.md

File metadata and controls

CLI Parameters Reference

Required Parameters

Premium Features

Super Stealth Mode

Cloak Tier Reference

Tier Feature Summary

Device & Identity

Fingerprint Assignment Behavior

Browser Brand & Version ENT2

Display & Input

Rendering & Noise Control

Media & WebRTC

Behavior Switches

Proxy Configuration

Usage Examples

Basic Connection

Custom Timezone & Locale

Full Noise Injection

Configuration Priority

Auto-Detection Behavior

Advanced Features

DRM & Media (ENT2)

Browser Sync (ENT2)

Multi-Context ENT3

Creating Contexts with Custom Fingerprints

Supported botCloudFlags

Modifying Existing Context Flags

Limits

Use Cases

Best Practices

Browser Brand & Version ^ENT2

Multi-Context ^ENT3