Скилл официального Wildberries Seller API

Wildberries API

Скилл для официального Wildberries Seller API с локальными OpenAPI-схемами на 286 операций и защищенным помощником api_call

  • 0 ★ репозитория
  • Последний коммит
Скилл

Широкий доступ

Почему такой уровень

  • Покрывает операции записи вроде загрузки карточек, цен и промо-акций без отдельного разделения от чтения
  • Помощник защищает только от неверного хоста и лимита запросов, но не от самого факта изменения данных
Все причины и проверки
Российский стек

missial/wildberries-api

Установка

Работает в
Сервисы

Ручная установка

git clone https://github.com/MissiaL/wildberries-api.git wildberries-api

Имя папки должно совпадать с именем скилла wildberries-api.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Покрывает операции записи вроде загрузки карточек, цен и промо-акций без отдельного разделения от чтения
  • Помощник защищает только от неверного хоста и лимита запросов, но не от самого факта изменения данных

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

Что делает

Скилл дает агенту доступ к официальному Wildberries Seller API через локальные снимки OpenAPI-схем и справочники по категориям: общие операции продавца, карточки товаров, справочники, контент, цены и скидки, FBS, DBS, DBW, самовывоз и поставки FBW, продвижение и реклама, отзывы, вопросы, чат с покупателями, претензии и возвраты, аналитика, статистика, отчеты, финансы, документы и тарифы. Все вызовы идут только через python3 scripts/api_call.py: помощник сам подставляет токен WB_API_TOKEN, проверяет хост по allowlist и блокирует не-продакшн хосты, повторяет запрос при ошибке 429 по заголовку X-Ratelimit-Retry не более трех раз и не дольше 60 секунд на одну попытку. Все 286 сохраненных операций несут проверенный блок лимитов запросов x-wb-rate-limits, который можно посмотреть флагом --show-rate-limit перед серией вызовов.

Для кого. Для разработчиков, которым нужен полный официальный охват Wildberries Seller API в формате скилла с базовой защитой от неверного хоста и превышения лимита.

Подходит, если

  • Нужен полный официальный охват API продавца, включая операции записи, в одном скилле
  • Важна защита от случайного вызова тестового или неверного хоста
  • Нужна точная и проверенная информация о лимитах запросов по каждой операции

Не подходит, если

  • Нужен готовый MCP-сервер с отдельными инструментами, а не CLI-помощник внутри скилла
  • Нужно, чтобы запись была заблокирована по умолчанию: скилл сам не разделяет чтение и запись

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

Проверь лимит запросов для метода получения остатков и покажи текущие остатки на складах

Ограничения

Скилл рассчитан только на продакшн: песочница и тестовые токены исключены намеренно. Помощник защищает от неверного хоста и превышения лимита, но не разделяет операции на чтение и запись и не требует отдельного подтверждения для изменяющих вызовов вроде загрузки карточек. Обновление схем требует ручного экспорта данных со страниц документации WB в браузере, потому что dev.wildberries.ru отдает анти-бот ошибку 498 обычным HTTP-клиентам.

Как отключить. Удалите папку wildberries-api из каталога скиллов агента.

Частые вопросы

Может ли скилл вызвать тестовый хост по ошибке?

Нет, помощник проверяет хост по host-allowlist.json и блокирует все не-продакшн адреса.

Есть ли защита от случайной записи?

Нет отдельного разделения на чтение и запись, помощник только валидирует хост, подставляет токен и обрабатывает ошибку 429.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

Agent Skill с полной картой API Wildberries: 12 модулей и 261 метод, справочные файлы и скрипт для вызовов

СкиллРасширенный доступ

Скилл Wildberries Seller API

Wildberries Seller API - Agent Skill

Российский стек

Скилл-справочник по Wildberries Seller API на локальных Swagger-файлах с поиском на русском и английском

СкиллРасширенный доступ7Звезды репозитория
Российский стек

Справочник Wildberries Seller API на снимке OpenAPI, который автор сверяет с порталом WB примерно раз в месяц

СкиллРасширенный доступ2Звезды репозитория
Российский стек

Консервативный CLI и скилл для официального Wildberries Seller API: токен, ping, seller-info и сырые запросы только на чтение

CLIШирокий доступ
Российский стек

Локальный MCP-сервер Wildberries Seller API на 279 методов из OpenAPI-каталога, вызовы по умолчанию в режиме dry-run

MCP-серверШирокий доступ
Российский стек

Скилл Claude Code со справочником Wildberries Seller API: хосты, лимиты, ошибки и 18 семейств эндпоинтов

СкиллМинимальный доступ1Звезды репозитория

Коротко о README

README описывает установку клонированием в папку wildberries-api, быструю проверку токена командой ping, устройство вызова через api_call.py с проверкой хоста и лимитов, список покрытых разделов API со ссылкой на манифест как источник истины, и процесс обновления схем через ручной экспорт из браузера из-за анти-бот защиты dev.wildberries.ru.

Бейдж для README

Исходный SKILL.md

---
name: wildberries-api
description: Use when the user needs to read or change Wildberries (WB, вайлдберриз, вб) seller data through the official production API, including product cards, prices, orders, supplies, analytics, promotions, reviews, reports, finance, returns, documents, tariffs, and seller operations.
---

# Wildberries API

Use this skill to work with the official Wildberries seller API in production.

## Setup

- Export WB_API_TOKEN before calling the API.
- This skill is production-only; sandbox and non-Wildberries hosts are blocked.
- Use only python3 scripts/api_call.py so host allowlisting, auth injection, and error sanitization are applied.
- Before repeated or paginated calls, read references/rate-limits.md and identify the token type and the exact method's current limit.

Сообщить о проблеме