Official Wildberries Seller API skill

Install

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

This is third-party code. Review the repository files before installing.

What it does

The skill gives an agent access to the official Wildberries Seller API through local OpenAPI schema snapshots and category references: general seller operations, product cards, directories, content, prices and discounts, FBS, DBS, DBW, in-store pickup and FBW supplies, promotion and advertising, feedbacks, questions, buyer chat, claims and returns, analytics, statistics, reports, finance, documents and tariffs. Every call goes through python3 scripts/api_call.py only: the helper injects the WB_API_TOKEN, checks the host against an allowlist and blocks non-production hosts, retries a 429 per the X-Ratelimit-Retry header up to three times capped at 60 seconds per attempt. All 286 saved operations carry a verified x-wb-rate-limits block, viewable with --show-rate-limit before a run of calls.

Who it is for. For developers who want full official Wildberries Seller API coverage as a skill, with basic protection against a wrong host or exceeding the rate limit.

Example request

Check the rate limit for the stock endpoint and show current warehouse stock

Limitations

The skill targets production only: sandbox and test tokens are intentionally excluded. The helper guards against a wrong host and rate-limit overruns, but does not separate read from write operations and requires no extra confirmation for mutating calls like uploading cards. Updating the schemas needs a manual export from WB's documentation pages in a real browser, because dev.wildberries.ru returns an anti-bot 498 to plain HTTP clients.

How to disable. Remove the wildberries-api folder from your agent's skills directory.

Security check

• It covers write operations like card uploads, prices and promotions with no separate read/write gate
• The helper only guards against a wrong host and rate limits, not against the act of writing data itself

README in short

The README describes install by cloning into a wildberries-api folder, a quick token check with ping, how calls go through api_call.py with host and rate-limit checks, the list of covered API sections with the manifest as the source of truth, and the schema update process via a manual browser export due to dev.wildberries.ru's anti-bot protection.

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.

Related