Recettes CLI BotBrowser : combinaisons pratiques de flags

Presentation

BotBrowser propose de nombreux flags CLI pour le chargement de profils, le routage proxy, les parametres regionaux et plus. Cet article rassemble des commandes pretes a l'emploi. Tous les exemples supposent que vous avez un binaire BotBrowser et des fichiers .enc de GitHub.

Recette 1 : Lancement basique

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

BotBrowser derive automatiquement le fuseau horaire, la locale et les langues depuis votre IP de sortie.

Recette 2 : Proxy avec remplacement 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 vous omettez les flags de remplacement, BotBrowser les derive automatiquement de l'IP du proxy.

Recette 3 : Configuration multi-instances

# Instance 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 &

# Instance 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 &

Chaque instance necessite son propre --user-data-dir et --remote-debugging-port. Pour la rotation automatique, utilisez --bot-profile-dir :

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

Recette 4 : Changement de marque du navigateur

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

Valeurs de marque disponibles : chrome, chromium, edge, brave, opera, webview.

Recette 5 : Enrichissement de session

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

Recette 6 : Enregistrement Canvas

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

Enregistre tous les appels API Canvas 2D et WebGL dans un fichier JSONL. --bot-noise-seed rend la sortie de bruit deterministe.

Recette 7 : Bot Script (sans framework)

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

Execute un fichier JavaScript avec acces CDP direct via chrome.debugger. Aucune dependance externe.

Conseils

1. Si vous configurez un proxy, BotBrowser derive automatiquement le fuseau horaire, la locale et la geolocalisation. Ne remplacez que si necessaire.
2. Les flags CLI ont la priorite la plus elevee et remplacent les parametres du profil.
3. Utilisez --user-data-dir pour l'isolation entre instances concurrentes.
4. Consultez la Reference des flags CLI pour la liste complete.