yandex-market-api — скилл
Скилл для партнерского API Яндекс Маркета: официальная OpenAPI-спецификация, поиск нужного метода и разбор типичных ошибок интеграции
- 0 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- По инструкциям скилла агент может менять цены, остатки и статусы заказов в живом магазине
- У API нет песочницы
- Для работы нужен Api-Key кабинета продавца
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/yandex-market-apiОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- По инструкциям скилла агент может менять цены, остатки и статусы заказов в живом магазине
- У API нет песочницы
- Для работы нужен Api-Key кабинета продавца
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл учит агента работать с партнерским API Яндекс Маркета для продавцов: каталог, цены, остатки, заказы, отгрузки, возвраты, отчеты и чаты с покупателями. В комплекте полная спецификация из официального репозитория Маркета и Python-скрипт, который показывает разделы, ищет методы по словам на русском и английском и выводит параметры конкретной операции. SKILL.md объясняет разницу между businessId и campaignId, выбор версии методов остатков в зависимости от групп складов, модели FBY, FBS, DBS и Express, курсорную пагинацию и коды ошибок, включая 420 при превышении лимита. Перед изменением цен, остатков и статусов заказов агент должен спросить подтверждение.
Для кого. Для продавцов Яндекс Маркета и разработчиков, которые пишут интеграцию с кабинетом продавца.
Подходит, если
- Нужно найти правильный метод API и не попасть на устаревший
- Интеграция возвращает 403 или 404 из-за путаницы businessId и campaignId
- Нужно обновить остатки на Маркете и понять, какую версию методов выбрать
- Нужно подготовить запрос к отчетам, заказам или отзывам
Не подходит, если
- Вы торгуете на Ozon или Wildberries, а не на Маркете
- Нужен готовый MCP-сервер, который сам ходит в API без ручных запросов
Пример запроса к агенту
Найди метод, чтобы передать остатки на Маркет для FBS-магазина, и собери запрос, но не отправляй егоОграничения
Нужен Api-Key из кабинета продавца. Песочницы у API нет, изменяющие запросы сразу затрагивают живой магазин. Лимиты запросов в спецификации не видны, они есть только в документации Маркета. Спецификация закреплена в репозитории и устаревает, пока автор ее не обновит; скрипт пересборки, упомянутый в README, в репозиторий не входит. Лицензия не указана. В README нет инструкции по установке, скилл ставится ручным копированием папки.
Как отключить. Удалите папку yandex-market-api из каталога скиллов агента.
Частые вопросы
Чем campaignId отличается от номера магазина?
Это разные идентификаторы. По скиллу campaignId берется из GET /v2/campaigns или из раздела API и модули в кабинете, а номер магазина из интерфейса для запросов не подходит.
Агент будет читать всю спецификацию?
Нет. Файл большой, поэтому скилл велит искать нужные операции скриптом и читать только их.
Обсуждение
Вопросов и отзывов пока нет.
Справочник Partner API Яндекс Маркета
yandex-market-api-reference
Автообновляемый справочник Claude Code Skill по 165 методам Partner API Яндекс Маркета, собранный из официальной OpenAPI-спеки
MCP-сервер партнерского API Яндекс Маркета для продавца: заказы, возвраты, карточки, цены, отчеты, отзывы и чаты
MCP для продавцов Яндекс Маркета
mcp-server-yandex-market-seller
MCP-сервер и CLI для Partner API Яндекс Маркета: 131 действие по заказам, ценам, остаткам, отгрузкам и отзывам через паттерн поиска и выполнения
MCP для цен и видимости в Яндекс Товарах
A1 Яндекс Товары MCP
MCP-сервер меняет цены, скидки и видимость товаров в Яндекс Товарах точечно, без пересборки YML-фида, с проверкой полей и статуса перед записью
MCP-серверы для кабинетов продавца Wildberries, Ozon, Яндекс Маркета и Авито через официальные API с подтверждением записи
Скиллы продавца маркетплейсов поверх marketplaces-mcp-ru
seller-skills-ru
Шесть скиллов задачами, а не методами API: сверка остатков, выгрузка продаж, карточка товара, юнит-экономика, объявления на Авито и разбор прайса поставщика
Коротко о README
README коротко описывает состав репозитория: SKILL.md как точку входа, спецификацию партнерского API из официального репозитория Маркета с добавленными метками разделов и моделей размещения, плоский индекс методов и скрипт поиска. Отдельно сказано, что спецификация пересобирается внешним скриптом, для которого нужен Node.js. Инструкции по установке скилла в README нет.
Бейдж для README
Исходный SKILL.md
---
name: yandex-market-api
description: 'Use for seller integrations with Yandex Market (Яндекс Маркет): catalog, prices, stocks, orders, warehouses, returns, reports, and buyer communication. Triggers include "Yandex Market API", "API Яндекс Маркета", "остатки на Маркете", businessId, campaignId, and api.partner.market.yandex.ru.'
---
# Yandex Market Partner API
This skill helps you call the Yandex Market Partner API (`https://api.partner.market.yandex.ru`). It bundles the full OpenAPI 3.0 spec from the **official repository** (`github.com/yandex-market/yandex-market-partner-api`) — 155 paths / 165 operations.
The spec is ~1.4 MB. Don't read it whole — use the helpers described below to pull only what you need.
## Authentication — Api-Key header
The primary (and recommended) auth is a single header:
```http
Api-Key: <ключ>
```
The user creates keys in the seller cabinet: **иконка аккаунта → Настройки → API и модули → Авторизация через Api-Key**. Each key gets an access scope at creation (read-only / full / по разделам) — a read-only key gets `403` on mutating methods.
The spec also lists an **OAuth** scheme (scope `market:partner-api`) for apps acting on behalf of sellers — Yandex has been phasing it out in favor of Api-Key; only go there if the user explicitly builds a multi-seller app, and check the current official docs (`yandex.ru/dev/market/partner-api/doc/`) for the flow.
There is no sandbox host — this is the live cabinet. Test orders exist as a feature (`fake` order flags), but mutating calls hit the real store.
## businessId vs campaignId — the #1 source of confusion
Two different identifiers route every request:
- **`businessId`** — the cabinet («бизнес»). Paths like `/v2/businesses/{businessId}/...` operate on the shared catalog: offer-mappings (карточки), prices for all stores, promos, feedback, Q&A.
- **`campaignId`** — one store = one placement model inside the cabinet. Paths like `/v2/campaigns/{campaignId}/...` operate per-store: orders, stocks, store prices, shipments, outlets.
Get both from `GET /v2/campaigns` (each campaign carries its `business.id`). **`campaignId` is NOT the «номер магазина» shown in the cabinet UI** — the cabinet shows it under Настройки → API и модули → «Идентификатор кампании». Passing a shop number where a campaignId is expected yields 404/403.