wb-apilisted
Install: claude install-skill ZloyDeDD/wb-api-skill
# Wildberries Seller API
Локальный снимок OpenAPI-спецификаций в `swagger/*.yaml` — единственный источник истины по этому API. Отвечай по нему, а не по памяти: WB меняет эндпоинты часто, и то, что ты помнишь, скорее всего устарело.
## Порядок работы
Помощник требует PyYAML. Если его нет: `python -m pip install -r requirements.txt`.
1. Начинай с компактных запросов к снимку:
- обзор разделов: `python scripts/wb.py map`
- поиск: `python scripts/wb.py search "<запрос>" --limit 15`
- конкретный эндпоинт: `python scripts/wb.py detail <METHOD> <PATH>`
- со схемами тела и ответов: `python scripts/wb.py detail <METHOD> <PATH> --schemas`
- авторизация, хосты, токены, коды: `python scripts/wb.py protocol`
2. Сырой `swagger/*.yaml` открывай только когда вывода скрипта не хватает: нужны вложенные примеры, значения enum или длинное описание целиком. Целиком файлы не читай — они по 100–350 КБ.
3. Целостность снимка: `python scripts/wb.py validate`.
## Свежесть
Перед содержательным ответом по API сверься с `python scripts/wb.py stale`.
Снимок старше 30 дней — скажи об этом пользователю прямо: назови дату снимка и предложи `git pull` (снимок в репозитории обновляет мейнтейнер). Если и там несвежо — предложи собрать свой снимок: `python scripts/update.py`. Не делай вид, что данные свежие.
Если пользователь ждёт эндпоинт, которого в снимке нет, — так и скажи: «в снимке от такой-то даты этого нет». Не выдумывай путь и не подгоняй похожий. Предложи обновить снимок.
## Пра