Yandex Merchants MCP server
MCP server for the Yandex Merchants partner API: feeds, offer prices, discounts, hide/unhide.
0 stars522 downloads/wk
Reviews
Write oneNobody has reviewed Yandex Merchants MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Yandex Merchants MCP tools (13, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
auth_statusПоказывает, подключены ли Яндекс Товары: есть ли токен, откуда он взят (переменная окружения YANDEX_MERCHANTS_OAUTH_TOKEN или сохранённый вход), когда истекает и где лежит файл с сохранёнными данными. Ничего не отправляет в сеть и не показывает сам токен. Вызовите это, если инструменты отвечают, что подключение не настроено; живую проверку доступа к API делает check_access.
check_accessДиагностика подключения: выполняет тот же GET /feeds-info и возвращает { ok, feedsCount } либо { ok: false, error }.
finish_loginВторой шаг подключения: обменивает код подтверждения из start_login на токен доступа, сохраняет его в файл только для владельца (0600) и сразу проверяет живым запросом к списку фидов. После успеха остальные инструменты работают немедленно — перезапускать клиент не нужно. Если фидов не видно, вход, скорее всего, выполнен не под тем логином (нужен тот, что загрузил YML-фид). Код одноразовый и живёт
hide_offerСкрывает одно предложение из Поиска по товарам (POST /hidden-offers), например когда товар закончился.
hide_offersМассово скрывает предложения из Поиска: от 1 до 500 за запрос (POST /hidden-offers).
list_feedsВозвращает список товарных фидов, доступных текущему OAuth-логину: { status, feeds: [{ feedId, feedUrl }] }.
logoutУдаляет сохранённый токен Яндекс Товаров с диска. Токен, заданный переменной окружения YANDEX_MERCHANTS_OAUTH_TOKEN, не трогает — его нужно убирать из конфигурации клиента вручную. Доступ, выданный приложению, остаётся активным на стороне Яндекса: отозвать его можно в Яндекс ID.
raw_requestЗапасной выход: прямой вызов любого пути партнёрского API Яндекс Товаров относительно базового URL
set_offer_discountУстанавливает скидку: price — цена со скидкой, discount_base — старая цена, которая покажется зачёркнутой
set_offer_priceИзменяет цену одного товарного предложения (POST /offer-prices/updates c одним элементом). Валюта всегда RUR — подставляется автоматически.
show_offersВозобновляет показ ранее скрытых предложений: от 1 до 500 за запрос (DELETE /hidden-offers с JSON-телом).
start_loginПервый шаг подключения Яндекс Товаров без правки конфигурации и без перезапуска клиента. Возвращает ссылку на страницу Яндекс OAuth. Покажите ссылку пользователю целиком и попросите: открыть её в браузере строго под тем логином Яндекса, под которым загружен YML-фид (токен другого логина не увидит ни одного фида), подтвердить доступ и прислать показанный код подтверждения. Токен выдаётся со scope p
update_offer_priceswrite actionМассово обновляет цены: от 1 до 2000 предложений одним запросом (POST /offer-prices/updates). Валюта всегда RUR.
Public scan report
scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it
- Code scan15 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 3 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
How Yandex Merchants MCP compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 82/100
- higher than 63% of 48,255 servers
- Tools
- 13
- the typical server has 7
- Tools that change things
- 8%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 522
- more than 89% of 12,191 servers with a package
What its tools let an agent do: 9 read · 3 change · 1 run or deploy
Release history: 2 versions in the registry since 2026-08-18, latest 2026-10-31, typically one every 74 days.
Install Yandex Merchants MCP in Claude Code, Cursor or VS Code
Runs npx -y mcp-yandex-merchants on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp-yandex-merchants -- npx -y mcp-yandex-merchants
What the publisher says
From the Yandex Merchants MCP repository's README, as published. We do not edit it. Read it on GitHub
Яндекс Товары 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, поэтому отдельно устанавливать пакет не требуется.
- Добавьте сервер в AI-приложение — ниже открыт пример для Codex, остальные приложения собраны в сворачиваемые инструкции.
- Напишите: «Подключи Яндекс Товары». Ассистент даст ссылку на вход в Яндекс и попросит прислать код подтверждения. Если вы задали YANDEXMERCHANTSOAUTH_TOKEN в конфигурации, этот шаг не нужен.
- Проверьте подключение: «Проверь подключение к Яндекс Товарам и покажи доступные фиды». Если сервер вернул список фидов, можно переходить к ценам и видимости товаров.
Codex
Через интерфейс приложения:
- Откройте 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 listShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Yandex Merchants MCP: common questions
- Is Yandex Merchants MCP server safe?
- Mostly: it is graded B (82/100). Read the Yandex Merchants MCP safety report
- How do I install Yandex Merchants MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Yandex Merchants MCP need an API key?
- Yes. The registry entry asks for
YANDEX_MERCHANTS_OAUTH_TOKEN. - Is Yandex Merchants MCP maintained?
- The last commit was 4 days ago (2026-10-31). The latest release is v1.2.1.
- How does Yandex Merchants MCP compare with other MCP servers?
- safety score 82/100 (higher than 63% of 48,255 servers); tools 13 (the typical server has 7); tools that change things 8% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.