Яндекс Товары 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".

Содержание

• Быстрый старт
• Что можно поручить
• Как это работает
• Что может изменить данные
• Подключение и настройка
• Данные и телеметрия
• Ограничения
• Техническая документация
• Поддержка

Быстрый старт

Понадобятся Node.js 20 или новее, загруженный в Яндекс Товары YML-фид и логин Яндекса, под которым этот фид загружен. Сервер запускается через npx, поэтому отдельно устанавливать пакет не требуется.

1. Добавьте сервер в AI-приложение — ниже открыт пример для Codex, остальные приложения собраны в сворачиваемые инструкции.
2. Напишите: «Подключи Яндекс Товары». Ассистент даст ссылку на вход в Яндекс и попросит прислать код подтверждения. Если вы задали YANDEX_MERCHANTS_OAUTH_TOKEN в конфигурации, этот шаг не нужен.
3. Проверьте подключение: «Проверь подключение к Яндекс Товарам и покажи доступные фиды». Если сервер вернул список фидов, можно переходить к ценам и видимости товаров.

codex mcp add yandex-merchants -- npx -y mcp-yandex-merchants@latest

codex mcp list

claude mcp add --transport stdio --scope user yandex-merchants -- npx -y mcp-yandex-merchants@latest

claude mcp list

{
  "mcpServers": {
    "yandex-merchants": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-merchants@latest"]
    }
  }
}

{
  "mcpServers": {
    "yandex-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-merchants@latest"]
    }
  }
}

{
  "servers": {
    "yandex-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-merchants@latest"]
    }
  }
}

Это локальный 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 товаров и журнал изменений нужно хранить на своей стороне.

Что может изменить данные

Сервер снижает риск ошибок следующим образом: