MCP сервер для покупок в Ленте

Ближайшие магазины (хабы) Ленты по адресу или координатам. По одному хабу на формат: format=hyper — большой ассортимент, доставка обычно 2–4 часа; super — меньше товаров, доставка 15–60 мин; econom — Лента Эконом; zoo и alco — узкие витрины. Возвращает все хабы (id, aliasId, name, address, shopType, format, distance м), без выбора «одного правильного». Если пользователю важна скорость — super, если выбор — hyper. Адрес переводится в координаты.

Поиск товаров Ленты по текстовому запросу. Вход: query, address или storeId (aliasId из storefront_resolve_store), channel (lo, locc, дефолт lo), page. Limit 10/страница. Короткий ответ: storeId (aliasId), id, name, price (рубли, текущая), priceRegular (без скидки / без карты), priceType (card — price только по Карте №1, без карты будет priceRegular; promo — акция для всех; нет поля — обычная цена), discountPercent, stock, package, slug, url на lenta.com, image (одно фото), brand, rating и ratingCount если есть оценки, nutrition — состав/БЖУ одной свободной строкой как есть у Ленты (не разбито на белки/жиры/углеводы/ккал), если заполнен. Без storeId перебирает продуктовые хабы (super/hyper/econom) по расстоянию; пустой ассортимент — следующий. Зоо и алко — только если передан их storeId. Для развеса, ean и пути категории — storefront_product_details.

Карточка товара Ленты по id из storefront_products_search. Нужны id и address или storeId (aliasId из storefront_resolve_store), channel (lo, locc). Возвращает короткую карточку, url на lenta.com. price — текущая цена в рублях, priceRegular — без скидки / без карты; priceType=card — price только по Карте №1 (без карты будет priceRegular), priceType=promo — акция для всех, без priceType — обычная цена. category — путь витринной категории («корень / … / категория»), если она известна, и ean — основной штрихкод, если он есть. nutrition — состав/БЖУ одной свободной строкой как есть у Ленты (не разбито на белки/жиры/углеводы/ккал по отдельности), если он заполнен у товара. image — одно фото, brand — торговая марка, rating и ratingCount — оценка и число голосов, если есть. Если товар развесной (isWeight:true): saleLimit.{min,max,step} и stock — кванты корзины (не граммы; квант не всегда 1 кг), price — за фасовку weightGrams, pricePerKg — за килограмм (те же priceType/priceRegular); quantity в storefront_cart_link_create — целые кванты, кратные saleLimit.step, те же числа что saleLimit, не граммы. saleLimit.{minGrams,maxGrams,stepGrams} и quantityUnit — легаси, оставлены для совместимости (те же числа, что min/max/step; quantityUnit=g); используйте saleLimit.{min,max,step}.

Дерево категорий витрины Ленты. Вход: address или storeId (aliasId из storefront_resolve_store), channel (lo, locc), parentId опционально. Без parentId — всё дерево; с parentId — это узел и его потомки. Короткий ответ: storeId (aliasId), id, name, children. Полное дерево кэшируется 10 минут.

Список магазинов Ленты по витрине Витрина, дефолт lo: lo, utk, mntk, obi, remi, ulybka_radugi, smy, antares. Фильтры city и query опциональны. Limit 10/страница. Короткий ответ: id (код ТК), address, city, type, opensAt, closesAt, is24h, pickupAvailable, latitude, longitude. Для каталога storeId — aliasId из storefront_resolve_store.

Создаёт публичную ссылку на корзину Ленты Онлайн для оформления на lenta.com. Вход: items — массив {id, quantity>0}, id из storefront_products_search/storefront_product_details, от 1 до 100 позиций. Для развесных (isWeight в storefront_product_details) quantity — целые кванты, кратные saleLimit.step, те же числа что в карточке; не граммы и не «всегда килограммы». saleLimit.stepGrams — легаси, оставлен для совместимости, то же число что step; используйте step. Только витрина Лента Онлайн — другие бренды этот МСП не обслуживает. Ссылка не добавляет товары в существующую корзину получателя — открывает отдельный экран с предложением добавить их.