Yandex Merchants MCP
This MCP server connects an AI app to the Yandex Merchants partner API for account auth, feed discovery, and targeted price/visibility changes on existing YML feeds.
Connect and manage Yandex Merchants OAuth login: check status, start/finish login, log out, and verify API access.
List available product feeds and get
feedIdvalues needed for changes.Change one offer’s price, including optional discount base and special payment-condition prices.
Update prices for up to 2,000 offers in one request.
Set a discount with a required old/struck-through price.
Hide one offer or up to 500 offers, optionally for up to 720 hours.
Restore visibility for up to 500 hidden offers.
Make arbitrary relative Yandex Merchants API requests via
raw_requestusing GET, POST, or DELETE.Validate inputs and API
statusresponses; it does not create/delete/reload feeds or read current feed/offer state.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Yandex Merchants MCP Покажи мои товарные фиды и поставь на товар SKU-123 цену 1490 ₽"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Яндекс Товары MCP
A1 Яндекс Товары MCP подключает AI-приложение к партнёрскому API Яндекс Товаров. Можно обычными словами менять цены, скидки и видимость отдельных товаров — без редактирования и повторной загрузки всего YML-фида. Подключение начинается прямо в диалоге: не нужно заранее создавать токен или редактировать конфигурацию.
13 готовых действий. Подключение аккаунта прямо из диалога, проверка доступа, список фидов, цены, скидки, скрытие и возврат товаров, а также прямой вызов остальных методов API.
Для одного товара и больших списков. За один запрос можно изменить цены у 2 000 товаров или скрыть и вернуть до 500 товаров.
Точечные изменения. Сервер работает с уже загруженным YML-фидом и не создаёт фиды заново.
Проверяемый результат. Запись считается успешной только при
status: "OK"в ответе Яндекс Товаров.Работает локально. Сервер запускается через
npx; OAuth-токен остаётся на вашем компьютере.
Попробуйте первым сообщением:
Проверь подключение к Яндекс Товарам и покажи доступные фиды.
Подключить сервер · Посмотреть сценарии · Открыть техническую документацию
Увидеть работу за минуту
Вы: Проверь подключение и покажи мои фиды.
Ассистент: Проверяет токен и показывает
feedIdи адрес каждого доступного фида.Вы: В фиде 1069 подготовь новую цену для SKU-123: 1 490 ₽ вместо 1 990 ₽. Сначала покажи изменение.
Ассистент: Подготовлено: фид 1069, товар SKU-123, новая цена 1 490 ₽, зачёркнутая цена 1 990 ₽. Отправить изменение?
Вы: Да, обнови.
Ассистент: Отправляет изменение и проверяет поле
statusв ответе. Операция завершена, если Яндекс Товары вернулиstatus: "OK".
Related MCP server: io.github.dontsovcmc/ozon-seller
Содержание
Быстрый старт
Понадобятся Node.js 20 или новее, загруженный в Яндекс Товары YML-фид и логин Яндекса, под которым этот фид загружен. Сервер запускается через npx, поэтому отдельно устанавливать пакет не требуется.
Добавьте сервер в AI-приложение — ниже открыт пример для Codex, остальные приложения собраны в сворачиваемые инструкции.
Напишите: «Подключи Яндекс Товары». Ассистент даст ссылку на вход в Яндекс и попросит прислать код подтверждения. Если вы задали
YANDEX_MERCHANTS_OAUTH_TOKENв конфигурации, этот шаг не нужен.Проверьте подключение: «Проверь подключение к Яндекс Товарам и покажи доступные фиды». Если сервер вернул список фидов, можно переходить к ценам и видимости товаров.
Через интерфейс приложения:
Откройте Settings → MCP servers.
Нажмите Add server.
Выберите STDIO, затем укажите команду запуска
npx -y mcp-yandex-merchants@latest.Нажмите Save, затем Restart.
Через командную строку:
codex mcp add yandex-merchants -- npx -y mcp-yandex-merchants@latestПроверьте подключение:
codex mcp listЗатем в чате Codex попросите: «Подключи Яндекс Товары».
claude mcp add --transport stdio --scope user yandex-merchants -- npx -y mcp-yandex-merchants@latestПроверьте сервер командой:
claude mcp listЗатем начните диалог с просьбы подключить Яндекс Товары.
Актуальный официальный путь — Settings → Extensions. Для пользовательского desktop extension откройте Advanced settings → Extension Developer → Install Extension…, выберите файл .mcpb и следуйте подсказкам.
Этот репозиторий сейчас публикует npm-пакет со stdio и пока не содержит .mcpb. Поэтому используйте приведённый ниже JSON stdio-конфиг как fallback только в сборках Claude Desktop, где ещё поддерживается локальная конфигурация:
{
"mcpServers": {
"yandex-merchants": {
"command": "npx",
"args": ["-y", "mcp-yandex-merchants@latest"]
}
}
}В таких сборках сохраните его в ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows.
После сохранения перезапустите Claude Desktop, откройте новый диалог и попросите подключить Яндекс Товары.
Для всех проектов создайте ~/.cursor/mcp.json (Windows: %USERPROFILE%\.cursor\mcp.json); только для текущего проекта — .cursor/mcp.json:
{
"mcpServers": {
"yandex-merchants": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-yandex-merchants@latest"]
}
}
}В чате Cursor сервер появится среди доступных инструментов. Попросите подключить Яндекс Товары и пройдите вход через Яндекс.
Откройте палитру команд и выполните MCP: Open User Configuration. Добавьте в mcp.json:
{
"servers": {
"yandex-merchants": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-yandex-merchants@latest"]
}
}
}Проверьте запуск командой MCP: List Servers, затем откройте чат и попросите подключить Яндекс Товары.
Это локальный MCP-сервер: приложение запускает
npxна вашем компьютере. Веб-версии ChatGPT и Claude сами по себе не могут запустить такой процесс — используйте настольное приложение, CLI или редактор с поддержкой локальных MCP-серверов.
Что можно поручить
Проверить подключение и выбрать фид
Проверить токен. Убедиться, что сервер видит аккаунт, —
check_access.Показать доступные фиды. Получить
feedIdи адрес каждого фида —list_feeds.
feedId понадобится для любого изменения. API не показывает состав фида, его статус и текущие значения товаров.
Изменить цены и скидки
Поменять цену одного товара —
set_offer_price.Обновить цены списком до 2 000 товаров за один запрос —
update_offer_prices.Задать скидку с новой и зачёркнутой ценой —
set_offer_discount.Добавить специальную цену для Яндекс Пэй, СБП или карты Ozon —
set_offer_price.
Цены передаются только в рублях. Если в одном фиде несколько предложений с одинаковым id, API изменит только первое.
Скрыть или вернуть товары
Скрыть один товар —
hide_offer.Скрыть до 500 товаров одной командой —
hide_offers.Вернуть до 500 товаров в показ —
show_offers.
Товар можно скрыть бессрочно или на срок до 720 часов. При бессрочном скрытии он останется невидимым до отдельной команды на возврат.
Вызвать остальные методы API
raw_request позволяет обратиться к методу партнёрского API, для которого нет отдельного готового действия. Он поддерживает GET, POST и DELETE и принимает данные в исходном формате API.
raw_requestможет изменить реальные данные. Если нужное действие уже есть среди готовых инструментов, безопаснее использовать его.
Полные названия полей, форматы ответов и коды ошибок собраны в справочнике инструментов.
Как это работает
Сервер не создаёт, не удаляет и не загружает фиды. Он берёт feedId уже существующего YML-фида и отправляет в Яндекс Товары точечные изменения для указанных товаров.
Это удобно, когда нужно быстро:
исправить одну или несколько цен;
поставить скидку;
скрыть закончившийся товар;
вернуть товар в показ.
Сам YML-фид по-прежнему управляется через кабинет Яндекс Товаров или Вебмастер. Содержимое фида сервер прочитать не может, поэтому id товаров и журнал изменений нужно хранить на своей стороне.
Что может изменить данные
Действие | Что происходит | Меняет данные |
| Проверяет токен и показывает id и адреса фидов | Нет |
| Меняет цену одного товара | Да |
| Меняет цены у 1–2 000 товаров | Да |
| Скрывает один или несколько товаров | Да |
| Возвращает скрытые товары в показ | Да |
| Выполняет выбранный вызов API | Зависит от метода |
Сервер снижает риск ошибок следующим образом:
проверяет обязательные поля, размеры списков, длину id, положительные цены и диапазон скидки до отправки запроса;
проверяет
statusв теле ответа, потому что HTTP 200 ещё не означает успешную запись;не повторяет запись автоматически после ошибки сервера или обрыва связи;
не позволяет
raw_requestотправить OAuth-токен на посторонний адрес;сообщает AI-приложению, какие действия читают данные, а какие их изменяют.
Подтверждение перед записью зависит от AI-приложения. Если хотите сначала проверить значения, попросите ассистента подготовить изменение, показать
feedId, id товара и новые значения, а выполнить его — только после следующей команды.
Подключение и настройка
Для обычного использования токен заранее не нужен:
В чате попросите подключить Яндекс Товары.
Откройте ссылку на Яндекс OAuth строго под тем логином Яндекса, под которым загружен YML-фид — токен другого логина не увидит ни одного фида.
Подтвердите доступ и пришлите код ассистенту. Код одноразовый и действует 10 минут.
Сервер использует PKCE: код из чата сам по себе нельзя обменять на токен — это может сделать только ваш запущенный сервер. Он запрашивает единственное право — products:partner-api («API поиска по товарам»). Полученный токен хранится локально в ~/.config/mcp-yandex-merchants/credentials.json с правами только для владельца и продлевается автоматически. Перезапускать AI-приложение после входа не нужно.
Проверить состояние — попросите «покажи статус подключения», отключить — «отключи Яндекс Товары». Выданный доступ отзывается в Яндекс ID.
Для CI и нестандартных установок доступна настройка через переменные окружения:
Переменная | Назначение |
| Готовый OAuth-токен с доступом |
| ClientID собственного OAuth-приложения для входа из диалога вместо приложения A1 по умолчанию. |
| Корневой адрес API; по умолчанию |
| Таймаут одного запроса; по умолчанию 60 000 мс. |
| Число повторов при |
Если используете собственное OAuth-приложение, зарегистрируйте его на oauth.yandex.ru/client/new (платформа «Веб-сервисы», Redirect URI https://oauth.yandex.ru/verification_code) и добавьте доступ products:partner-api — «API поиска по товарам». Готовый токен для YANDEX_MERCHANTS_OAUTH_TOKEN выдаёт страница https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID>, открытая под логином, который загрузил YML-фид. Храните токен как пароль: не добавляйте конфигурацию с реальным токеном в Git и не отправляйте её посторонним.
Данные и телеметрия
Сервер запускается на вашем компьютере и напрямую обращается к https://yandex.ru/products/api/ext/partner. OAuth-токен добавляется только к запросам этого API: даже raw_request принимает относительный путь и не может отправить токен на другой сайт. При входе из диалога сервер дополнительно обращается к oauth.yandex.ru — только чтобы обменять код подтверждения на токен и продлевать его.
По умолчанию сервер отправляет на usage.gistrec.cloud анонимную техническую телеметрию: случайный идентификатор установки, имя события или инструмента, версию пакета, версию Node.js, ОС и сведения о подключившемся AI-клиенте. В неё не попадают OAuth-токен, данные аккаунта, id фидов и товаров, цены, аргументы инструментов и тексты запросов. При вызове инструмента сервер также отправляет его исход, а при ошибке - фрагмент её текста: код и сообщение, в которых e-mail, адреса, токены, числа от 4 цифр и текст в кавычках заменены на «#». Если в тексте ошибки есть значение из запроса, оно тоже может попасть во фрагмент. Отправка выполняется в фоне и не влияет на работу сервера.
Чтобы отключить телеметрию для MCP-серверов A1, задайте переменную окружения:
ASKADS_TELEMETRY=0Ограничения
Нельзя прочитать текущее состояние товаров. API не возвращает текущие цены, список скрытых товаров, содержимое или статус фида. Храните журнал изменений на своей стороне.
Нельзя управлять самими фидами. Создать, удалить или перезагрузить YML-фид можно только в кабинете или Вебмастере.
Только рубли. Другие валюты API не принимает.
Id товара — до 50 символов. Более длинный идентификатор API не примет.
До 2 000 цен за запрос. Для скрытия и возврата — до 500 товаров за запрос.
До 50 000 операций в минуту. Отдельно считаются изменения цен и общая сумма скрытий с возвратами.
Нет автоматического отката. После обрыва связи результат записи может остаться неизвестным, а прочитать состояние через этот API нельзя. Не повторяйте такую операцию автоматически.
Нет постоянного наблюдения. Сервер работает только тогда, когда AI-приложение вызывает его. Если приложение поддерживает задания по расписанию, можно попросить его периодически проверять доступ или выполнять заранее заданный сценарий.
Техническая документация
Каталог MCP-возможностей — страницы по пользовательским задачам для каждого инструмента.
Все инструменты — параметры, ответы, коды ошибок и ограничения.
Документация по разработке — локальный запуск, проверки и сборка.
Публикация — выпуск npm-пакета и публикация в каталогах MCP.
Поддержка
Нашли ошибку или не хватает сценария? Создайте issue или напишите в Telegram.
Available Tools
13 toolsauth_statusСтатус подключения к Яндекс ТоварамARead-onlyIdempotent
Показывает, подключены ли Яндекс Товары: есть ли токен, откуда он взят (переменная окружения YANDEX_MERCHANTS_OAUTH_TOKEN или сохранённый вход), когда истекает и где лежит файл с сохранёнными данными. Ничего не отправляет в сеть и не показывает сам токен. Вызовите это, если инструменты отвечают, что подключение не настроено; живую проверку доступа к API делает check_access.
Inputs: no named parameters.
check_accessПроверка токена и доступаARead-onlyIdempotent
Диагностика подключения: выполняет тот же GET /feeds-info и возвращает { ok, feedsCount } либо { ok: false, error }. Отдельного ping-эндпоинта в API нет. Если ok: false — проверьте, что OAuth-токен выдан со scope products:partner-api под тем логином, который загружал фид, и что права на сайт подтверждены в Вебмастере (API открывается через несколько часов после подтверждения).
Inputs: no named parameters.
finish_loginЗавершить подключение Яндекс ТоваровAIdempotent
Второй шаг подключения: обменивает код подтверждения из start_login на токен доступа, сохраняет его в файл только для владельца (0600) и сразу проверяет живым запросом к списку фидов. После успеха остальные инструменты работают немедленно — перезапускать клиент не нужно. Если фидов не видно, вход, скорее всего, выполнен не под тем логином (нужен тот, что загрузил YML-фид). Код одноразовый и живёт 10 минут: если он не принят, вызовите start_login заново и попросите свежий.
Inputs: code (required).
hide_offerСкрыть предложение из ПоискаA
Скрывает одно предложение из Поиска по товарам (POST /hidden-offers), например когда товар закончился. ttl_in_hours — необязательный срок скрытия в часах (максимум 720 = 30 дней, иначе ошибка INVALID_TTL); что делает повторное скрытие с новым ttl, дока API не описывает. Без ttl предложение скрыто до явного show_offers. Ответ API: { status: "OK" } либо { status: "ERROR", errors: [{ code, message }] }. Прочитать список уже скрытых предложений через API нельзя. Лимит: 50 000 операций скрытия/показа в минуту.
Inputs: feed_id (required), offer_id (required), ttl_in_hours.
hide_offersМассовое скрытие предложенийA
Массово скрывает предложения из Поиска: от 1 до 500 за запрос (POST /hidden-offers). Общий ttl_in_hours (максимум 720 часов) применяется ко всем предложениям запроса. Ответ API: { status: "OK" } либо { status: "ERROR", errors: [...] }; коды: DUPLICATE_OFFER, INVALID_FEED_ID, INVALID_OFFER_ID, INVALID_TTL, LIMIT_EXCEEDED, REQUEST_LIMIT_EXCEEDED (больше 500 в запросе). Лимит: 50 000 операций скрытия/показа в минуту (общий с show_offers).
Inputs: offers (required), ttl_in_hours.
list_feedsСписок товарных фидовARead-onlyIdempotent
Возвращает список товарных фидов, доступных текущему OAuth-логину: { status, feeds: [{ feedId, feedUrl }] }. Точка входа для всех остальных инструментов — их параметр feed_id берётся из feedId этого ответа. Больше API про фиды ничего не отдаёт: ни статуса фида, ни списка предложений (создание/удаление фида — только через кабинет или Вебмастер).
Inputs: no named parameters.
logoutОтключить Яндекс ТоварыADestructive
Удаляет сохранённый токен Яндекс Товаров с диска. Токен, заданный переменной окружения YANDEX_MERCHANTS_OAUTH_TOKEN, не трогает — его нужно убирать из конфигурации клиента вручную. Доступ, выданный приложению, остаётся активным на стороне Яндекса: отозвать его можно в Яндекс ID.
Inputs: no named parameters.
raw_requestПрямой вызов Merchants APIA
Запасной выход: прямой вызов любого пути партнёрского API Яндекс Товаров относительно базового URL (https://yandex.ru/products/api/ext/partner), например "feeds-info" или "offer-prices/updates". Методы API: GET (feeds-info), POST (offer-prices/updates, hidden-offers), DELETE (hidden-offers). body отправляется как JSON в готовом wire-формате API (например { offers: [...] } или { hiddenOffers: [...] }) — без преобразований.
Inputs: path (required), body, method.
set_offer_discountУстановить скидку на товарAIdempotent
Устанавливает скидку: price — цена со скидкой, discount_base — старая цена, которая покажется зачёркнутой (тот же POST /offer-prices/updates, но discount_base обязателен). Скидка должна быть не меньше 5% и не больше 95% — проверяется до запроса, иначе API вернёт 400 Bad Request. Валюта всегда RUR. Ответ API: { status: "OK" } либо { status: "ERROR", errors: [...] }.
Inputs: price (required), feed_id (required), offer_id (required), discount_base (required).
set_offer_priceИзменить цену предложенияAIdempotent
Изменяет цену одного товарного предложения (POST /offer-prices/updates c одним элементом). Валюта всегда RUR — подставляется автоматически. Опционально: discount_base — цена до скидки (покажется зачёркнутой; скидка должна попадать в 5–95%, иначе API вернёт 400), pay_by_price + pay_by_condition (только парой, вместе) — спеццена при условии оплаты. Ответ API: { status: "OK" } либо { status: "ERROR", errors: [{ code, message }] } — проверяйте status. Если в фиде несколько предложений с одинаковым id, цена обновится только у первого. Лимит: 50 000 изменений цен в минуту.
Inputs: price (required), feed_id (required), offer_id (required), pay_by_price, +2 more.
show_offersВозобновить показ предложенийAIdempotent
Возобновляет показ ранее скрытых предложений: от 1 до 500 за запрос (DELETE /hidden-offers с JSON-телом). Ответ API: { status: "OK" } либо { status: "ERROR", errors: [...] }; коды: DUPLICATE_OFFER, INVALID_FEED_ID, INVALID_OFFER_ID, REQUEST_LIMIT_EXCEEDED. Лимит: 50 000 операций скрытия/показа в минуту (общий с hide_offers).
Inputs: offers (required).
start_loginНачать подключение Яндекс ТоваровARead-onlyIdempotent
Первый шаг подключения Яндекс Товаров без правки конфигурации и без перезапуска клиента. Возвращает ссылку на страницу Яндекс OAuth. Покажите ссылку пользователю целиком и попросите: открыть её в браузере строго под тем логином Яндекса, под которым загружен YML-фид (токен другого логина не увидит ни одного фида), подтвердить доступ и прислать показанный код подтверждения. Токен выдаётся со scope products:partner-api. Полученный код передайте в finish_login. Код действует 10 минут. Сам по себе код бесполезен для постороннего: обменять его может только этот сервер.
Inputs: no named parameters.
update_offer_pricesМассовое обновление ценAIdempotent
Массово обновляет цены: от 1 до 2000 предложений одним запросом (POST /offer-prices/updates). Валюта всегда RUR. Ответ API: { status: "OK" } либо { status: "ERROR", errors: [{ code, message }] }; возможные коды: DUPLICATE_OFFER, INVALID_FEED_ID, INVALID_OFFER_ID, LIMIT_EXCEEDED, REQUEST_LIMIT_EXCEEDED (больше 2000 в запросе). Лимит: 50 000 изменений цен в минуту. Для больших объёмов разбивайте на несколько вызовов.
Inputs: offers (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Most tools have clear and distinct purposes: auth flow, feed listing, price updates, and offer visibility. The main ambiguity is between list_feeds and check_access, which both call the same endpoint, and set_offer_price vs set_offer_discount overlap partially since the price update tool already accepts a discount_base parameter.
Tool names generally follow a verb_noun pattern with snake_case: start_login, finish_login, list_feeds, set_offer_price, hide_offer, show_offers. Minor inconsistencies exist between set_offer_price and update_offer_prices, and singular/plural pairing is not fully symmetric (hide_offer/hide_offers but only show_offers), plus raw_request is a deliberate fallback outlier.
13 tools is well within the ideal range for this domain. Each tool addresses a distinct part of the workflow: authentication, diagnostics, feed listing, price updates, and offer hiding/showing, with bulk and single-item variants justified by operational limits.
The core workflows are covered: OAuth login/logout, feed discovery, price and discount updates, and offer visibility control. Some gaps exist, such as no way to read the hidden-offers list and no feed creation/deletion, but these appear to be API limitations rather than server omissions, and raw_request provides an escape hatch.
Maintenance
Related MCP Connectors
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
Hosted Shopify MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server for Yandex Metrica analytics: query web analytics metrics, goals, conversions, and raw API data using natural language from AI clients like Claude and Cursor.8708 npm5MIT
- AlicenseAqualityDmaintenanceMCP server for Ozon Seller API, enabling product, order, finance, and analytics management via natural language or CLI.32MIT
- AlicenseAqualityDmaintenanceMCP server for Wildberries Seller API enabling management of products, orders, supplies, analytics, advertising, and finance through natural language commands.32MIT
- AlicenseAqualityDmaintenanceMCP server for Yandex Eats Vendor Management API, enabling AI agents to manage partner operations like orders, busy mode, menu import, and feedback.116 npmMIT