ShardX Launcher

Антидетект-браузер ShardX з унікальними відбитками та локальним API для автоматизації профілів через Puppeteer / Playwright

ShardX Browser — це наш антидетект-браузер:

Завантажити та встановити

Покрокова інструкція по встановленню, налаштуванню проксі та створенню першого профілю:

ShardX Launcher

ви створюєте окремі профілі з унікальними відбитками (fingerprint), прив'язуєте до кожного свій проксі та працюєте з десятками акаунтів так, ніби це різні люди на різних пристроях. Поверх ручного режиму є локальне **API автоматизації**, через яке профілі можна створювати, запускати та керувати ними роботом із Puppeteer / Playwright.

Що вміє ShardX:

• Генерує унікальні відбитки для Windows, macOS і Linux (navigator, screen, client hints, WebGL / WebGPU тощо)

• Шум по окремих векторах: canvas, WebGL, audio, client rects, шрифти, сенсори

• Необмежена кількість профілів, розкладених по папках

• Прив'язка проксі до профілю (SOCKS5 / HTTP / HTTPS) з автотестом при додаванні

• Локальний HTTP API для повної автоматизації

• Управління через CDP (Chrome DevTools Protocol) — Puppeteer, Playwright та аналоги

• Експорт та імпорт cookies між профілями

• Окремий MCP-сервер, щоб профілем міг керувати ШІ-агент

Відбитки й анти-детект

Для кожного профілю ShardX підставляє узгоджений набір параметрів: User-Agent, платформу, кількість ядер та обсяг пам'яті (ніколи не більше реальної машини), роздільну здатність екрана, Sec-CH-UA тощо. Зверху накладається шум по окремих векторах — canvas, WebGL, audio, client rects, шрифти, сенсори. Кожен блок шуму вмикається незалежно, тому відбиток профілю стабільний у межах сесій, але відрізняється від інших профілів і від вашого реального пристрою.

Відбиток генерується унікалізованим і не прив'язаний до заліза: кількість ядер CPU та обсяг RAM підганяються під хост і не завищуються, екран обрізається під реальний дисплей. Це знижує ризик виявлення на невідповідностях.

Проксі, QUIC та WebRTC

ShardX особливо добре працює у зв'язці з нашими проксі. При кожному запуску профілю, ще до старту браузера, прив'язаний проксі перевіряється живцем на підтримку UDP-relay (SOCKS5 UDP_ASSOCIATE):

• якщо UDP працює — вмикається QUIC, а WebRTC ходить через проксований UDP-relay;

• якщо UDP недоступний — QUIC вимикається, а WebRTC примусово переводиться в режим TCP-only, щоб реальний IP не витік.

Поля часового поясу, локалі та геолокації в режимі auto також підтягуються живцем через проксі прямо на запуску.

Зв'язка ShardX + наші проксі з UDP закриває витік WebRTC на рівні браузера: UDP-трафік іде через проксі, а не напряму з вашого IP. Детальніше про саму проблему — у розділі Про протокол UDP.

Автоматизація: локальний API

Всередині застосунку піднімається локальний HTTP-сервер на 127.0.0.1 (порт за замовчуванням 40325, змінюється в Settings → Automation API). Ззовні він недоступний — лише з вашої машини.

Всі запити, крім GET /health, вимагають Bearer-токен (постійний JWT із налаштувань):

Authorization: Bearer <token>

Кнопка Regenerate token у налаштуваннях миттєво змінює секрет: новий токен починає працювати одразу, а всі старі стають недійсними.

Типовий сценарій автоматизації:

1. GET /fingerprint/new/{platform} — отримати готовий унікалізований відбиток (без збереження).

2. За бажанням — підправити відбиток (наприклад, увімкнути шум по шрифтах або змінити режим WebRTC).

3. POST /profiles — створити профіль із цим відбитком (зберігається як є, без повторної рандомізації) та прив'язати проксі.

4. POST /profiles/{id}/start — запустити профіль і отримати CDP-ендпоінт.

5. Підключитися як browserWSEndpoint = cdp.web_socket_debugger_url у Puppeteer / Playwright.

6. POST /profiles/{id}/stop — закрити профіль.

Тимчасові профілі. POST /profiles/temporary створює профіль із прапором temporary: прихований із загального списку та інтерфейсу, а після закриття браузера видаляється автоматично (разом із папкою даних). Зручно для одноразових завдань.

Повний опис усіх методів (профілі, відбитки, проксі, папки, cookies, запуск/зупинка) з моделями даних та прикладами — у довіднику ShardX Launcher API (розділ у лівому меню).

MCP-сервер для ШІ-агентів

У комплекті йде окремий MCP-сервер (Model Context Protocol): він дозволяє ШІ-клієнту керувати лаунчером через цей самий API, а браузером профілю — по CDP. Це окремий Node-процес, не частина HTTP API.

Завантажити його можна прямо з лаунчера (Settings → MCP server → Download MCP server). Налаштовується двома змінними: SHARDX_API (базовий URL API) та SHARDX_TOKEN (той самий Bearer-токен). MCP-сервер надає:

• API-інструменти — тонкі обгортки над методами лаунчера (профілі, відбитки, проксі, папки, cookies, запуск/зупинка);

• браузерні інструменти поверх CDP — навігація, виконання JS, скріншоти, кліки, введення тексту, робота з вкладками та очікування.

CDP (remote-debugging) вмикається лише при запуску профілю через API. Запуски з інтерфейсу залишаються без відладочного порту — анти-детект не страждає.