Спортмастер Маркетплейс через MCP: цены, остатки и требования на отгрузку без личного кабинета

Обзор

У продавцов на Спортмастер Маркетплейс данные о ценах, остатках и заказах живут в личном кабинете seller.sportmaster.ru — том же месте, куда нужно заходить руками, чтобы узнать, не кончился ли товар на складе или не зависла ли отгрузка. Спортмастер публикует открытое API для партнёров-продавцов (docsapi-seller.sportmaster.ru), и Mira подключает его целиком — 17 методов в двух разделах — через MCP-сервер, без личного захода в кабинет.

Что доступно продавцу

У Спортмастера заказ и отгрузка — одна сущность («требование на отгрузку»), а не два разных объекта, как у некоторых площадок: номер заказа — просто поле внутри неё.

Устройство, которое стоит знать заранее

Доступ — по паре, но не совсем client_credentials

Продавец получает apiKey в личном кабинете и меняет его на JWT-токен запросом с заголовком Client-ID (номер продавца). На первый взгляд это обычная схема, знакомая по Avito и Ozon Performance — но есть отличие: Client-ID нужен на каждом из 17 методов, а не только при обмене на токен. Из-за этого пара учётных данных устроена иначе, чем у площадок, где секрет обменивается на токен один раз и больше не нужен, — токен здесь обновляется на каждое обращение к API.

Барьер записи — без единого рубля

Из 17 методов 9 меняют данные: обновление цен и остатков, печать этикеток, сборка требования на отгрузку, работа с кодами маркировки, отмена отгрузки, создание партии и получение транспортных документов. Ни один из них не тратит деньги — в этом API нет платного продвижения вовсе, в отличие от Ozon, где рядом с продажами есть отдельный рекламный кабинет. Барьер здесь только про необратимость и видимость наружу: печать этикетки переводит отгрузку в статус, который курьерская служба уже видит, а отмена требования необратима.

Коды маркировки — юридический реквизит, а не опция

Для маркированных товаров каждый экземпляр в требовании на отгрузку нужно снабдить кодом маркировки — отдельными методами записи и удаления. Ошибка здесь блокирует отгрузку целиком, и в спецификации перечислены восемь разных причин отказа проверки кода — от несовпадения с GTIN до неверной структуры.

Как это выглядит через MCP

Какие товары заканчиваются на складе?

Claude запрашивает остатки по складу, сверяет с распроданными позициями и называет артикулы, которых скоро не будет в продаже.

Обновить цены по этому списку и подтвердить, когда применится

Claude создаёт задание на обновление цен, получает номер задания и — отдельным вызовом — проверяет его статус, когда оно обработается.

Что это даёт на практике

Продавцу. Остатки, цены и статус отгрузок одним вопросом в чате, без захода в кабинет.

Логисту. Список требований на отгрузку по складу и статусу, сборка упаковочных мест и создание партий — без переключения между разделами личного кабинета.

Разработчику. Готовый клиент вместо разбора спецификации и написания собственного обмена токена.

Как подключить

1. Личный кабинет продавца (seller.sportmaster.ru) → API.
2. Скопировать Client-ID (номер продавца) и apiKey.
3. В Mira: проект → источники → Спортмастер Маркетплейс → вставить оба значения.

Дальше Спортмастер Маркетплейс доступен и в чате Mira, и через MCP-сервер в Claude, Cursor или другом клиенте с поддержкой протокола.