Recetas CLI de BotBrowser: Combinaciones practicas de flags

Descripcion general

BotBrowser incluye muchos flags CLI para carga de perfiles, enrutamiento de proxy, configuracion regional y mas. Este articulo recopila comandos listos para usar. Todos los ejemplos asumen que tienes un binario de BotBrowser y archivos .enc de GitHub.

Receta 1: Lanzamiento basico

chromium-browser \
  --bot-profile="/path/to/profile.enc" \
  --headless \
  --remote-debugging-port=9222

BotBrowser deriva automaticamente zona horaria, locale e idiomas desde tu IP de salida.

Receta 2: Proxy con sobreescritura regional

chromium-browser \
  --bot-profile="/path/to/profile.enc" \
  --proxy-server=socks5://user:pass@de-proxy.example.com:1080 \
  --bot-config-timezone="Europe/Berlin" \
  --bot-config-locale="de-DE" \
  --bot-config-languages="de-DE,de,en-US" \
  --bot-config-location="52.5200,13.4050" \
  --headless

Si omites los flags de sobreescritura, BotBrowser los deriva automaticamente de la IP del proxy.

Receta 3: Configuracion multi-instancia

# Instancia 1
chromium-browser \
  --bot-profile="/path/to/profiles/win10-chrome.enc" \
  --bot-title="Session A" \
  --user-data-dir="/tmp/session-a" \
  --headless \
  --remote-debugging-port=9222 &

# Instancia 2
chromium-browser \
  --bot-profile="/path/to/profiles/mac-chrome.enc" \
  --bot-title="Session B" \
  --user-data-dir="/tmp/session-b" \
  --headless \
  --remote-debugging-port=9223 &

Cada instancia necesita su propio --user-data-dir y --remote-debugging-port. Para rotacion automatica, usa --bot-profile-dir:

chromium-browser \
  --bot-profile-dir="/path/to/profiles/" \
  --user-data-dir="/tmp/rotating" \
  --headless

Receta 4: Cambio de marca del navegador

chromium-browser \
  --bot-profile="/path/to/profile.enc" \
  --bot-config-browser-brand="edge" \
  --headless

Valores de marca disponibles: chrome, chromium, edge, brave, opera, webview.

Receta 5: Enriquecimiento de sesion

chromium-browser \
  --bot-profile="/path/to/profile.enc" \
  --bot-always-active \
  --bot-inject-random-history \
  --bot-bookmarks='[{"title":"GitHub","type":"url","url":"https://github.com"}]' \
  --headless

Receta 6: Grabacion de Canvas

chromium-browser \
  --bot-profile="/path/to/profile.enc" \
  --bot-canvas-record-file="/tmp/canvas-capture.jsonl" \
  --bot-noise-seed=12345 \
  --headless

Graba todas las llamadas API de Canvas 2D y WebGL en un archivo JSONL. --bot-noise-seed hace la salida de ruido determinista.

Receta 7: Bot Script (sin framework)

chromium-browser \
  --bot-profile="/path/to/profile.enc" \
  --bot-script="/path/to/automation.js" \
  --headless

Ejecuta un archivo JavaScript con acceso CDP directo via chrome.debugger. Sin dependencias externas.

Consejos

1. Si configuras un proxy, BotBrowser deriva automaticamente zona horaria, locale y geolocalizacion. Sobreescribe solo cuando sea necesario.
2. Los flags CLI tienen la mayor prioridad y sobreescriben la configuracion del perfil.
3. Usa --user-data-dir para aislamiento entre instancias concurrentes.
4. Consulta la Referencia de flags CLI para la lista completa.