Описание
yandex-market-api-reference — скилл-справочник по Partner API Яндекс Маркета для Claude Code: 165 методов — полный охват актуальной версии API, автообновление — справочник пересобирается из официальной документации, поиск по назначению — агент находит нужный метод по задаче, а не листает документацию руками. Для интеграторов и разработчиков, связывающих свои системы с Маркетом.
Что умеет:
— покрывать 165 методов API;
— обновляться из официальной документации;
— искать метод по задаче;
— экономить время на чтении доков.
Полная документация ниже — автоматически из репозитория mkrvas/yandex-market-api-reference (ветка master). Оригинальные материалы проекта распространяются на условиях его лицензии.
yandex-market-api-reference
Неофициальный справочник по Partner API Яндекс Маркета для продавцов
в формате Claude Code Skill: 6 файлов общей
инфраструктуры (авторизация и доступы, лимиты, ошибки, пагинация, асинхронные отчёты,
API-уведомления) + 11 файлов по разделам API со всеми 165 методами, их лимитами,
доступами Api-Key и поддерживаемыми моделями работы (FBY / FBS / Экспресс / DBS / LaaS).
Что это такое
Не SDK и не клиент, а структурированная markdown-документация, которую
Claude Code подгружает в контекст по запросу — чтобы
отвечать про пути, параметры и лимиты методов Маркета, не выдумывая их.
Таблицы методов не написаны руками: они генерируются из официальной
OpenAPI-спецификации
и страниц документации Яндекса (лимиты и доступы живут только там). Рукописная часть —
объяснения, нюансы и грабли — лежит вне автозон и генератором не трогается.
Установка
git clone https://github.com/mkrvas/yandex-market-api-reference.git ~/.claude/skills/ym-api
Claude Code подхватит скилл автоматически: он срабатывает на вопросы про API Яндекс Маркета,
модели работы, лимиты и на проектирование интеграции с Маркетом.
Структура
| Файл | Содержание |
|---|---|
| SKILL.md | Точка входа: когда использовать, навигация, быстрый справочник |
| references/00-overview.md | Хост, версии, Api-Key, 15 доступов, businessId vs campaignId, модели работы |
| references/01-limits.md | Глобальные, ресурсные и функциональные лимиты, заголовки X-RateLimit-* |
| references/02-errors.md | HTTP-коды, формат errors[], что ретраить |
| references/03-pagination.md | pageToken / limit |
| references/04-reports-async.md | Асинхронные отчёты и документы |
| references/05-notifications.md | API-уведомления (push) |
| references/10…20-*.md | Разделы API: товары, цены, остатки, заказы, отгрузки, возвраты, отчёты, продвижение, коммуникации, статистика, справочники |
| references/99-autoreport-mapping.md | Маппинг метрик стороннего проекта на методы Маркета (пример прикладного использования) |
| data/methods.json | Машинный снимок: 165 методов с лимитами, доступами и моделями |
Как обновляется
GitHub Actions (ежедневно 03:40 UTC)
└─ scripts/fetch_spec.py спека (zip репозитория) + 165 страниц документации → data/methods.json
└─ scripts/generate_tables.py перезапись только зон <!-- AUTO:BEGIN section=… --> … <!-- AUTO:END -->
└─ scripts/check_drift.py дифф со снимком в HEAD → тело pull request
└─ PR «Partner API обновился — YYYY-MM-DD» на ревью человеку
Принципы:
- All-or-nothing. Не скачалась хотя бы одна страница метода — снимок не переписывается.
Иначе методы «исчезали» бы из справочника из-за сетевого сбоя. - Рукописное неприкосновенно. Генератор работает только внутри маркеров.
- Новый раздел в спеке — это ошибка сборки, а не тихое игнорирование: значит у Яндекса
появилось семейство методов, которое надо разложить по файлам руками. - Merge PR делает человек: если Яндекс поменяет формат страниц, дифф это покажет.
Локально:
python3 scripts/sync.py # насколько отстали от GitHub
python3 scripts/sync.py --pull # подтянуть (fast-forward)
python3 scripts/fetch_spec.py # снять свежий снимок вручную
python3 scripts/generate_tables.py # перегенерировать таблицы
python3 -m pytest tests -q # тесты конвейера
Источники
- Документация: https://yandex.ru/dev/market/partner-api/doc/ru/
- OpenAPI-спецификация: https://github.com/yandex-market/yandex-market-partner-api
- Индекс страниц документации в markdown: https://yandex.ru/dev/market/partner-api/doc/ru/llms.txt
Проект не связан с Яндексом. Первоисточник всегда прав: если справочник расходится
с документацией — верь документации и заведи issue.
Лицензия
MIT — см. LICENSE.