SkillFoxx

Official Wildberries Seller API skill

Wildberries API

A skill for the official Wildberries Seller API with local OpenAPI schemas for 286 operations and a guarded api_call helper

  • 0 ★ on the repository
  • Last commit
Skill

Broad access

Why this level

  • 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
All reasons and checks
Russian stack

missial/wildberries-apiAuthor:Petr Alexeev

Install

Services

Manual install

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

The folder name must match the skill name wildberries-api.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • 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

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.

Good fit when

  • You want full official seller API coverage, including write operations, in one skill
  • You care about protection against accidentally calling a sandbox or wrong host
  • You need accurate, verified rate-limit information for every operation

Not a fit when

  • You need a ready MCP server with separate tools, not a CLI helper inside a skill
  • You need writes blocked by default: the skill itself does not separate read from write

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.

FAQ

Can the skill accidentally call a sandbox host?

No, the helper checks the host against host-allowlist.json and blocks every non-production address.

Is there protection against an accidental write?

There is no separate read/write gate; the helper only validates the host, injects the token, and handles 429 errors.

Discussion

No questions or reviews yet.

All Wildberries tools
Russian stack

An Agent Skill with a full map of the Wildberries API: 12 modules, 261 methods, reference files and a call script

SkillExtended access

Wildberries Seller API skill

Wildberries Seller API - Agent Skill

Russian stack

A Wildberries Seller API reference skill on local Swagger files with search in Russian and English

SkillExtended access7
Russian stack

A Wildberries Seller API reference built on an OpenAPI snapshot the author syncs with the WB portal about monthly

SkillExtended access2
Russian stack

A local Wildberries Seller API MCP server built from a 279-method OpenAPI catalog, with calls defaulting to dry-run

MCP serverBroad access

Wildberries Seller API reference

wb-seller-api-reference

Russian stack

A Claude Code skill with a Wildberries Seller API reference: hosts, rate limits, errors and 18 endpoint families

SkillMinimal access1

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.

README badge

Original 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.

Report a problem