Описание
wb-seller-api-reference — справочник WB Seller API для Claude Code: 18 семейств эндпоинтов — весь API в структурированном виде, хосты и лимиты — какой запрос куда и с какими ограничениями, каталог ошибок — что отвечает API и что с этим делать, поиск по задаче — агент находит нужный метод по описанию проблемы. Для интеграторов и селлеров со своей аналитикой на WB.
Что умеет:
— покрывать 18 семейств эндпоинтов;
— подсказывать хосты и лимиты;
— расшифровывать ошибки API;
— искать метод по задаче.
Полная документация ниже — автоматически из репозитория mkrvas/wb-seller-api-reference (ветка master). Оригинальные материалы проекта распространяются на условиях его лицензии.
wb-seller-api-reference
Неофициальный справочник по Wildberries Seller API в формате Claude Code Skill — 5 файлов с общей инфраструктурой (авторизация, rate limits, ошибки, пагинация, асинхронные отчёты) + 18 файлов по семействам API (Content, Marketplace, Statistics, Finance, Analytics, Prices & Discounts, Advertising, Feedbacks, Tariffs, Chat, Returns, Documents, Calendar, Orders DBW, Orders DBS, Самовывоз, WBD, Supplies FBW) с эндпоинтами, параметрами, лимитами и типичными граблями.
Что это такое
Это не код и не SDK — это структурированная markdown-документация, которую Claude Code подгружает себе в контекст по запросу, чтобы отвечать на вопросы про WB API или помогать проектировать интеграцию, не выдумывая пути и параметры эндпоинтов.
Формат "Skill" — папка с файлом SKILL.md (описание + триггеры + навигация) и подпапкой references/ с детальными файлами, которые подгружаются по необходимости, а не все разом.
Установка
Скопируйте эту папку в ~/.claude/skills/:
git clone https://github.com/mkrvas/wb-seller-api-reference.git ~/.claude/skills/wb-api
Claude Code подхватит скилл автоматически — он сработает, когда вы спросите про путь/параметры/лимит конкретного эндпоинта WB API или попросите спроектировать интеграцию с Wildberries.
Структура
| Файл | Содержание |
|---|---|
| SKILL.md | Точка входа: когда использовать, навигация, быстрый справочник |
| 00-overview.md | Хосты, авторизация, scopes токена, форматы дат |
| 01-rate-limits-retry.md | Rate limits по семействам, exponential backoff |
| 02-errors.md | HTTP коды, формат ошибок, типичные проблемы |
| 03-pagination.md | Cursor / offset / rrdid / date-based пагинация |
| 04-async-tasks.md | Асинхронные отчёты через task_id |
| 10-content.md | Content — карточки, медиа, справочники |
| 11-marketplace.md | Marketplace — FBS заказы, поставки, остатки |
| 12-statistics.md | Statistics — остатки WB, продажи, заказы |
| 12a-finance.md | Finance — финотчёты daily/weekly, баланс, эквайринг |
| 13-analytics.md | Analytics — воронка продаж, платное хранение, NM-отчёты |
| 14-prices-discounts.md | Prices & Discounts — цены, скидки |
| 15-advertising.md | Advertising — рекламные кампании |
| 16-feedbacks.md | Feedbacks & Questions — отзывы, вопросы |
| 17-tariffs.md | Tariffs — комиссии, склады, короба |
| 18-chat.md | Buyer Chat — чат с покупателями |
| 19-returns.md | Returns — возвраты |
| 20-documents.md | Documents — счета, акты |
| 21-calendar.md | Promotion Calendar — акции |
| 22-orders-dbw.md | Orders DBW — заказы с доставкой силами WB |
| 23-orders-dbs.md | Orders DBS — заказы с доставкой продавцом |
| 24-in-store-pickup.md | In-Store Pickup — самовывоз из магазина |
| 25-wbd.md | WBD (расшифровка не подтверждена) — портал не публикует спеку, файл-заготовка |
| 26-supplies-fbw.md | Supplies FBW — поставки на склады WB |
Уровень детализации
Файлы неравномерны по глубине, и это осознанно:
- Боевые (Finance, Advertising, Statistics, Analytics) — содержат факты, проверенные живыми запросами с реальным токеном: реальные ответы API, эндпоинты, которые официальная документация не описывает или описывает неточно, конкретные даты изменений и deprecation.
- Справочные (Chat, Returns, Documents, Calendar, Feedbacks, Tariffs, Prices, Content, Marketplace, Orders DBW, Orders DBS, Самовывоз, WBD, Supplies FBW) — конспект официальной документации: пути, методы, параметры, без live-тестирования каждой мелочи. WBD — особый случай: портал не публикует его спеку, файл — заготовка (см. примечание в самом файле).
Ориентируйтесь на это при выборе, насколько слепо доверять конкретному файлу.
Аудит от 2026-07-21: перед публикацией все файлы прогнаны через сверку со сторонними источниками (официальный dev.wildberries.ru на момент проверки блокировал автоматический доступ). Места с неподтверждённой или противоречивой информацией помечены прямо в тексте блоком ⚠️. После сверки со снапшотами OpenAPI-спек (specs/) пути в 18-chat.md, 20-documents.md, 21-calendar.md подтверждены (непроверенными остаются лишь отдельные лимиты и поля тел запросов — помечено на месте). Под сомнением остаётся 19-returns.md: актуальная модель возвратов — это заявки claims на хосте feedbacks-api (см. 16-feedbacks.md), а описанные в 19-returns.md пути returns-api официально не подтверждены.
Автообновление
Таблицы эндпоинтов между маркерами <!-- AUTO:BEGIN ... --> / <!-- AUTO:END -->
генерируются из официальных OpenAPI-спек dev.wildberries.ru (снапшот — в
specs/). GitHub Actions ежедневно скачивает свежие спеки и, если WB
что-то поменял, открывает PR с перегенерированными таблицами и списком
изменений — мерж делает человек. Рукописные заметки (лимиты, грабли, даты
отключений) живут вне маркеров, генератор их не касается.
Важно: если на GitHub висит несмерженный PR от бота (WB что-то поменял, а изменения ещё не влиты в master), то данные в установленной у вас копии отстают от актуальных спек. Смержите этот PR и обновите копию.
Обновить локальную копию скилла: git pull в папке скилла.
⚠️ Дисклеймер
Это неофициальный community-справочник, не аффилированный с Wildberries. WB меняет API часто и без объявления — файлы могут отставать от реальности. Перед использованием в продакшене всегда сверяйтесь с официальными источниками:
- Портал разработчиков: https://dev.wildberries.ru/
- Swagger/OpenAPI: https://dev.wildberries.ru/openapi
- Release Notes: https://dev.wildberries.ru/release-notes
Баги и устаревшие данные — через Issues/PR.