Антидетект-браузеры и Qubix Connector

Qubix собирает данные из Facebook «глазами» ваших профилей в антидетект-браузере — так платформа видит рекламные кабинеты, кампании и страницы так, как их видит сам аккаунт, а не как запрос со стороны. Связующее звено между антидетект-браузером и Qubix — расширение Qubix Connector.

Расширение устанавливается один раз. Дальше оно само подключается к вашему антидетекту, забирает список профилей вместе с их прокси и держит связь с Qubix — от вас, как правило, не требуется вводить ничего.

Чем Qubix отличается от обычных парсеров

• Аккаунты живут дольше и реже улетают в бан — сбор идёт изнутри вашего профиля, без сторонних API, на которые Facebook реагирует блокировками.
• Данные остаются у вас — Qubix работает on-premise: не нужно отдавать ключи или подключать чужие приложения к вашему Facebook.
• Профили не нужно держать открытыми — сбор идёт сам, по расписанию, даже когда браузер закрыт.
• Команда — на автомате — администратор настраивает один раз, байерам делать ничего не нужно.
• 6 антидетектов из коробки — AdsPower, Dolphin Anty, Multilogin, GoLogin, Incogniton, Vision.

Почему это безопаснее для аккаунта

Обычные парсеры стучатся к Facebook «снаружи» — через сторонние API и токены доступа. Facebook замечает такие обращения первыми, и аккаунты за это улетают в бан. Сервисы-посредники идут ещё дальше: просят отдать им ключи или подключить их приложение к вашему Facebook — и ваша статистика с доступами оказывается на чужой стороне.

Qubix так не делает. Для Facebook это выглядит как обычная работа вашего аккаунта, а не сторонняя программа — никаких внешних запросов, ключей доступа или чужих приложений. Доступы и статистика никуда не уходят: всё остаётся только у вас, на вашей инфраструктуре.

Профиль можно не держать открытым

Антидетект-профиль не нужно держать запущенным постоянно. После того как Connector один раз передал сессию, Qubix продолжает собирать данные самостоятельно — по расписанию, даже когда профиль и браузер закрыты. Важно лишь, чтобы профиль оставался залогинен в Facebook; держать его открыть при этом не обязательно.

Это особенно удобно, когда профилей много: у байера их могут быть десятки — держать все открытыми ради сбора не нужно, Qubix обходит их сам.

Вмешательство потребуется редко — например, если профиль разлогинился в Facebook и сессию нужно обновить. Тогда Qubix сам предупредит в Telegram: и в общий канал ошибок сбора, и ответственного байера лично. Останется открыть профиль, войти заново — и сбор продолжится.

Чтобы Connector увидел ваш браузер

Connector связывается с локальным API антидетект-браузера на локальном порту. Для большинства браузеров Connector читает список профилей и их прокси прямо там; для некоторых (Dolphin Anty, GoLogin) локальный порт лишь подтверждает, что браузер запущен, а список профилей приходит из облачного API провайдера. В любом случае локальный API антидетекта должен быть включён.

В большинстве браузеров он включён по умолчанию. Если расширение сообщает, что браузер не найден или его API не отвечает, — откройте настройки антидетекта и включите локальный API (опция может называться Local API, API или Local API Server), чтобы браузер слушал свой локальный адрес и порт. Порт у каждого браузера свой — см. таблицу ниже.

Если на компьютере запущено сразу несколько антидетектов, в окне расширения нужно будет выбрать нужный.

В окне Connector видна стадия подключения: поиск → проверка API → профиль → проверка на сервере → ✓ Подключено.

Поддерживаемые браузеры

Браузер	Локальный API (порт)	Нужен API-ключ	Формат ключа
AdsPower	50325	Опционально	Bearer-токен
Dolphin Anty	3001	Да	Bearer-токен
Multilogin	45001	Да	email:password
GoLogin	36912	Да	Bearer-токен
Incogniton	35000	Нет	—
Vision	3030	Да	токен
Donut	10108	— (в разработке)	—

Совет

Порт в таблице — это адрес локального API браузера. Если Connector не подключается, проверьте, что в настройках антидетекта локальный API включён и слушает этот порт.

Работа без ключа

Двум браузерам API-ключ не нужен вовсе: Incogniton (у его локального API нет авторизации — он отдаёт полные профили, включая прокси) и AdsPower (он отдаёт идентификатор текущего профиля из URL его запуска — но только идентификатор; прокси, название и группа читаются лишь с ключом). Остальным ключ нужен.

API-ключ: когда нужен и где взять

• Без ключа Connector видит только текущий открытый профиль (а у большинства браузеров — не видит и его). Этого достаточно, если профиль уже известен Qubix (см. раздел «Быстрый путь»).
• С ключом расширение забирает у антидетекта все профили сразу — с прокси, названиями, группами и страной IP — и отправляет их в Qubix.

Ключ берётся в личном кабинете самого антидетект-браузера (раздел API / настройки) и вводится в окне расширения через переключатель Admin Mode: откройте попап → Admin Mode → вставьте ключ в поле API key (с названием вашего браузера, например «API key AdsPower»). Формат ключа для каждого браузера — в таблице выше.

Multilogin

У Multilogin вместо токена — пара email:password. Дополнительно в настройках профиля Mimic включите Port scan protection → Custom и впишите разрешённые порты 5030,45001 — иначе Connector не увидит ваши профили.

Быстрый путь: админ настраивает один раз

Самый удобный сценарий — когда вводить ключ каждому байеру не нужно вовсе.

Если администратор один раз подключит антидетект-браузер, в котором собраны профили команды, и введёт API-ключ — Connector прочитает весь список профилей (с прокси) и будет постоянно держать его актуальным в Qubix. После этого профили уже зарегистрированы на сервере.

Теперь любой байер, открыв свой профиль, попадает на быстрый путь: Qubix уже знает профиль и его прокси, расширение показывает компактное «✓ Подключено» — вводить ничего не надо. Ни ключа, ни прокси.

Рекомендуемый паттерн развёртывания

Полностью автоматический путь — когда байер не вводит ничего — работает на антидетектах, которым не нужен API-ключ: AdsPower и Incogniton. Для команды рекомендуем AdsPower — он самый распространённый и позволяет раздать расширение во все профили централизованно. У остальных (Dolphin, Multilogin, GoLogin, Vision) ключ вводится один раз в каждом профиле.

На AdsPower:

1. Администратор подключает AdsPower и вводит API-ключ — под учётной записью, где видны все профили команды. Connector считывает весь список профилей с прокси и регистрирует их в Qubix.
2. Расширение раздаётся централизованно — AdsPower позволяет добавить его сразу во все профили команды, ставить каждому байеру вручную не нужно.
3. Байеры подключаются сами — профиль уже известен Qubix, Connector показывает «✓ Подключено». Достаточно открытого залогиненного профиля.

Итог

AdsPower + ключ у администратора = вся команда работает «из коробки», без ключей и прокси на стороне байеров.

Что байеру нужно вводить вручную

Ручной ввод нужен только в трёх случаях.

1. Прокси не настроен

Если Qubix ещё не знает прокси профиля, расширение покажет «прокси не настроен». Задать прокси можно так:

• в окне расширения (байер) — строка socks5://user:pass@host:port → Сохранить;
• в настройках профиля антидетекта (байер) — задайте прокси и перезапустите профиль, Connector подтянет его сам;
• в Qubix, Настройки → Браузеры (администратор) — карточка профиля → Прокси → Редактировать (подробнее — Браузеры). Доступно после того, как профиль появился в списке (расширение отчиталось хотя бы раз); свежий профиль байер у себя может не видеть — привязка идёт по кампаниям.

Как только прокси задан любым из способов, профиль переходит на быстрый путь, и вводить его в расширении уже не нужно.

2. API-ключ

Если профиль ещё не известен серверу, а антидетект требует ключ для доступа к профилям. Вводится через Admin Mode (см. раздел «API-ключ» выше).

3. Localhost заблокирован

Если прокси профиля перехватывает в том числе локальные адреса, Connector не может прочитать идентификатор профиля. Разовое решение:

1. В настройках профиля антидетекта переключите прокси на «Без прокси» и сохраните.
2. Перезапустите профиль — Connector прочитает и запомнит идентификатор.
3. Верните прокси в настройках профиля и снова перезапустите.

После этого в окне расширения останется только вписать строку прокси и нажать Сохранить.

Что собирает расширение

Connector передаёт в Qubix данные профиля антидетекта: идентификатор, название, группу, строку прокси, IP и страну. Идентификатор профиля определяется автоматически — печатать его вручную нельзя (слишком велик риск опечатки). Если антидетект определить не удалось или у него нет ключа, Connector всё равно не оставляет вас в тупике: создаёт идентификатор сам и просит указать прокси — после Save сбор начинается. Сессию Facebook расширение использует уже открытую в профиле — отдельно логиниться в Qubix не нужно.

Подключение: коротко

1. Откройте Настройки → Браузеры и нажмите Скачать расширение.
2. Установите расширение в нужный профиль антидетект-браузера.
3. Убедитесь, что профиль залогинен в Facebook.
4. Откройте окно Connector и дождитесь «✓ Подключено». Если потребуется — введите ключ или прокси по подсказке.

Что дальше

• Браузеры — список профилей, статусы и управление парсингом.
• FB-парсер — как устроен сбор данных из Facebook.
• Подключить FB-парсер — пошаговый сценарий.