Настройка среды и конфигурация ApiServer

Прежде чем написать свою первую строчку кода на Selenium, нам нужно подготовить три вещи: среду Python, библиотеку Selenium и ApiServer Mbbrowser. Этот процесс занимает примерно 10 минут.

---

Шаг 1: Установка Python

Библиотека Selenium для Python требует версии 3.8 или выше.

Загрузка и установка

1. Перейдите на официальный сайт Python и скачайте версию 3.10 или 3.11 LTS (рекомендуется).
2. Во время установки обязательно отметьте:
   ✅ Add Python to PATH (Если этого не сделать, в дальнейшем будут возникать ошибки в командной строке!)
3. После установки откройте Командную строку (CMD), чтобы проверить:

python --version   # Должно вывести Python 3.10.x или выше
pip --version      # Должно вывести информацию о версии pip

NOTE

Если команда python не работает в Windows, вручную добавьте пути установки Python (например, C:\Python310\ и C:\Python310\Scripts\) в Системные переменные среды → Path.

---

Шаг 2: Установка библиотеки Selenium

Выполните следующую команду в CMD или PowerShell:

pip install selenium requests

• selenium: основная библиотека автоматизации.
• requests: используется для вызова HTTP-интерфейсов ApiServer Mbbrowser.

О ChromeDriver (Важно!)

Selenium 4.6+ поставляется с инструментом Selenium Manager, который автоматически скачивает ChromeDriver, соответствующий версии ядра вашего Mbbrowser.

Однако, поскольку Mbbrowser использует модифицированное ядро Chrome, версия может отличаться от официальной. Следуйте этим рекомендациям:

Способ А (Рекомендуемый): Использование chromedriver из комплекта Mbbrowser

В каталоге установки Mbbrowser обычно есть файл chromedriver.exe, путь к которому выглядит примерно так:

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

Укажите этот путь напрямую в вашем коде (подробнее в следующей главе).

Способ Б: Ручная загрузка

1. Зайдите в клиент Mbbrowser, перейдите в «Справка → О программе» и запишите версию ядра (например, Chrome 140).
2. Перейдите на страницу Chrome for Testing, чтобы скачать ту же версию chromedriver.
3. Поместите chromedriver.exe в папку вашего проекта или в каталог, указанный в PATH.

---

Шаг 3: Включение ApiServer Mbbrowser

Mbbrowser предоставляет интерфейсы для внешних скриптов через ApiServer.exe.

IMPORTANT

ApiServer должен быть включен, прежде чем скрипт сможет взаимодействовать с Mbbrowser! Не закрывайте окно терминала ApiServer.

Получение данных для аутентификации API

1. Откройте клиент Mbbrowser и убедитесь, что вы вошли в систему.
2. Перейдите в меню (слева вверху) → Личный кабинет → Настройки API.
3. Запишите ваши APP_ID and APP_KEY (если их нет, нажмите «Создать»).

Запуск ApiServer

Откройте CMD с правами администратора, перейдите в каталог установки Mbbrowser и запустите:

apiserver.exe --port=8186 --app_id=ВАШ_APP_ID --app_key=ВАШ_APP_KEY --hide=off

Описание параметров:

Параметр	Значение	Значение по умолчанию
--port	Порт, который слушает ApiServer	8186
--app_id	Ваш ID аутентификации (из личного кабинета)	-
--app_key	Ваш ключ аутентификации	-
--hide=off	off — окно браузера будет видно (удобно для отладки); on — фоновый режим	off

При успешном запуске в окне CMD появится:

ApiServer started at http://127.0.0.1:8186

Проверка статуса ApiServer

Откройте http://127.0.0.1:8186/ в браузере или Postman. Если вы видите страницу с документацией API, значит запуск прошел успешно.

---

Шаг 4: Получение Session_ID среды

Каждая среда Mbbrowser имеет уникальный Session_ID — шестнадцатеричную строку из 32 символов (например, 373808cb37bd63f5f7d92415e736e85f).

Как его получить:

1. Найдите нужную среду на главной панели Mbbrowser.
2. Нажмите правой кнопкой на среду и выберите Копировать ID среды (Session_ID).

---

Шаг 5: Рекомендуемая структура проекта

Мы рекомендуем создать отдельную папку для проекта:

my-mbbrowser-selenium/
├── start_selenium.py     ← Основной скрипт
├── config.py             ← Файл конфигурации (хранит API_URL, SESSION_ID и т.д.)
├── utils.py              ← Общие функции (запуск среды, скриншоты и т.д.)
└── requirements.txt      ← Список зависимостей

Содержимое requirements.txt:

selenium>=4.15.0
requests>=2.31.0

Другие участники команды могут установить зависимости командой:

pip install -r requirements.txt

---

Чек-лист настройки среды

Перед тем как перейти к следующей главе, убедитесь, что:

• [ ] Python 3.8+ установлен; команда python --version выдает верный результат.
• [ ] Установка pip install selenium requests завершена.
• [ ] Вы нашли путь к chromedriver.exe в папке Mbbrowser.
• [ ] ApiServer запущен, и адрес http://127.0.0.1:8186/ доступен.
• [ ] У вас есть Session_ID целевого профиля.

---

TIP

Все готово? Следующая глава Быстрый старт: Подключение поможет вам написать ваш первый рабочий скрипт!