Configuration et configuration de l'ApiServer

Avant d'écrire votre première ligne de code Selenium, nous devons préparer trois choses : l'environnement Python, la bibliothèque Selenium et l'ApiServer de Mbbrowser. Ce processus prend environ 10 minutes.

---

Étape 1 : Installer Python

Les liaisons Python pour Selenium nécessitent Python 3.8 ou plus.

Téléchargement et installation

1. Allez sur le site officiel de Python et téléchargez la version LTS 3.10 ou 3.11 (recommandée).
2. Pendant l'installation, assurez-vous de cocher :
   ✅ Add Python to PATH (Ne pas le faire entraînera des erreurs pour toutes les commandes suivantes !)
3. Une fois installé, ouvrez l'Invite de commandes (CMD) pour vérifier :

python --version   # Devrait afficher Python 3.10.x ou plus
pip --version      # Devrait afficher les informations sur la version de pip

NOTE

Si la commande python ne fonctionne pas sur Windows, ajoutez manuellement les répertoires d'installation de Python (ex : C:\Python310\ et C:\Python310\Scripts\) aux Variables d'environnement système → Path.

---

Étape 2 : Installer la bibliothèque Selenium

Exécutez la commande suivante dans CMD ou PowerShell :

pip install selenium requests

• selenium : La bibliothèque d'automatisation de base.
• requests : Utilisé pour appeler les interfaces HTTP de l'ApiServer de Mbbrowser.

À propos de ChromeDriver (Important !)

Selenium 4.6+ est livré avec Selenium Manager, qui télécharge automatiquement le ChromeDriver correspondant à la version du noyau de votre Mbbrowser.

Cependant, comme Mbbrowser utilise un noyau Chrome personnalisé, la version peut différer de celle du Chrome officiel. Suivez ces étapes :

Méthode A (Recommandée) : Utiliser le chromedriver inclus dans le répertoire d'installation de Mbbrowser

Il y a généralement un chromedriver.exe dans le répertoire d'installation de Mbbrowser, avec un chemin similaire à :

C:\Program Files (x86)\Mbbrowser_vX.X.X\chromedriver.exe

Spécifiez directement ce chemin dans votre code (détails dans le prochain chapitre).

Méthode B : Téléchargement manuel

1. Connectez-vous au client Mbbrowser, allez dans "Aide → À propos", et notez la version du noyau (ex : Chrome 140).
2. Allez sur Chrome for Testing pour télécharger la même version de chromedriver.
3. Placez chromedriver.exe dans votre répertoire de projet ou dans votre PATH.

---

Étape 3 : Activer l'ApiServer de Mbbrowser

Mbbrowser expose des interfaces aux scripts externes via ApiServer.exe.

IMPORTANT

L'ApiServer doit être activé avant que le script puisse communiquer avec Mbbrowser ! Ne fermez pas la fenêtre du terminal de l'ApiServer.

Obtenir les informations d'authentification API

1. Ouvrez le client Mbbrowser et assurez-vous d'être connecté.
2. Naviguez vers le menu en haut à gauche → Centre personnel → Paramètres API.
3. Notez votre APP_ID et APP_KEY (si vous n'en avez pas, cliquez sur "Générer").

Démarrer l'ApiServer

Ouvrez CMD avec les privilèges d'administrateur, entrez dans le répertoire d'installation de Mbbrowser et exécutez :

apiserver.exe --port=8186 --app_id=VOTRE_APP_ID --app_key=VOTRE_APP_KEY --hide=off

Description des paramètres :

Paramètre	Signification	Valeur par défaut
--port	Le port sur lequel l'ApiServer écoute	8186
--app_id	Votre ID d'authentification (depuis le centre personnel)	-
--app_key	Votre clé d'authentification	-
--hide=off	off signifie que la fenêtre du navigateur est visible (facile pour le débogage) ; on signifie le mode sans tête (headless)	off

Une fois le démarrage réussi, la fenêtre CMD affichera :

ApiServer started at http://127.0.0.1:8186

Vérifier l'état de l'ApiServer

Visitez http://127.0.0.1:8186/ dans votre navigateur ou via Postman. Si vous voyez la page de documentation de l'API, le démarrage a réussi.

---

Étape 4 : Obtenir le Session_ID de l'environnement

Chaque environnement Mbbrowser possède un Session_ID unique, qui est une chaîne hexadécimale de 32 caractères (ex : 373808cb37bd63f5f7d92415e736e85f).

Comment l'obtenir :

1. Trouvez l'environnement que vous souhaitez manipuler dans le panneau principal de Mbbrowser.
2. Faites un clic droit sur l'environnement et sélectionnez Copier l'ID de l'environnement (Session_ID).

---

Étape 5 : Structure de projet recommandée

Nous suggérons de créer un dossier de projet clair sur votre ordinateur :

mon-mbbrowser-selenium/
├── start_selenium.py     ← Script principal
├── config.py             ← Fichier de configuration (stocke API_URL, SESSION_ID, etc.)
├── utils.py              ← Fonctions utilitaires communes (Démarrer l'environnement, capture d'écran, etc.)
└── requirements.txt      ← Liste des dépendances

Contenu de requirements.txt :

selenium>=4.15.0
requests>=2.31.0

Les autres membres peuvent installer les dépendances simplement via :

pip install -r requirements.txt

---

Liste de contrôle de configuration de l'environnement

Avant de passer au chapitre suivant, assurez-vous que :

• [ ] Python 3.8+ est installé ; python --version s'affiche correctement.
• [ ] pip install selenium requests est terminé.
• [ ] Vous avez localisé le chemin de chromedriver.exe dans le répertoire Mbbrowser.
• [ ] L'ApiServer est démarré et http://127.0.0.1:8186/ est accessible.
• [ ] Vous avez obtenu le Session_ID de l'environnement cible.

---

TIP

Tout est prêt ? Le prochain chapitre Démarrage rapide : Connexion vous amènera à écrire votre premier script fonctionnel !