Скилл Wildberries Seller API
Wildberries Seller API - Agent Skill
Скилл-справочник по Wildberries Seller API на локальных Swagger-файлах с поиском на русском и английском
- 7 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агент запускает Python-скрипт wb_api.py для поиска по Swagger-спецификациям WB
- Скрипт работает с локальными файлами и в сеть не ходит
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/wildberries-seller-api-agent-skillОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент запускает Python-скрипт wb_api.py для поиска по Swagger-спецификациям WB
- Скрипт работает с локальными файлами и в сеть не ходит
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
В репозитории лежат русские Swagger-спецификации WB как основной источник и английское зеркало для поиска и подписей. Скрипт wb_api.py показывает карту разделов, ищет эндпоинты, раскрывает схемы запросов и ответов, выводит данные об авторизации и хостах. Сетевых запросов скрипт не делает, поэтому агенту не нужно загружать спецификации целиком.
Для кого. Для разработчиков интеграций с Wildberries, которые работают в Codex или Claude Code.
Подходит, если
- Нужно найти эндпоинт для карточек, цен, остатков или заказов
- Нужна схема запроса и ответа конкретного метода
- Нужно подготовить вызов API на Python с правильным хостом и заголовком
Не подходит, если
- Нужен клиент, который реально вызывает API
- Нужна гарантия свежести спецификаций: снимки обновляются вручную
Пример запроса к агенту
Найди endpoint для рейтинга продавца и покажи его схему ответаОграничения
Swagger-файлы являются локальными снимками и требуют ручного обновления при изменениях API. Английское зеркало вспомогательное, расхождения отмечаются как предупреждения. Нужен Python с PyYAML.
Как отключить. Удалите каталог wildberries-api из папки скиллов агента.
Частые вопросы
Какие спецификации главные?
Русские swagger/*.yaml. Английские swagger/en/*.yaml используются для поиска и подписей, параметры и схемы берутся из русских.
Обсуждение
Вопросов и отзывов пока нет.
Справочник Wildberries Seller API на снимке OpenAPI, который автор сверяет с порталом WB примерно раз в месяц
Скилл Wildberries API на 261 метод
wb-api skill
Agent Skill с полной картой API Wildberries: 12 модулей и 261 метод, справочные файлы и скрипт для вызовов
Скилл официального Wildberries Seller API
Wildberries API
Скилл для официального Wildberries Seller API с локальными OpenAPI-схемами на 286 операций и защищенным помощником api_call
Справочник Wildberries Seller API
wb-seller-api-reference
Скилл Claude Code со справочником Wildberries Seller API: хосты, лимиты, ошибки и 18 семейств эндпоинтов
Agent Skill и CLI без зависимостей поверх API Wildberries: товары, заказы, отзывы, аналитика, несколько магазинов
Консервативный CLI и скилл для официального Wildberries Seller API: токен, ping, seller-info и сырые запросы только на чтение
Коротко о README
README объясняет установку скилла для Codex и Claude Code клонированием в каталог скиллов. Скрипт wb_api.py поддерживает команды validate, map, search, tag, detail, protocol и generate. Проверка validate ищет ошибки разбора, дубликаты, неразрешенные ссылки и расхождения зеркал. Производная markdown-документация генерируется по запросу и не хранится в репозитории.
Бейдж для README
Исходный SKILL.md
--- name: wildberries-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 API Treat local Swagger as the only API source of truth. Russian files in `swagger/*.yaml` are canonical; English files in `swagger/en/*.yaml` are a validated translation overlay for English search and text labels. Use the helper script for compact Swagger-derived lookups; do not load full Swagger files unless the helper output is insufficient. ## Default Workflow The helper requires PyYAML. If it is missing, install dependencies with `python3 -m pip install -r requirements.txt`. 1. Start with the compact Swagger query script: - Get an overview: `python3 scripts/wb_api.py map` - Search endpoints in Russian or English: `python3 scripts/wb_api.py search "<query>" --limit 25` - Inspect an exact endpoint: `python3 scripts/wb_api.py detail <METHOD> <PATH>` - Expand request/response fields: `python3 scripts/wb_api.py detail <METHOD> <PATH> --schemas` - Inspect auth, hosts, token hints, ping, and status codes: `python3 scripts/wb_api.py protocol` - List observed hosts/categories only: `python3 scripts/wb_api.py hosts` 2. Open raw `swagger/*.yaml` only when the script output is insufficient for exact schemas, nested examples, enum values, or long endpoint descriptions. 3. If human-readable browse docs are needed, generate them on demand with `python3 scripts/wb_api.py generate`; generated output is ignored by git. 4. Validate parser coverage and the Russian/English mirror before relying on output: `python3 scripts/wb_api.py validate`. ## Answering Rules - Cite method, path, host, source Swagger file, auth scheme, parameters/body, and relevant response codes. - Do not invent global protocol details. For rate limits, token types, sandbox behavior, or status meaning, use endpoint descriptions, `x-token-types`, `servers`, `securitySchemes`, and responses from Swagger. - Prefer compact script output over loading complete Swagger files into context. - If the local Swagger snapshot does not contain what the user expects, say that directly and ask before checking live docs. ## Code Generation Checklist - Read credentials from env/config; never hard-code the token. - Send the token using the Swagger-declared `HeaderApiKey` scheme (`Authorization` header). - Use the host declared on the operation or inherited by its path/spec. - Implement pagination, polling, retries, and payload validation only when the endpoint schema or description calls for it.