yandex-market-mcp-ru

yandex-market-mcp-ru

API do Yandex Market (Partner API) para assistentes de IA: pedidos e devoluções, produtos e cartões, preços e tarifas, relatórios, avaliações e chats. O catálogo é executado pelo servidor.

O pacote sobe um único servidor, o Yandex Market, 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 a linha é única:

uvx yandex-market-mcp-ru

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

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

Claude Desktop, claude_desktop_config.json:

{
  "mcpServers": {
    "ym": {
      "command": "uvx",
      "args": ["yandex-market-mcp-ru"],
      "env": { "YANDEX_MARKET_API_KEY": "..." }
    }
  }
}

O terceiro caminho, se o agente souber usar skills: ele instalará o servidor e configurará o cliente sozinho.

npx skills add ilyautov/yandex-market-mcp-ru

Chaves

Onde obter a Api-Key. Painel do parceiro partner.market.yandex.ru, seção Configurações, item Acesso à API. A chave vai no cabeçalho Api-Key, host api.partner.market.yandex.ru.

Negócio e campanha são identificadores diferentes. Parte dos métodos é endereçada pelo identificador do negócio, parte pelo número da campanha (loja). Substituir um pelo outro não gera erro de acesso, mas sim uma resposta vazia, o que confunde ainda mais.

Onde ela fica. Em ~/.marketplace-mcp/cabinets.json com permissões chmod 600, localmente.

variável	segredo	o que é
YANDEX_MARKET_API_KEY	sim	Chave de API do painel do parceiro, seção Configurações → API.

As chaves não precisam ficar no ambiente: o servidor sabe gerenciar contas e as coloca em ~/.marketplace-mcp/cabinets.json com permissões 600, fora do repositório. Quantas lojas forem necessárias podem ser conectadas, com alternância direto pelo chat.

Mapa de métodos

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

tema	métodos	leitura	escrita	irreversíveis
Pedidos, devoluções e não retiradas	38	19	19	0
Relatórios	27	27	0	0
Produtos e cartões	22	11	8	3
Remessas, entregas e armazéns	21	15	6	0
Avaliações, perguntas e chats	18	11	6	1
Retirada própria e regiões de entrega	15	10	3	2
Preços, tarifas e quarentena	10	6	4	0
Promoção e publicidade	8	4	3	1
Painel e utilitários	6	6	0	0

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

O que perguntar no chat

• mostre os pedidos no Yandex Market da última semana
• qual é o meu índice de qualidade e o que o derruba
• monte um relatório de vendas do mês
• mostre os produtos em quarentena de preço

Erros comuns

Resposta vazia em vez de dados. Na maioria das vezes, o identificador do negócio e o número da campanha foram trocados. Não haverá erro de acesso; a resposta virá correta e vazia.

Erro no nome do campo. O catálogo de métodos foi montado a partir do documento OpenAPI oficial, mas a execução ao vivo em contas reais ainda não foi feita. Imprecisões nos nomes dos campos são possíveis. describe_method mostrará o esquema, call_raw permitirá corrigir a solicitação na hora.

Método não encontrado pelo nome. Procure pelo tema, não pelo nome: pergunte ao agente "o que você sabe fazer no Yandex Market", ele mostrará as seções e escolherá o método sozinho.

Como isso difere de marketplaces-mcp-ru

Em nada, exceto pela composição. marketplaces-mcp-ru instala quatro marketplaces de uma vez e os mantém sob um único servidor; yandex-market-mcp-ru instala apenas um. O código é comum: uma correção no núcleo chega aqui por atualização de dependência, não por cópia.

necessidade	pacote
apenas Yandex Market	yandex-market-mcp-ru
todos os quatro marketplaces	marketplaces-mcp-ru

Quem fez isso

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.