wildberries-mcp-ru

API do vendedor Wildberries no seu assistente de IA: 307 métodos em todos os 17 hosts da WB para vendas, estoques, cartões, preços, relatórios e avaliações, com uma classe de segurança em cada método.

GitHub
1
Experimente este MCPPatrocinado

Documentação

wildberries-mcp-ru

API Wildberries para assistentes de IA: vendas e estoques, cartões e características, preços e promoções, relatórios financeiros, avaliações. Dezessete hosts da WB organizados em um catálogo.

PyPI CI License: MIT Методов Сайт Звёзды

wildberries-mcp-ru: API Wildberries в ИИ-ассистенте. 307 методов

O pacote sobe um único servidor, Wildberries, e nada mais. O servidor, o catálogo e o núcleo vêm como dependência de marketplaces-mcp-ru: aqui estão o nome, o ponto de entrada e a documentação para um único marketplace.

Instalação

O pacote está no PyPI, então o comando é uma linha só:

uvx wildberries-mcp-ru

Se precisar do branch main, e não de um release:

uvx --from git+https://github.com/ilyautov/wildberries-mcp-ru wildberries-mcp-ru

Claude Desktop, claude_desktop_config.json:

{
  "mcpServers": {
    "wb": {
      "command": "uvx",
      "args": ["wildberries-mcp-ru"],
      "env": { "WB_API_TOKEN": "..." }
    }
  }
}

Terceiro caminho, se o agente suporta skills: ele instala o servidor e configura o cliente sozinho.

npx skills add ilyautov/wildberries-mcp-ru

Chaves

Onde obter o token. Painel seller.wildberries.ru, seção Configurações, item Acesso à API. O token é único para todos os hosts, mas ao criá-lo você seleciona as categorias de acesso: um token emitido apenas para conteúdo não terá acesso às estatísticas.

Como ele é enviado na requisição. No cabeçalho Authorization, e isso é um detalhe importante: o servidor envia o token bruto sem o prefixo Bearer. Confirmado na prática. Se a autenticação falhar com um token válido, verifique isso primeiro.

Onde ele fica armazenado. Em ~/.marketplace-mcp/cabinets.json com permissões chmod 600, localmente. O token não vai para o repositório nem para o chat.

variávelsegredoo que é
WB_API_TOKENsimToken do painel seller.wildberries.ru, Configurações → Acesso à API. Enviado no Authorization sem Bearer.

As chaves não precisam ficar no ambiente: o servidor suporta contas e as armazena em ~/.marketplace-mcp/cabinets.json com permissões 600, fora do repositório. Você pode conectar quantas lojas precisar, alternando diretamente pelo chat.

Mapa de métodos

O catálogo está na dependência como wb_mcp/endpoints.yaml: 307 métodos, sendo 187 de leitura, 108 de escrita e 12 irreversíveis. O servidor executa exatamente esse arquivo, então a tabela não pode divergir do código.

hostmétodoso que contém
marketplace-api.wildberries.ru100Tarefas de montagem e entregas FBS, DBS, DBW, retirada
seller-analytics-api.wildberries.ru40Análises do vendedor: consultas de busca, estoques, retenções, armazenagem paga
content-api.wildberries.ru31Cartões de produtos, características, categorias, mídia, etiquetas
advert-api.wildberries.ru30Campanhas de anúncios, lances, clusters de busca
devapi-digital.wildberries.ru22Produtos digitais: conteúdo, ofertas, chaves de ativação
feedbacks-api.wildberries.ru20Avaliações, perguntas, avaliações fixadas
discounts-prices-api.wildberries.ru13Preços, descontos, calendário de promoções
common-api.wildberries.ru10Informações do vendedor, tarifas, comissões, notícias
supplies-api.wildberries.ru7Entregas para o armazém da WB e dados para montá-las
finance-api.wildberries.ru7Relatórios financeiros e saldo
statistics-api.wildberries.ru5Estatísticas: vendas, pedidos, estoques, relatório de vendas
user-management-api.wildberries.ru4Usuários do vendedor e suas permissões
advert-media-api.wildberries.ru4Mídia em anúncios e estatísticas sobre elas
dp-calendar-api.wildberries.ru4Calendário de promoções e participação nelas
buyer-chat-api.wildberries.ru4Chat com compradores
documents-api.wildberries.ru4Documentos do vendedor
returns-api.wildberries.ru2Devoluções por compradores

Análise detalhada com parâmetros e limites: https://marketplaces-mcp-ru.aifrontier.tech/wildberries-api.html

O que perguntar no chat

  • mostre as vendas na WB da semana
  • extraia o relatório financeiro de vendas do mês passado
  • o que devo repor, calcule os dias de cobertura
  • quais produtos correm risco de ficar out-of-stock

Erros comuns

401 com token válido. Duas causas por frequência. Primeira: a WB espera o token bruto em Authorization sem Bearer. Segunda: a conta ativa em ~/.marketplace-mcp/cabinets.json tem prioridade sobre as variáveis de ambiente e oculta o que você exportou.

404 ou resposta vazia em um método funcional. Verifique o host. A WB tem dezessete domínios por finalidade, e estatísticas não respondem no domínio de conteúdo. Veja a tabela de hosts acima.

429, limite de requisições excedido. Os limites da WB são definidos por método e em alguns casos são bem rígidos: para parte dos métodos é uma requisição por minuto, e para relatórios pode ser até menos. O limite está vinculado ao método, não à conta inteira, então você pode esbarrar em um relatório enquanto o resto continua funcionando.

Diferença em relação ao marketplaces-mcp-ru

Nenhuma, exceto a composição. marketplaces-mcp-ru instala quatro marketplaces de uma vez e os mantém sob um único servidor; wildberries-mcp-ru instala apenas um. O código é compartilhado: uma correção no núcleo chega aqui via atualização da dependência, não por cópia.

necessidadepacote
apenas Wildberrieswildberries-mcp-ru
todos os quatro marketplacesmarketplaces-mcp-ru

Quem fez

Ilya Utov, laboratório AI Frontier. Sobre como essas ferramentas funcionam internamente, escrevo no Telegram e no LinkedIn.

Ao lado estão business-mcp-ru (hh.ru, VK, Diadoc, SBIS, Chestny Znak), moysklad-mcp-ru e humanizer-ru.

Todos os projetos em uma lista, organizados por finalidade: ilyautov.github.io.

Licença

MIT, veja LICENSE.