Документация

API и MCP работают на всех тарифах. Управлять можно из Playwright, Puppeteer или языковой модели.

Быстрый старт

Поставьте пульт, поднимите локальный API и создайте первый профиль. Ключ API берется из пульта.

установщик под Windows
локальный API на 127.0.0.1
MCP-сервер из коробки

nimbusx · start

$ nimbusx api start ✓ listening on 127.0.0.1:8080 $ curl 127.0.0.1:8080/profiles [ ] пока пусто

from nimbusx import connect p = connect(profile=384).new_page() p.goto("https://iphey.com")

{ "mcpServers": { "nimbusx": { "url": "http://127.0.0.1:8080/mcp" } } }

Создание профиля

Программа сама подбирает согласованный набор железа. Задать его снаружи нельзя: вы указываете только ядро и режим отпечатка.

nimbusx · profiles

$ nimbusx profiles create --engine chrome --fingerprint randomize ✓ profile #384 · RTX 3060 · Berlin · ready

p = connect().profiles.create( engine="chrome", fingerprint="randomize", ) # p.id -> 384

Запуск и подключение

Подключайтесь к профилю из Playwright или Puppeteer по CDP. У сессии свои куки и свой отпечаток.

nimbusx · connect

from playwright.sync_api import sync_playwright ws = connect(profile=384).cdp_url with sync_playwright() as pw: b = pw.chromium.connect_over_cdp(ws)

import puppeteer from "puppeteer" const ws = connect({ profile: 384 }).cdpUrl const b = await puppeteer.connect({ browserWSEndpoint: ws })

MCP-сервер

MCP-сервер работает на всех тарифах, включая бесплатный. Языковая модель управляет профилями напрямую: создать, запустить, проверить детекторами.

nimbusx · mcp

{ "mcpServers": { "nimbusx": { "url": "http://127.0.0.1:8080/mcp", "tools": ["profiles", "detectors", "proxy"] } } }

$ curl 127.0.0.1:8080/mcp/tools ✓ profiles.create · profiles.run · detectors.run

Переходник прокси

Встроенный переходник чинит прокси, которые зависают на обычном запросе браузера, и добавляет SOCKS5 с логином и паролем: в Chromium этого нет.

nimbusx · proxy

$ nimbusx proxy add --profile 384 socks5://user:pass@host:1080 ✓ relay up · CONNECT fixed $ curl --proxy socks5://127.0.0.1:1080 https://iphey.com ✓ verdict: trustworthy

Проверка детекторов

Проверки идут штатным кодом на свежем профиле. Полная история, включая неудачные попытки, поставляется вместе с программой.

nimbusx · detectors

$ nimbusx detectors run --profile 384 creepjs ok · sannysoft 0 fails · webrtc private_seen 0 ✓ 6/6 detectors passed

r = connect(profile=384).detectors.run() # r.passed -> 6, r.total -> 6