wb-api-skill

Установка

git clone https://github.com/ZloyDeDD/wb-api-skill.git ~/.claude/skills/wb-api
python -m pip install -r ~/.claude/skills/wb-api/requirements.txt

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

Что делает

Скилл хранит локальный снимок OpenAPI-спецификаций WB и скрипт wb.py для поиска эндпоинтов, просмотра схем запросов и ответов, хостов и правил авторизации. Скрипт не ходит в сеть и не является клиентом API, он отдает агенту компактные ответы вместо мегабайтов YAML. Перед ответом агент проверяет возраст снимка и сообщает, если он старше 30 дней. Скрипт update.py позволяет собрать свежий снимок самостоятельно.

Для кого. Для разработчиков интеграций с Wildberries, которым важно опираться на актуальную документацию.

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

Какой эндпоинт WB отдает остатки на складах продавца и какой у него хост?

Ограничения

Данные актуальны на дату снимка. Для самостоятельного обновления нужен видимый браузер Chrome и patchright, потому что портал WB закрыт антиботом. Лимиты запросов WB приводятся только из текстовых описаний операций.

Как отключить. Удалите каталог ~/.claude/skills/wb-api или .claude/skills/wb-api в проекте.

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

• Запускает локальные Python-скрипты
• Режим обновления запускает браузер и скачивает спецификации с dev.wildberries.ru

Коротко о README

README описывает скилл-справочник по Wildberries Seller API с регулярно обновляемым снимком спецификаций. Изменения API фиксируются в релизах и CHANGELOG.md. Подробно объяснено, почему спецификации нельзя скачать простым HTTP-запросом и как update.py обходит антибот через patchright, проверяет файлы и атомарно подменяет снимок. Есть тесты защитной логики без сети. Код под MIT, спецификации принадлежат Wildberries.

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` конкретной операции. Приводи их оттуда дословно, не выдумывай числа.

Похожие