5 дюймов
Каталог

Для разработчиков

API и MCP-сервер

Каталог 5 дюймов доступен программно: REST API для систем снабжения и 1С, MCP-сервер для ИИ-агентов. Один и тот же каталог, цены и наличие, что и на сайте. Для чтения каталога не нужен кабинет покупателя или секретный ключ. REST требует публичный ключ магазина из примера ниже; MCP читает каталог без ключа.

REST API

Базовый адрес
https://api.5dyuymov.ru
Доступ
публичный ключ магазина в заголовке x-publishable-api-key, значение ниже; чтение каталога без входа покупателя
Публичный ключ магазина
pk_daabb8b1033eb5ca1058a9ff3800f1cf60b5d560d8d097af6fb2f31966ba4060
Формат
JSON, UTF-8, цены в рублях с НДС 22 %, числовая сумма в рублях с точностью до копейки (например, 2631.73 — 2631 рубль 73 копейки)
Ошибки
стандартные коды HTTP; тело { type, message }
Версия
стабильная; изменения с обратной совместимостью
curl "https://api.5dyuymov.ru/store/meilisearch/products?query=затвор+ду+50+ру+16&limit=3" \
  -H "x-publishable-api-key: pk_daabb8b1033eb5ca1058a9ff3800f1cf60b5d560d8d097af6fb2f31966ba4060"

MCP-сервер

Адрес
https://5dyuymov.ru/api/mcp/mcp
Транспорт
Streamable HTTP; версии протокола 2024-11-05 … 2025-11-25
Доступ
каталог и подбор без ключей; корзина, доставка, заказы и бонусы покупателя — по OAuth 2.1 с PKCE; частота запросов ограничена
Версия сервера
0.4.1
Реестр
ru.5dyuymov/shop в реестре MCP

Claude Code

claude mcp add --transport http 5dyuymov https://5dyuymov.ru/api/mcp/mcp

Claude Desktop, Cursor и другие клиенты

{
  "mcpServers": {
    "5dyuymov": {
      "url": "https://5dyuymov.ru/api/mcp/mcp"
    }
  }
}

Маршруты REST

  • GET
    /store/products

    товары; фильтры q, category_id[], limit, offset; поля через fields

  • GET
    /store/products/{id}

    карточка товара с исполнениями и ценами

  • GET
    /store/meilisearch/products

    полнотекстовый поиск: query, понимает Ду и Ру, прощает опечатки

  • GET
    /store/variants-by-sku

    исполнения по списку артикулов: sku=a,b,c

  • GET
    /store/product-categories

    дерево разделов

  • GET
    /store/recommendations/{product_id}

    похожие товары и обвязка того же диаметра

  • POST
    /store/carts

    создать корзину; позиции — POST /store/carts/{id}/line-items

  • GET
    /store/shipping-options

    способы доставки для корзины: cart_id

  • POST
    /store/carts/{id}/complete

    оформить заказ

  • GET
    /store/orders/{id}

    заказ по идентификатору — владельцу (токен покупателя) или с подписью из ссылки на заказ: заголовок x-order-key или ?k=

  • POST
    /store/quotes

    запрос коммерческого предложения; требует сессию покупателя

Инструменты MCP

  • search_products

    поиск по каталогу, понимает Ду/Ру

  • get_product

    карточка: характеристики, исполнения, цены, артикулы

  • find_by_sku

    исполнения по списку артикулов с ценами

  • list_categories

    дерево разделов

  • get_recommendations

    похожие товары и обвязка того же диаметра

  • parse_spec

    спецификация текстом → позиции каталога с ценами

  • build_cart

    корзина из исполнений и ссылка для покупателя (нужен вход по OAuth)

  • estimate_delivery

    самовывоз и варианты доставки; тарифы ТК — только при подключённом расчёте, сейчас стоимость согласует менеджер (нужен вход по OAuth)

  • create_invoice_order

    заказ и заявка на счёт для юрлица; invoice_status: pending_manager или issued; invoice_payable: false до подтверждения менеджером, null после выдачи — условия оплаты смотрите в счёте; dry_run — проверка без оформления (нужен вход по OAuth)

  • suggest_accessories_for_cart

    обвязка ко всей корзине: фланцы, приводы, фильтры того же Ду с количеством

  • select_actuator

    подбор привода по Ду, моменту и фланцу ISO с запасом 30 %

  • my_orders

    заказы покупателя: номер, сумма, оплата, отгрузка, счёт (нужен вход по OAuth)

  • my_loyalty

    баланс бонусов, статус и доступное списание (нужен вход по OAuth)

  • reorder

    собрать корзину из позиций прошлого заказа (нужен вход по OAuth)

  • get_order

    статус заказа: оплата, отгрузка, состав

Страницы в markdown

Карточка товара или раздел отдаются текстом с заголовком Accept: text/markdown: характеристики, исполнения, артикулы и цены без вёрстки.

curl -H "Accept: text/markdown" "https://5dyuymov.ru/products/{handle}"

Обнаружение

  • /api/mcp/server-card — карточка сервера
  • /.well-known/ard.json — каталог ресурсов домена
  • /.well-known/oauth-authorization-server — метаданные авторизации
  • /llms.txt — описание сайта для языковых моделей

Условия и поддержка

  • Чтение каталога — свободно, для коммерческого использования данных напишите нам.
  • Заказы и корзины через API равнозначны заказам с сайта.
  • Вопросы по интеграции: страница контактов.