Wildberries API MCP Server
MissiaL/wildberries-api
Integração segura com API do Wildberries para agentes IA
Ver no GitHubSkill de agente para integração com a API oficial do Wildberries (marketplace russo). Fornece esquemas OpenAPI locais, referências de categorias e helper Python seguro que injeta credenciais e bloqueia hosts não-produção. Ideal para automações de operações de vendedor, gestão de produtos, pedidos e analytics.
Instalação
npx convez-ai MissiaL/wildberries-api1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automação de operações de seller no Wildberries (produtos, preços, descontos)
- Gerenciamento de pedidos, devoluções e reclamações via agente IA
- Analytics e relatórios de vendas e financeiro integrados com agentes
Veredito

Implementação técnica sólida para sellers do Wildberries que precisam automatizar operações via agentes. Bem-estruturado com validações de segurança (production-only), schemas OpenAPI bundled e helper robusto. Requer token válido e conhecimento de API REST.
README
A tradução para o português deste README ainda está na fila.
Wildberries API
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 and blocks non-production hosts.
Compatible Agents
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.
Requirements
- Python 3.8+
- Internet access
WB_API_TOKENwith the required Wildberries seller scopes
Installation
git clone https://github.com/MissiaL/wildberries-api.git wildberries-api
The directory name should match the skill name: wildberries-api.
Quick Check
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.
How It Works
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
API Coverage
- 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.
Supported Coverage
- All fetched production schemas listed in
assets/openapi/manifest.json - Category routing in
references/overview.md - Production-only hosts from
assets/openapi/host-allowlist.json
Development
python -m pytest -v
python scripts/fetch_openapi.py
Use scripts/fetch_openapi.py to refresh the saved schemas from the official Wildberries documentation at https://dev.wildberries.ru/docs/openapi/api-information.
License
MIT