Production-only agent skill for the official Wildberries seller API. It bundles local OpenAPI snapshots, category references, and a safe Python helper that injects WB_API_TOKEN, blocks non-production hosts, and handles HTTP 429 according to WB rate-limit headers.
Works with AI agents that load SKILL.md-style skills and bundled resources. The repository follows the agent-documentation idea from AGENTS.md: keep operational instructions predictable, concise, and close to the code.
- Python 3.8+
- Internet access
WB_API_TOKENwith the required Wildberries seller scopes
git clone https://github.com/MissiaL/wildberries-api.git wildberries-apiThe directory name should match the skill name: wildberries-api.
export WB_API_TOKEN="wb-production-token"
python scripts/api_call.py --method GET --url "https://common-api.wildberries.ru/ping"This skill is production-only. Sandbox hosts and test-token workflows are intentionally excluded.
For repeated calls, read references/rate-limits.md. All 283 saved operations carry a verified x-wb-rate-limits block. The helper can show the exact token-type profile with --show-rate-limit, retries 429 up to three times, honors X-Ratelimit-Retry, and caps a single wait at 60 seconds.
User asks for WB seller data or an operation
|
v
Agent reads SKILL.md -> routes through references/overview.md
|
v
Agent checks assets/openapi/*.json for path and method
|
v
scripts/api_call.py validates host, injects WB_API_TOKEN, calls WB API
- General seller operations and user management
- Product cards, directories, content, prices, and discounts
- FBS, DBS, DBW, in-store pickup, and FBW supply workflows
- Promotion and advertising campaigns
- Feedbacks, questions, buyer chat, claims, and returns
- Analytics, statistics, reports, finance, documents, and tariffs
The authoritative coverage list is assets/openapi/manifest.json; allowed production hosts live in assets/openapi/host-allowlist.json.
- All fetched production schemas listed in
assets/openapi/manifest.json - Category routing in
references/overview.md - Current rate-limit workflow in
references/rate-limits.md - Production-only hosts from
assets/openapi/host-allowlist.json
python -m pytest -v
python scripts/fetch_openapi.pyUse scripts/fetch_openapi.py to refresh the saved schemas from the official Wildberries documentation at https://dev.wildberries.ru/docs/openapi/api-information.
MIT