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

Установка

npx skillfoxx add skills/wildberries-api

npx skills add missial/wildberries-api --skill wildberries-api -a claude-code -y

npx skills add missial/wildberries-api --skill wildberries-api -a cursor -y

npx skills add missial/wildberries-api --skill wildberries-api -a github-copilot -y

npx skills add missial/wildberries-api --skill wildberries-api -a codex -y

npx skills add missial/wildberries-api --skill wildberries-api -a gemini-cli -y

npx skills add missial/wildberries-api --skill wildberries-api -a cline -y

npx skills add missial/wildberries-api --skill wildberries-api -a roo -y

npx skills add missial/wildberries-api --skill wildberries-api -a opencode -y

git clone https://github.com/MissiaL/wildberries-api.git 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 в формате скилла с базовой защитой от неверного хоста и превышения лимита.

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

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

Ограничения

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

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

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

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

Коротко о README

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

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.

Похожие