ozon-mcp-ru
API do Ozon Seller no seu assistente de IA: 441 métodos para produtos, pedidos FBS e FBO, preços, estoques, finanças e avaliações, com uma classe de segurança em cada método.
Documentação
ozon-mcp-ru
API Ozon Seller para assistentes de IA: produtos, pedidos FBS e FBO, preços, estoques, finanças, avaliações. O catálogo é executado pelo servidor, cada método possui uma classe de acesso.
O pacote sobe um único servidor, Ozon Seller, 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 ozon-mcp-ru
Se precisar do branch main, e não do release:
uvx --from git+https://github.com/ilyautov/ozon-mcp-ru ozon-mcp-ru
Claude Desktop, claude_desktop_config.json:
{
"mcpServers": {
"ozon": {
"command": "uvx",
"args": ["ozon-mcp-ru"],
"env": { "OZON_CLIENT_ID": "...", "OZON_API_KEY": "..." }
}
}
}
O terceiro caminho, se o agente suportar skills: ele instalará o servidor e configurará o cliente sozinho.
npx skills add ilyautov/ozon-mcp-ru
Chaves
Seller API: Client-Id e Api-Key. Acesse o painel seller.ozon.ru, abra Configurações, seção API-keys. A Ozon emite um par: Client-Id (número) e Api-Key. Ambos vão nos cabeçalhos com os mesmos nomes, o host da requisição é api-seller.ozon.ru.
Performance API: client_id e client_secret. O painel de anúncios fica separado e autentica via OAuth2: o par client_id e client_secret é trocado por um token, o host é api-performance.ozon.ru. As chaves da Seller API não funcionam lá, e vice-versa.
Onde guardar para não armazenar de forma exposta. O servidor solicitará as chaves no primeiro início e as colocará em ~/.marketplace-mcp/cabinets.json com permissões chmod 600. Elas não vão para o repositório nem para o chat. É possível conectar várias lojas e alternar entre elas diretamente pelo chat.
| variável | segredo | o que é |
|---|---|---|
OZON_CLIENT_ID | sim | Client-Id do painel seller.ozon.ru, Configurações → API-keys. |
OZON_API_KEY | sim | Api-Key do mesmo par. Ambos vão nos cabeçalhos com os mesmos nomes. |
As chaves não precisam ficar no ambiente: o servidor gerencia contas e as coloca em
~/.marketplace-mcp/cabinets.json com permissões 600, fora do repositório. Quantas lojas
forem necessárias, a alternância é direto pelo chat.
Mapa de métodos
O catálogo está na dependência como ozon_mcp/endpoints.yaml:
441 métodos, sendo 190 de leitura, 240 de escrita e 11 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 FBS e entrega | 112 | 37 | 73 | 2 |
| Pedidos FBO e armazéns | 64 | 37 | 25 | 2 |
| Produtos e fichas | 55 | 30 | 24 | 1 |
| Cross-dock FBP | 45 | 15 | 27 | 3 |
| Promoções e divulgação | 31 | 9 | 21 | 1 |
| Devoluções e cancelamentos | 30 | 11 | 19 | 0 |
| Avaliações, perguntas e chats | 27 | 10 | 16 | 1 |
| Finanças e relatórios | 25 | 11 | 14 | 0 |
| Painel e utilitários | 22 | 12 | 9 | 1 |
| Preços e estoques | 21 | 11 | 10 | 0 |
| Analytics | 9 | 7 | 2 | 0 |
Análise detalhada com parâmetros e limites: https://marketplaces-mcp-ru.aifrontier.tech/ozon-api.html
O que perguntar no chat
- mostre as vendas na Ozon da última semana por dia
- quais produtos estão com índice de preço vermelho
- extraia o relatório de acréscimos do mês passado
- colete avaliações abaixo de 4 estrelas e agrupe as reclamações
Erros frequentes
401 ou "Client-Id should be positive integer", mesmo com a chave correta. Primeiro, não olhe as variáveis de ambiente, mas sim ~/.marketplace-mcp/cabinets.json: a conta ativa nesse arquivo tem prioridade sobre o env e silenciosamente ofusca o que você exportou no terminal.
404 em um método que certamente existe. A Ozon varia entre versões, e diferentes seções vivem em versões diferentes: lista de produtos em v3, atributos em v4, preços em v5. Em caso de 404, verifique a versão no caminho antes de qualquer outra coisa.
405 Method Not Allowed. Provavelmente é um método importado da especificação: o caminho desses registros é confiável, mas o verbo HTTP nem sempre. Testes ao vivo encontraram métodos marcados como GET que na prática são POST. Confira a documentação ou chame via call_raw.
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; ozon-mcp-ru instala apenas um. O código é comum: uma correção no núcleo chega
aqui via atualização da dependência, não por cópia.
O painel de anúncios da Ozon é uma API separada com outra autenticação. Ele também está em marketplaces-mcp-ru, comando ozon-perf-mcp, 45 métodos.
| necessidade | pacote |
|---|---|
| apenas Ozon Seller | ozon-mcp-ru |
| todos os quatro marketplaces | marketplaces-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.