Gestion des profils BotBrowser : guide pratique

Que sont les profils BotBrowser ?

Un profil BotBrowser est un fichier chiffre (format .enc) qui definit une identite de navigateur complete. Chaque profil contient des valeurs coherentes pour la resolution d'ecran, le renderer WebGL, les polices, les proprietes du navigator et d'autres signaux du navigateur.

Lors du chargement d'un profil, le navigateur produit une sortie d'empreinte coherente correspondant a une configuration de dispositif reel.

Ou obtenir des profils

Le depot de profils BotBrowser propose des profils prets a l'emploi, regulierement mis a jour.

git clone https://github.com/botswin/BotBrowser-Profiles.git

Le binaire officiel utilise des fichiers .enc. Les binaires compiles localement utilisent le format .json brut.

Charger un profil unique

./chrome --bot-profile=/path/to/profiles/windows-chrome-131.enc

Le meme profil produit la meme sortie a chaque fois, utile pour maintenir une identite persistante entre les sessions.

Selection aleatoire de profil

Utilisez --bot-profile-dir pour selectionner aleatoirement un profil du repertoire a chaque lancement :

./chrome --bot-profile-dir=/path/to/profiles/

Organisez les profils par categorie :

profiles/
  windows-chrome/
    win-chrome-130.enc
    win-chrome-131.enc
  macos-chrome/
    mac-chrome-131.enc

Remplacements de configuration

Remplacez des valeurs specifiques du profil avec les flags --bot-config-* :

./chrome \
  --bot-profile=/path/to/profile.enc \
  --bot-config-timezone=Europe/London \
  --bot-config-locale=en-GB \
  --bot-config-languages=en-GB,en

Remplacements disponibles : --bot-config-browser-brand, --bot-config-timezone, --bot-config-locale, --bot-config-languages, --bot-config-location, --bot-config-webgl, --bot-config-webgpu, --bot-config-noise-canvas.

Bonnes pratiques

Utilisez des chemins absolus. Les chemins relatifs pour --bot-profile peuvent se resoudre incorrectement.

Format de profil selon le type de binaire. Le binaire officiel necessite .enc. Le binaire compile depuis les sources utilise .json.

Gardez les profils a jour. Telechargez les derniers profils regulierement.

Un profil par identite persistante. N'utilisez pas --bot-profile-dir pour les identites persistantes car la selection est aleatoire.

Etapes suivantes

• Demarrer avec Playwright pour l'integration d'automatisation
• Demarrer avec Puppeteer pour les workflows Puppeteer
• Recettes CLI pour des exemples de combinaisons de flags