Установка и настройка ApiServer

Интеграция Playwright в Mbbrowser поддерживает три основных языка программирования. Вы можете выбрать тот, который лучше всего подходит вашей команде. Процесс установки немного отличается для каждого из них.

---

Выберите язык программирования

TIP

• JavaScript (Node.js): Похож на Puppeteer; лаконичные скрипты. Рекомендуется для фронтенд-разработчиков.
• Python: Идеален для анализа данных и парсинга; Mbbrowser автоматически управляет виртуальной средой.
• Java: Отличный выбор для энтерпрайз-проектов или команд, уже работающих на стеке Java.

---

1. Среда JavaScript / TypeScript

1. Установите Node.js

Скачайте LTS версию (например, Node.js 20.x) с официального сайта Node.js. Поле установки проверьте версию в терминале:

node -v   # Должно быть v20.x.x или выше
npm -v

2. Создайте проект и установите Playwright

# Создайте папку проекта
mkdir mb-playwright && cd mb-playwright
# Инициализируйте проект npm
npm init -y
# Установите Playwright (только основную библиотеку)
npm install playwright

3. Установите axios (для вызовов ApiServer)

npm install axios

---

2. Среда Python

1. Установите Python

Скачайте Python 3.8+ с официального сайта. Обязательно отметьте ✅ Add Python to PATH при установке.

2. Виртуальная среда Playwright в Mbbrowser

IMPORTANT

Mbbrowser содержит встроенную независимую виртуальную среду для Playwright Python, расположенную в подпапке python\Playwright\ в директории установки программы.

При запуске через менеджер скриптов в клиенте Mbbrowser, программа активирует эту среду автоматически.

Для отладки в терминале вам нужно активировать её вручную:

cd "C:\Program Files (x86)\Mbbrowser_vX.X.X\python"
Playwright\Scripts\activate

3. Установите библиотеку

pip install playwright requests

---

3. Среда Java

1. Установите JDK

Скачайте JDK 11 или 17 с сайта Adoptium.

2. Драйверы Playwright Java в Mbbrowser

IMPORTANT

Mbbrowser поставляет необходимые JAR-файлы в папке lib\ директории установки. При запуске через клиент драйверы извлекаются и настраиваются автоматически.

3. Зависимости Maven (если используете)

<dependency>
  <groupId>com.microsoft.playwright</groupId>
  <artifactId>playwright</artifactId>
  <version>1.50.0</version>
</dependency>

---

4. Включение Mbbrowser ApiServer

IMPORTANT

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

Получение ключей доступа

1. Откройте клиент Mbbrowser и войдите в аккаунт.
2. Перейдите в «Личный кабинет» -> «Настройки API».
3. Получите или сгенерируйте ваши APP_ID и APP_KEY.

Запуск ApiServer

Запустите CMD от имени администратора и перейдите в папку установки Mbbrowser:

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

Параметр	Описание	Значение по умолчанию
--port	Порт прослушивания	8186
--app_id	ID авторизации	Из личного кабинета
--app_key	Ключ авторизации	Из личного кабинета
--hide	Скрывать браузер?	off (лучше оставить видимым для отладки)

---

5. Получение Session_ID среды

В главном окне Mbbrowser найдите нужную среду:

• Нажмите правой кнопкой мыши -> «Копировать ID среды (Session_ID)».
• Формат: 32-битная строка (например, 373808cb37bd63f5f7d92415e736e85f).

---

6. Как использовать ответ ApiServer (поле ws)

При вызове /api/v1/browser/start вы получите JSON, где поле data.ws является ключевым для Playwright. Это WebSocket-адрес протокола Chrome DevTools (CDP).

---

7. Чек-лист перед началом

• [ ] Установлен интерпретатор (JS/Python/Java).
• [ ] Установлена библиотека playwright.
• [ ] ApiServer запущен и доступен по адресу http://127.0.0.1:8186/.
• [ ] Скопирован Session_ID целевого профиля.

---

TIP

Готовы? В следующей главе Быстрый старт: подключение приведены полные готовые скрипты для всех трех языков.