ShardBrowser

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

Офіційний сайт: shardbrowser.com.

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

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

Що вміє ShardBrowser:

• Генерує унікальні відбитки для 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-сервер, щоб профілем міг керувати ШІ-агент

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

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

Проксі, QUIC та WebRTC

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

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

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

Автоматизація: локальний 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 - закрити профіль.

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

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, скріншоти, кліки, введення тексту, робота з вкладками та очікування.