RBSM User Manual & Command Reference

⚡ 1. Quickstart & License Setup

RBSM is a zero-dependency, single-binary anti-detect browser engine. It has no external Python or Node.js runtime requirements.

Step 1: Download & Extract

rbsm/
├── rbsm_windows_amd64.exe  (or rbsm_linux_amd64 on Linux)
├── license.lic             (placed in the same folder)
├── proxies.txt             (optional proxy list)
├── ip-log.txt              (auto-generated for tracking used IPs)
├── macros/                 (your .mac automation scripts)
└── rules/                  (optional JSON network rules)

Step 2: Obtain Your Machine Hardware ID (HWID)

.\rbsm_windows_amd64.exe -hwid

chmod +x rbsm_linux_amd64
./rbsm_linux_amd64 -hwid

chmod +x rbsm_macos_arm64
./rbsm_macos_arm64 -hwid

Step 3: Activate Your License

• Claim a Free 24h Trial at rbsm.nexustrc.app using your email & Machine ID.
• Place license.lic in the exact same directory as your RBSM binary.

Step 4: Run Your First Test

rbsm_windows_amd64.exe -macros=macros\creep.mac

./rbsm_linux_amd64 -macros=macros/creep.mac -headless=true

./rbsm_macos_arm64 -macros=macros/creep.mac

⚙️ 2. Complete CLI Flags & Options Reference

A comprehensive list of every command-line flag and option available in the RBSM executable:

A. Core Engine & Operation Modes

B. Proxy & Network Pool Management

C. URLs, Security & Browser Profiles

🌐 3. Proxy Setup & IP Resolution Modes

RBSM supports HTTP, HTTPS, SOCKS5, and SOCKS4 proxies with or without authentication.

Accepted Formats in proxies.txt

# Standard (No Auth): <protocol>://<host>:<port>
http://192.168.1.100:8080
https://proxy.example.com:8443
socks5://192.168.1.100:1080
socks4://192.168.1.100:1080

# Authenticated: <username>:<password>#<protocol>://<host>:<port>
myuser:mypass#http://192.168.1.100:8080
myuser:mypass#socks5://proxy.provider.com:1080
customer123:secret#http://gate.smartproxy.com:7000

Proxy Operating Modes Matrix

Compiling Offline GeoIP Database (-build → iprbsm.bin)

By default, RBSM resolves proxy geolocation through embedded heuristics and rapid judges. For 100% offline, zero-latency microsecond lookups without querying any remote IP APIs or leaking DNS lookups, you can compile the MaxMind City database into a native binary index:

# 1. Standard build (looks for GeoLite2-City.mmdb in current directory):
# Windows:
rbsm_windows_amd64.exe -build

# Linux VPS:
./rbsm_linux_amd64 -build

# 2. Specify a custom MMDB source file using -db=FILE:
# Windows:
rbsm_windows_amd64.exe -build -db="C:\data\GeoLite2-City.mmdb"

# Linux VPS:
./rbsm_linux_amd64 -build -db="/var/data/GeoIP2-City.mmdb"

🛡️ 4. IP Reuse Limits & Mid-Flight Shift Guards

Strict 1-Session-Per-IP Isolation (-limit-proxy)

When running airdrop farming, high-volume account creation, or strict scraping tasks, prevent IP reuse across sessions:

• Used IPs are recorded in ip-log.txt (e.g. 95.131.86.220 1x).
• Once an IP reaches n uses, RBSM automatically requests a fresh IP rotation from your proxy provider.
• -limit-timeout=300 sets the maximum retry attempts before terminating safely.

rbsm_windows_amd64.exe -macros=macros\flow.mac -proxy=true -limit-proxy=1 -limit-timeout=300

Mid-Flight IP Shift Guard (GUARD_IP_SHIFT)

If your rotating residential proxy silently shifts its exit IP during an active session, activate GUARD_IP_SHIFT in your .mac script or "guard_ip_shift": true in rules.json. RBSM will instantly abort the contaminated session, kill the browser, and allow the worker to launch cleanly with a fresh proxy.

🧑 5. Human Physics & Typing Simulation

Control natural mouse trajectories (Bézier curves), randomized click hold times, and typing jitter with -human=<0-3>:

📥 6. Built-in Chrome Downloader

RBSM bundles a native Chrome downloader directly inside the core binary, eliminating the need for Python or external scripts.

# Download specific stable milestones:
rbsm -download-chrome 113 120 151

# Auto-download active market-share versions from browser-data.json:
rbsm -download-chrome -from-ua

# Download to custom folder:
rbsm -download-chrome 120 -o D:\browsers

# Rebuild chrome-map.json mapping:
rbsm -download-chrome -map-only

🎭 7. Built-in Fingerprint & User-Agent Generator

Generate realistic browser fingerprint profiles directly into fp-ua.json using market-share weighted distributions.

# Generate 5,000 realistic fingerprints with market-share weighting:
rbsm -generate-fp -os android windows macos -browser chrome edge -total=5000

# Sync browser-data.json with latest StatCounter shares and Chrome/Edge APIs:
rbsm -generate-ua -update

RBSM bundles ready-to-run .mac templates in the macros/ folder. Run any recipe instantly with rbsm -macros=macros/<filename>.mac or download directly below.

Recipe 1: Automated Login with Verification

# 1. Open login page
GOTO "https://example.com/login"
WAIT_UNTIL "form, input[type='email'], body"

# 2. Type credentials with natural human keystroke jitter
SMART_CLICK "input[type='email'], input[name='username']"
TYPE_TEXT "admin@enterprise-target.com"

SMART_CLICK "input[type='password']"
TYPE_TEXT "SecretKeyP@ssword2026!"

# 3. Submit form and guard IP shift
SMART_CLICK "button[type='submit']"
GUARD_IP_SHIFT
SCREENSHOT "output/login_session.png"

Recipe 2: Cookie Banners & Conditional Popups

GOTO "https://target-site.com"
WAIT 2 3

# Dismiss cookie banner if detected
IF SMART_EXIST "#accept-cookies-btn, .cookie-accept, button[title*='Accept']"
  SMART_CLICK "#accept-cookies-btn, .cookie-accept, button[title*='Accept']"
  ECHO "Cookie banner dismissed"
ELSE
  ECHO "No cookie banner found, continuing flow"
END

Recipe 3: E-Commerce & Multi-Page Pagination Loop

GOTO "https://shop.example.com/search?q=laptops"
WAIT_UNTIL ".product-card, body"

LOOP 5
  SCREENSHOT "output/page_results_<random>.png"
  SCROLL_DOWN 600
  WAIT 1 2

  IF SMART_EXIST ".pagination-next-btn, a[rel='next']"
    SMART_CLICK ".pagination-next-btn, a[rel='next']"
    WAIT_UNTIL ".product-card"
  ELSE
    ECHO "Reached final page"
    BREAK
  END
END

Recipe 4: Parallel Tab Broadcasting

# Open 3 isolated tabs
NEW_ISOLATED_TAB "https://example.com/page1"
NEW_ISOLATED_TAB "https://example.com/page2"
NEW_ISOLATED_TAB "https://example.com/page3"

# Mirror all subsequent actions simultaneously across all 3 tabs
BROADCAST ON
SCROLL_DOWN 500
SMART_CLICK ".claim-button"
BROADCAST OFF

🎥 9. Live Action Recorder (-record)

Instead of hand-coding macros, record your live browser actions in real time:

# 1. Start live recording mode
rbsm_windows_amd64.exe -record=my_flow.mac

# 2. A browser opens. Navigate, click, and type naturally.
# 3. Close the browser window or press Ctrl+C to save my_flow.mac.

# 4. Replay the macro anytime
rbsm_windows_amd64.exe -macros=my_flow.mac

🎲 10. Dynamic Variables & Placeholders

RBSM macros evaluate dynamic placeholders at runtime to generate unique usernames, delay jitter, and dynamic session parameters:

📑 11. Complete Macro Commands Reference (A–Z)

A. Navigation & Tab Management

B. Mouse & Keyboard Interaction

C. Waiting & Timing

D. Control Flow, Loops & Broadcasting

E. Network Interception & Storage

F. Assertions & IP Shift Protection

G. Screenshots, JavaScript & Output

🛡️ 12. Ad-Blocking & Network Rules (5x Speedup)

Block heavy media, tracker scripts, and analytics to boost page load speed up to 5x and save 80% bandwidth on metered residential proxy pools.

Option 1: Inline Macro Commands

NETWORK_ABORT "*google-analytics.com*"
NETWORK_ABORT "*doubleclick.net*"
NETWORK_ABORT "*.mp4"
NETWORK_ABORT "*.png,*.jpg,*.gif"

GOTO "https://news-site.com"

Option 2: Declarative JSON Rules File (-rules)

{
  "rules": [
    { "pattern": "*://*.google-analytics.com/*", "action": "block" },
    { "pattern": "*://*.doubleclick.net/*", "action": "block" },
    { "pattern": "*.mp4", "action": "block" }
  ]
}

rbsm_windows_amd64.exe -macros=macros\scrape.mac -rules=rules\block_ads.json -proxy=true -headless=true

💬 13. Zero-Token Interactive Agent CLI Mode

Run RBSM in interactive terminal mode (-interactive=true) to control browser inspection, dynamic rules, and network debugging without consuming LLM API tokens:

🤖 14. AI Agent & Claude Desktop (MCP Server)

RBSM has built-in support for Anthropic's Model Context Protocol (MCP) over stdio, enabling Claude Desktop, Cursor, and AI agents to autonomously drive anti-detect browser sessions.

Claude Desktop Configuration

Add RBSM to your claude_desktop_config.json:

{
  "mcpServers": {
    "rbsm": {
      "command": "C:\\path\\to\\rbsm_windows_amd64.exe",
      "args": ["-mcp-server=true"]
    }
  }
}

Available MCP Tools Exposed to Claude / AI

❓ 15. Troubleshooting & FAQ

"License Invalid or Expired"

• Verify license.lic is located in the exact same folder as your RBSM binary.
• Verify the machine Hardware ID (from rbsm -hwid) matches the ID provided during license checkout.

Running Headless on Minimal Linux Cloud VPS

On freshly deployed minimal Ubuntu / Debian servers, install essential browser dependencies:

sudo apt-get update && sudo apt-get install -y libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libasound2

./rbsm_linux_amd64 -macros=macros/scrape.mac -headless=true

Proxy Connection Timeouts

• Check that the proxy host, port, and credentials are correct in proxies.txt.
• If using strict residential pools, test with -proxy=true to let RBSM automatically detect the exit IP location.
• If you know your proxy pool is healthy and want to skip reachability checks, pass -no-judges=true.