convez.ai
MCP ServerIntegração & APIsIntermediário
MissiaL

Wildberries API MCP Server

MissiaL/wildberries-api

Integração segura com API do Wildberries para agentes IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill 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-api

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

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

Python 3.8+ License: MIT

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_TOKEN with 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

Ver o original no GitHub

Bom para

Relacionados