> For the complete documentation index, see [llms.txt](https://docs.proxyshard.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.proxyshard.com/ua/nashi-produkti/shardx-launcher.md).

# ShardX Launcher

<mark style="color:purple;">**ShardX Browser**</mark> — це наш антидетект-браузер:

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

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

{% content-ref url="/pages/qSt7qdlvhtpuCku07MMN" %}
[ShardX Launcher](/ua/instrukciyi-z-vikoristannya/shardx-browser.md)
{% endcontent-ref %}

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

#### Що вміє ShardX:

* Генерує унікальні відбитки для <mark style="color:purple;">Windows</mark>, <mark style="color:purple;">macOS</mark> і <mark style="color:purple;">Linux</mark> (navigator, screen, client hints, WebGL / WebGPU тощо)
* Шум по окремих векторах: <mark style="color:purple;">canvas, WebGL, audio, client rects, шрифти, сенсори</mark>
* Необмежена кількість профілів, розкладених по папках
* Прив'язка проксі до профілю (<mark style="color:purple;">SOCKS5 / HTTP / HTTPS</mark>) з автотестом при додаванні
* Локальний **HTTP API** для повної автоматизації
* Управління через **CDP** (Chrome DevTools Protocol) — Puppeteer, Playwright та аналоги
* Експорт та імпорт cookies між профілями
* Окремий **MCP-сервер**, щоб профілем міг керувати ШІ-агент

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

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

{% hint style="info" %}
Відбиток генерується унікалізованим і не прив'язаний до заліза: кількість ядер CPU та обсяг RAM підганяються під хост і не завищуються, екран обрізається під реальний дисплей. Це знижує ризик виявлення на невідповідностях.
{% endhint %}

## Проксі, QUIC та WebRTC

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

* якщо UDP працює — вмикається <mark style="color:purple;">QUIC</mark>, а WebRTC ходить через проксований UDP-relay;
* якщо UDP недоступний — QUIC вимикається, а WebRTC примусово переводиться в режим **TCP-only**, щоб реальний IP не витік.

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

{% hint style="success" %}
Зв'язка ShardX + наші [**проксі з UDP**](/ua/nashi-produkti/about-udp.md) закриває витік WebRTC на рівні браузера: UDP-трафік іде через проксі, а не напряму з вашого IP. Детальніше про саму проблему — у розділі [**Про протокол UDP**](/ua/nashi-produkti/about-udp.md).
{% endhint %}

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

Всередині застосунку піднімається локальний HTTP-сервер на <mark style="color:purple;">**127.0.0.1**</mark> (порт за замовчуванням **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` — закрити профіль.

{% hint style="info" %}
**Тимчасові профілі.** `POST /profiles/temporary` створює профіль із прапором `temporary`: прихований із загального списку та інтерфейсу, а після закриття браузера видаляється автоматично (разом із папкою даних). Зручно для одноразових завдань.
{% endhint %}

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

{% hint style="warning" %}
CDP (remote-debugging) вмикається **лише** при запуску профілю через API. Запуски з інтерфейсу залишаються без відладочного порту — анти-детект не страждає.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.proxyshard.com/ua/nashi-produkti/shardx-launcher.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.