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"
python3 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 286 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
python3 -m pytest -v
python3 scripts/sync_openapi.py /tmp/wb-live-specs.json --captured-at <ISO-8601-time>dev.wildberries.ru returns anti-bot HTTP 498 to plain HTTP clients. Refresh the 13 official documentation pages in a real browser, export each rendered __redoc_state.spec.data object into one JSON object keyed by page slug, then run scripts/sync_openapi.py. The sync installs the full official schemas and requires a rate-limit block for every operation.
MIT