API и MCP-сервер

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

REST API

Базовый адрес: https://api.5dyuymov.ru
Авторизация: заголовок x-publishable-api-key, значение ниже; чтение каталога без сессии
Ключ: pk_daabb8b1033eb5ca1058a9ff3800f1cf60b5d560d8d097af6fb2f31966ba4060
Формат: JSON, UTF-8, цены в рублях с НДС 22 %, целые копейки
Ошибки: стандартные коды 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}
заказ по идентификатору
POST
/store/quotes
запрос коммерческого предложения; требует сессию покупателя

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

search_products
поиск по каталогу, понимает Ду/Ру
get_product
карточка: характеристики, исполнения, цены, артикулы
find_by_sku
исполнения по списку артикулов с ценами
list_categories
дерево разделов
get_recommendations
похожие товары и обвязка того же диаметра
parse_spec
спецификация текстом → позиции каталога с ценами
build_cart
корзина из исполнений и ссылка для покупателя
estimate_delivery
самовывоз, доставка магазином, тарифы ТК по городу
create_invoice_order
заказ с оплатой по счёту для юрлица и ссылка на счёт; dry_run — проверка без оформления
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 равнозначны заказам с сайта.
Вопросы по интеграции: страница контактов.