Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.browseract.com/llms.txt

Use this file to discover all available pages before exploring further.

Browser-act gives agents a practical escalation path for sites that block basic fetchers or standard browser automation.

​
Three-layer strategy

LayerPurposeKey capabilities
EnvironmentPrevent challenges from appearingstealth fingerprints, TLS rotation, proxy switching, privacy mode
ExecutionSolve challenges after they appearsolve-captcha, stealth-extract
HumanResolve cases automation cannot handleremote-assist

​
Environment layer

The stealth browser is designed to look like a normal browser session instead of a script.
CapabilityWhat it does
Fingerprint maskingKeeps Canvas, WebGL, fonts, plugins, and related signals consistent
Navigator normalizationNormalizes webdriver, chrome.runtime, plugin arrays, and related browser properties
TLS signature rotationMatches realistic browser TLS signatures
Headless concealmentKeeps headless mode from exposing common automation signals
Proxy systemSupports hosted dynamic proxies or your own static proxy
Privacy modeStarts each session with a fresh fingerprint and empty profile

​
Dynamic proxy

browser-act browser create \
  --type stealth \
  --name "jp-research" \
  --desc "Research browser using Japan dynamic proxy" \
  --dynamic-proxy JP
List available regions: 
browser-act browser regions

​
Custom proxy

browser-act browser create \
  --type stealth \
  --name "custom-proxy" \
  --desc "Stealth browser with a fixed custom proxy" \
  --custom-proxy socks5://user:pass@host:port
Custom proxies support HTTP and SOCKS5. You own the proxy quality, identity, and rotation strategy.
Proxy optionBest forOperational note
Dynamic proxyRegional rotation and one-off collectionBrowser-act rotates hosted IPs by region
Custom proxyStable identity and bring-your-own infrastructureYou manage proxy quality and reputation

​
Privacy mode

Use privacy mode when each session should start clean: 
browser-act browser create \
  --type stealth \
  --name "ephemeral" \
  --desc "One-time collection jobs" \
  --private true
[!TIP] Use privacy mode for one-off scraping, avoiding fingerprint buildup, and separating account identities. The trade-off is that login state is not preserved.

​
Execution layer

​
stealth-extract

Use stealth-extract when the task is read-only: 
browser-act stealth-extract https://example.com
It opens a stealth browser, renders the page, returns Markdown or HTML, and closes the browser. 
# Return HTML
browser-act stealth-extract https://example.com --content-type html

# Use a regional dynamic proxy
browser-act stealth-extract https://example.com --dynamic-proxy US

# Use a custom proxy
browser-act stealth-extract https://example.com --custom-proxy socks5://user:pass@host:port

# Save the result
browser-act stealth-extract https://example.com --output ./result.md
Use stealth-extract for reading. Use a browser session when you need interaction.

​
solve-captcha

Use solve-captcha when a session reaches a supported CAPTCHA challenge: 
browser-act --session s1 solve-captcha
A successful result returns solved=True.

​
Escalation flow

​
Human layer

When automation cannot move forward, remote-assist creates a live URL. A human can open the link on any device, complete the challenge, and let the agent continue in the same session. See Remote Assist.
  1. Start with chrome or chrome-direct for ordinary logged-in work.
  2. Move to stealth with a proxy when blocking appears.
  3. Use solve-captcha if a supported CAPTCHA appears.
  4. Use remote-assist when human judgment, 2FA, hardware tokens, or unsupported challenges are required.

​
Compared with basic tools

Capabilitycurl / WebFetchStandard Puppeteer / PlaywrightBrowser-act
JavaScript renderingNoYesYes
Anti-bot handlingNoLimitedYes
CAPTCHA solvingNoNoYes, when supported
Human takeoverNoManual setup requiredBuilt in with remote-assist
Stealth headlessNot applicableOften detectableSupported

​
Learn more

Better Headless Browser

Run silently while keeping stealth and handoff available.

Browser Modes

Choose the right browser identity for the job.

Skill Forge

Turn site-specific knowledge into a reusable skill.