wb-api-skill
Справочник Wildberries Seller API на снимке OpenAPI, который автор сверяет с порталом WB примерно раз в месяц
- 2 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает локальные Python-скрипты
- Режим обновления запускает браузер и скачивает спецификации с dev.wildberries.ru
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/wb-api-skillОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает локальные Python-скрипты
- Режим обновления запускает браузер и скачивает спецификации с dev.wildberries.ru
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл хранит локальный снимок OpenAPI-спецификаций WB и скрипт wb.py для поиска эндпоинтов, просмотра схем запросов и ответов, хостов и правил авторизации. Скрипт не ходит в сеть и не работает как клиент API, он отдает агенту компактные ответы вместо мегабайтов YAML. Перед ответом агент проверяет возраст снимка и сообщает, если он старше 30 дней. Скрипт update.py позволяет собрать свежий снимок самостоятельно.
Для кого. Для разработчиков интеграций с Wildberries, которым важно опираться на актуальную документацию.
Подходит, если
- Нужно найти эндпоинт WB для остатков, заказов, поставок или отзывов
- Нужно посмотреть схему запроса и ответа конкретного метода
- Нужно сгенерировать клиентский код к Seller API
Не подходит, если
- Нужен готовый клиент, который сам вызывает API WB
- Нужна аналитика рынка, а не документация по API
Пример запроса к агенту
Какой эндпоинт WB отдает остатки на складах продавца и какой у него хост?Ограничения
Данные актуальны на дату снимка. Для самостоятельного обновления нужен видимый браузер Chrome и patchright, потому что портал WB закрыт антиботом. Лимиты запросов WB приводятся только из текстовых описаний операций.
Как отключить. Удалите каталог ~/.claude/skills/wb-api или .claude/skills/wb-api в проекте.
Частые вопросы
Как обновить снимок?
Обычно достаточно git -C ~/.claude/skills/wb-api pull. Без git можно распаковать архив wb-swagger из последнего релиза поверх swagger/.
Почему каталог называется wb-api?
Claude Code ищет скилл по имени каталога, и оно должно совпадать с name в SKILL.md.
Обсуждение
Вопросов и отзывов пока нет.
Скилл Wildberries Seller API
Wildberries Seller API - Agent Skill
Скилл-справочник по Wildberries Seller API на локальных Swagger-файлах с поиском на русском и английском
Скилл официального Wildberries Seller API
Wildberries API
Скилл для официального Wildberries Seller API с локальными OpenAPI-схемами на 286 операций и защищенным помощником api_call
Скилл Wildberries API на 261 метод
wb-api skill
Agent Skill с полной картой API Wildberries: 12 модулей и 261 метод, справочные файлы и скрипт для вызовов
Справочник Wildberries Seller API
wb-seller-api-reference
Скилл Claude Code со справочником Wildberries Seller API: хосты, лимиты, ошибки и 18 семейств эндпоинтов
Консервативный CLI и скилл для официального Wildberries Seller API: токен, ping, seller-info и сырые запросы только на чтение
Agent Skill и CLI без зависимостей поверх API Wildberries: товары, заказы, отзывы, аналитика, несколько магазинов
Коротко о README
README описывает скилл-справочник по Wildberries Seller API с регулярно обновляемым снимком спецификаций. Изменения API фиксируются в релизах и CHANGELOG.md. Подробно объяснено, почему спецификации нельзя скачать простым HTTP-запросом и как update.py обходит антибот через patchright, проверяет файлы и атомарно подменяет снимок. Есть тесты защитной логики без сети. Код под MIT, спецификации принадлежат Wildberries.
Бейдж для README
Исходный SKILL.md
--- name: wb-api description: Swagger-backed Wildberries seller API reference for WB marketplace integrations. Use when building or debugging code that calls Wildberries/WB seller API endpoints, choosing endpoints, checking request/response schemas, authentication headers, hosts, rate limits, or API capabilities. --- # 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`. Не делай вид, что данные свежие. ## Правила ответа - Указывай метод, путь, хост, файл-источник (`swagger/NN-name.yaml`), схему авторизации, тип токена и релевантные коды ответов. - Хост бери с самой операции: у WB он разный для разных доменов. Общего хоста нет. - Лимиты запросов WB в машиночитаемом виде не публикует — они описаны текстом внутри `description` конкретной операции. Приводи их оттуда дословно, не выдумывай числа.