dns-customer-mcp

MCP-сервер для DNS Shop (сторона покупателя): поиск, карточки товаров, отзывы, характеристики, каталоги, наличие по городу и список магазинов через Model Context Protocol.

Репозиторий: dns-customer-mcp. Имя MCP-сервера и Docker-образа совпадает.

Работает в Cursor, Claude Desktop, VS Code и других MCP-клиентах.

Зачем

У DNS нет публичного consumer API. Сайт защищён Qrator — анонимный curl/requests с датацентрового IP получает HTTP 401.

Этот сервер держит сессию anti-detect браузера Camoufox, один раз проходит JS-челлендж и дальше читает страницы через in-page fetch (часто с X-Requested-With: XMLHttpRequest → { html }) или DOM-парсинг. Цены и наличие зависят от города сессии.

Архитектура: Node MCP (stdio) → Python Camoufox.

Related MCP server: marketplace-mcp

Инструменты

Seller/offers маркетплейса нет — DNS один продавец. Q&A не реализован.

Город

По умолчанию анонимная сессия ≈ Москва (cookie current_path / city_path).

dns_get_location
dns_search_cities({ query: "Каз" })
dns_set_city({ city: "Казань" })
dns_product_availability({ product: id })

Идентификаторы

• Товар: 16-hex id (b7a1667f9b19ed20) или URL https://www.dns-shop.ru/product/{id}/

• Категория: slug из dns_list_categories — не выдумывать путь

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

git clone <repo> dns-customer-mcp
cd dns-customer-mcp
docker build -t dns-customer-mcp:latest .

MCP-конфиг (Docker)

Скопируйте docs/mcp.example.json в конфиг клиента или используйте .cursor/mcp.json:

{
  "mcpServers": {
    "dns-customer": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--init",
        "--stop-timeout=10",
        "--shm-size=1g",
        "--label", "dns-customer-mcp=1",
        "dns-customer-mcp:latest"
      ]
    }
  }
}

--shm-size=1g обязателен для браузера. Контейнер живёт пока открыт MCP-сеанс (--rm убирает его после выхода).

Локальный запуск (без Docker)

npm install
pip install -r python/requirements.txt
python -m camoufox fetch
npm start

Windows: задайте DNS_PYTHON=python при необходимости.

Переменные окружения

Разработка

npm test              # node:test — парсеры + config allowlist
npm run test:parse    # alias для npm test
npm run smoke:warmup    # Camoufox + Qrator
npm run discover        # снять XHR/DOM после warmup
npm run smoke           # search → details → specs → reviews
npm run smoke:location  # города (+ --set для смены)

Маршруты зафиксированы в src/dns/ по live discovery (Aug 2026):

• Cookie current_path: { city: UUID, cityName } (Москва = 30b7c1f3-03fb-11dc-95ee-00151716f9f5)

• /catalog/ + XHR → JSON { html, data, … }

• /search/ — in-page fetch (XHR часто 302); цены через POST /ajax-state/product-buy/

• Карточка товара — Vue SPA (hydrate wait) + meta/og fallback

• REST_API_URL из Pinia: https://restapi.dns-shop.ru (снаружи за Qrator)

• /product/characteristics/{id}/ может 404 — specs с карточки после hydrate

Парсер

• Плитка: точный класс .catalog-product

• Цена в SSR-HTML пустая — догрузка через AjaxState; в DOM — .product-buy__price (не рассрочка «от N ₽/мес»)

• При срыве селекторов — parser_drift: true, не price: 0

Разработка

Тесты и CI

npm test              # Node unit tests (parse, errors, bridge protocol, config parity)
npm run test:python   # pytest (config, locations, shared config parity)
npm run test:all      # оба набора
npm run lint          # ESLint (JS)
npm run lint:python   # Ruff (Python) — pip install -r python/requirements-dev.txt
npm run build:config  # проверка parity shared/config.json ↔ runtime
npm run build:selectors  # генерация python/dns_selectors.py из src/selectors.js

GitHub Actions (.github/workflows/test.yml): npm test, pytest, docker build на каждый push/PR.

Smoke-тесты (живой Camoufox + сеть):

npm run smoke
npm run smoke:warmup
npm run smoke:location
npm run discover

Discovery-скрипты

Одноразовые скрипты для reverse-engineering HTML/API DNS лежат в tools/discovery/ (не входят в CI). Основные smoke/discover — в scripts/.

Протокол Node↔Python: docs/bridge-protocol.md.

Переменные окружения (доп.)

Ограничения

• Только публичный каталог (не корзина / профиль / заказы)

• Без CDP к локальному Chrome и без Parse/Apify

• При бане Qrator — RU residential proxy через HTTPS_PROXY

Лицензия

MIT