yandex-market-api

Установка

Скопируй репозиторий MissiaL/yandex-market-api в папку скиллов как yandex-market-api. Работая с API Маркета, сначала ищи методы через scripts/lookup_endpoint.py, а изменяющие запросы показывай мне до отправки.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл учит агента работать с партнерским API Яндекс Маркета для продавцов: каталог, цены, остатки, заказы, отгрузки, возвраты, отчеты и чаты с покупателями. В комплекте полная спецификация из официального репозитория Маркета и Python-скрипт, который показывает разделы, ищет методы по словам на русском и английском и выводит параметры конкретной операции. SKILL.md объясняет разницу между businessId и campaignId, выбор версии методов остатков в зависимости от групп складов, модели FBY, FBS, DBS и Express, курсорную пагинацию и коды ошибок, включая 420 при превышении лимита. Перед изменением цен, остатков и статусов заказов агент должен спросить подтверждение.

Для кого. Для продавцов Яндекс Маркета и разработчиков, которые пишут интеграцию с кабинетом продавца.

Пример запроса к агенту

Найди метод, чтобы передать остатки на Маркет для FBS-магазина, и собери запрос, но не отправляй его

Ограничения

Нужен Api-Key из кабинета продавца. Песочницы у API нет, изменяющие запросы сразу затрагивают живой магазин. Лимиты запросов в спецификации не видны, они есть только в документации Маркета. Спецификация закреплена в репозитории и устаревает, пока автор ее не обновит; скрипт пересборки, упомянутый в README, в репозиторий не входит. Лицензия не указана. В README нет инструкции по установке, скилл ставится ручным копированием папки.

Как отключить. Удалите папку yandex-market-api из каталога скиллов агента.

Проверка безопасности

• По инструкциям скилла агент может менять цены, остатки и статусы заказов в живом магазине
• У API нет песочницы
• Для работы нужен Api-Key кабинета продавца

Коротко о README

README коротко описывает состав репозитория: SKILL.md как точку входа, спецификацию партнерского API из официального репозитория Маркета с добавленными метками разделов и моделей размещения, плоский индекс методов и скрипт поиска. Отдельно сказано, что спецификация пересобирается внешним скриптом, для которого нужен Node.js. Инструкции по установке скилла в 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.

Похожие