Launch a stealth CloakBrowser instance. All anti-detection is ON by default.

CloakBrowser is a source-patched Chromium passing Cloudflare Turnstile, reCAPTCHA v3 (0.9 score), FingerprintJS, BrowserScan, and 30+ detectors.

Args: headless: Run headless. Some aggressive sites need headed mode (False). proxy: Proxy URL (e.g. 'http://user:pass@proxy:8080'). Residential recommended. humanize: Human-like mouse/keyboard/scroll (default: True). human_preset: 'default' or 'careful' (slower, more deliberate). stealth_args: Apply stealth fingerprint args (default: True). timezone: IANA timezone (e.g. 'America/New_York'). locale: BCP 47 locale (e.g. 'en-US'). geoip: Auto-detect timezone/locale from proxy IP. fingerprint_seed: Fixed seed for consistent identity across sessions. user_data_dir: Persistent profile path (cookies/localStorage survive restarts). viewport_width: Viewport width in pixels (default: 1920 headless; 1280 headed fallback, or auto-detected). viewport_height: Viewport height in pixels (default: 947 headless; 800 headed fallback, or auto-detected). color_scheme: 'light', 'dark', or 'no-preference'. user_agent: Custom user agent override. extra_args: Additional Chromium CLI flags.

Close the stealth browser and release all resources. Always call when done.

Capture the page's accessibility tree — the PRIMARY way to understand pages.

Returns interactive elements with [@eN] ref IDs for use with cloak_click, cloak_type, cloak_select, etc. Call this BEFORE interacting with a page.

full=False (default): interactive elements only — compact and fast. full=True: includes surrounding text content for reading context.

This is FASTER, CHEAPER, and MORE RELIABLE than screenshots. Always prefer this over cloak_screenshot for deciding what to click.

Args: page_id: Target page ID from cloak_launch or cloak_new_page. full: Include text content alongside interactive elements. max_length: Max characters to return (default: 12000).

Click an element by its [@eN] ref ID from cloak_snapshot.

Auto-retries once if the element moved. Returns an updated snapshot.

Args: page_id: Target page ID. ref: Ref ID from snapshot (e.g. '@e5' or 'e5').

Type text into an input by its [@eN] ref ID from cloak_snapshot.

Clears the field first by default. Set submit=True to press Enter after. Returns an updated snapshot.

Args: page_id: Target page ID. ref: Ref ID from snapshot (e.g. '@e3' or 'e3'). text: Text to type. clear: Clear field before typing (default: True). submit: Press Enter after typing (default: False).

Select a dropdown option by ref ID. Provide one of: value, label, or index.

Returns an updated snapshot.

Args: page_id: Target page ID. ref: Ref ID of the element. value: Option value attribute to select. label: Option visible text to select. index: Option index (0-based) to select.

Hover over an element by ref ID. Returns an updated snapshot.

Args: page_id: Target page ID. ref: Ref ID from snapshot.

Check or uncheck a checkbox/radio by ref ID. Returns an updated snapshot.

Args: page_id: Target page ID. ref: Ref ID from snapshot. checked: True to check, False to uncheck.

Get the page content as clean, readable markdown.

Best for reading articles, docs, search results, or any content-heavy page. Strips navigation, ads, footers — returns just the main content. Much more token-efficient than raw HTML (60-80% savings).

Args: page_id: Target page ID. max_length: Max characters to return (default: 50000).

Take an annotated screenshot with element indices overlaid.

Each numbered element maps to [@eN] refs from cloak_snapshot. Use when you need VISUAL context — images, charts, CAPTCHAs, or layout. For most interactions, prefer cloak_snapshot() instead.

Returns: file path to saved PNG, element count.

Args: page_id: Target page ID. full_page: Capture entire scrollable page (default: viewport only).

Navigate to a URL. Auto-waits for the page to settle (network idle + DOM stable).

Handles Cloudflare challenge pages with extra wait time. Returns an updated snapshot of the loaded page.

Args: page_id: Target page ID. url: URL to navigate to. timeout: Navigation timeout in milliseconds.

Navigate back in browser history. Returns an updated snapshot.

Args: page_id: Target page ID.

Navigate forward in browser history. Returns an updated snapshot.

Args: page_id: Target page ID.

Press a keyboard key (Enter, Tab, Escape, ArrowDown, etc.).

Returns an updated snapshot.

Args: page_id: Target page ID. key: Key name (DOM KeyboardEvent key).

Scroll the page. Returns an updated snapshot.

Args: page_id: Target page ID. direction: 'up' or 'down'. amount: Pixels to scroll.

Wait for the page to settle (no DOM mutations + network idle).

Use after actions that trigger dynamic content loading. Returns whether the page settled and how many DOM mutations occurred.

Args: page_id: Target page ID. timeout_ms: Max wait time in milliseconds (default: 5000).

Execute JavaScript in the page context and return the result.

Args: page_id: Target page ID. expression: JavaScript expression to evaluate.

Open a new browser page/tab. Optionally navigate to a URL.

Args: url: URL to navigate to after creating the page.

List all open pages with their IDs and URLs.

Close a specific page by ID.

Args: page_id: Page ID to close.