ozon-mcp-ru
API de Ozon Seller en tu asistente de IA: 441 métodos para productos, pedidos FBS y FBO, precios, existencias, finanzas y reseñas, con una clase de seguridad en cada método.
Documentación
ozon-mcp-ru
API Ozon Seller para asistentes de IA: productos, pedidos FBS y FBO, precios, existencias, finanzas, reseñas. El catálogo lo ejecuta el servidor, cada método tiene una clase de acceso.
El paquete levanta un solo servidor, Ozon Seller, y nada más. El servidor, el catálogo y el
núcleo vienen como dependencia de marketplaces-mcp-ru:
aquí están el nombre, el punto de entrada y la documentación para un solo marketplace.
Instalación
El paquete está en PyPI, así que la línea es una sola:
uvx ozon-mcp-ru
Si necesitas la rama main, y no el 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": "..." }
}
}
}
Tercera vía, si el agente sabe usar skills: él mismo instalará el servidor y configurará el cliente.
npx skills add ilyautov/ozon-mcp-ru
Claves
Seller API: Client-Id y Api-Key. Entra al panel de seller.ozon.ru, abre Configuración, sección API-keys. Ozon entrega un par: Client-Id (número) y Api-Key. Ambos van en los encabezados con los mismos nombres, el host de la solicitud es api-seller.ozon.ru.
Performance API: client_id y client_secret. El panel de publicidad vive por separado y se autoriza con OAuth2: el par client_id y client_secret se cambia por un token, el host es api-performance.ozon.ru. Las claves de Seller API no funcionan allí, y viceversa.
Dónde guardarlas para no tenerlas expuestas. El servidor pedirá las claves en el primer arranque y las guardará en ~/.marketplace-mcp/cabinets.json con permisos chmod 600. No llegan al repositorio ni al chat. Se pueden conectar varias tiendas y cambiar entre ellas directamente desde el chat.
| variable | secreto | qué es |
|---|---|---|
OZON_CLIENT_ID | sí | Client-Id del panel seller.ozon.ru, Configuración → API-keys. |
OZON_API_KEY | sí | Api-Key del mismo par. Ambos van en los encabezados homónimos. |
No es necesario tener las claves en el entorno: el servidor sabe gestionar cuentas y las guarda en
~/.marketplace-mcp/cabinets.json con permisos 600, fuera del repositorio. Se conectan tantas
tiendas como haga falta, el cambio se hace directamente desde el chat.
Mapa de métodos
El catálogo está en la dependencia como ozon_mcp/endpoints.yaml:
441 métodos, de los cuales 190 son de lectura, 240 de escritura y 11 irreversibles.
El servidor ejecuta exactamente ese archivo, por lo que la tabla no puede divergir del código.
| tema | métodos | lectura | escritura | irreversibles |
|---|---|---|---|---|
| Pedidos FBS y entrega | 112 | 37 | 73 | 2 |
| Pedidos FBO y almacenes | 64 | 37 | 25 | 2 |
| Productos y tarjetas | 55 | 30 | 24 | 1 |
| Cross-dock FBP | 45 | 15 | 27 | 3 |
| Promociones y publicidad | 31 | 9 | 21 | 1 |
| Devoluciones y cancelaciones | 30 | 11 | 19 | 0 |
| Reseñas, preguntas y chats | 27 | 10 | 16 | 1 |
| Finanzas e informes | 25 | 11 | 14 | 0 |
| Panel y utilidades | 22 | 12 | 9 | 1 |
| Precios y existencias | 21 | 11 | 10 | 0 |
| Analítica | 9 | 7 | 2 | 0 |
Análisis detallado con parámetros y límites: https://marketplaces-mcp-ru.aifrontier.tech/ozon-api.html
Qué preguntar en el chat
- muéstrame las ventas en Ozon de la semana por día
- qué productos tienen el índice de precio en rojo
- saca el informe de devengos del mes pasado
- recopila las reseñas por debajo de 4 estrellas y agrupa las quejas
Errores frecuentes
401 o «Client-Id should be positive integer», aunque la clave sea correcta. Lo primero que hay que mirar no son las variables de entorno, sino ~/.marketplace-mcp/cabinets.json: la cuenta activa en ese archivo tiene prioridad sobre env y silenciosamente tapa lo que exportaste en la terminal.
404 en un método que seguro existe. Ozon va cambiando de versiones, y distintas secciones viven en versiones distintas: la lista de productos en v3, los atributos en v4, los precios en v5. Ante un 404, revisa la versión en la ruta antes que cualquier otra cosa.
405 Method Not Allowed. Lo más probable es que sea un método importado de la especificación: la ruta de esos registros es fiable, pero el verbo HTTP no siempre lo es. Una prueba en vivo encontró métodos marcados como GET que en realidad son POST. Compruébalo con la documentación o llámalo a través de call_raw.
En qué se diferencia de marketplaces-mcp-ru
En nada, salvo en la composición. marketplaces-mcp-ru instala cuatro marketplaces a la vez y los mantiene
bajo un mismo servidor; ozon-mcp-ru instala uno solo. El código es común: un cambio en el núcleo llega
aquí con una actualización de la dependencia, no copiando nada.
El panel de publicidad de Ozon es una API aparte con otra autorización. También está en marketplaces-mcp-ru, comando ozon-perf-mcp, 45 métodos.
| necesitas | paquete |
|---|---|
| solo Ozon Seller | ozon-mcp-ru |
| los cuatro marketplaces | marketplaces-mcp-ru |
Quién lo hizo
Ilya Utov, laboratorio AI Frontier. Sobre cómo funcionan estas herramientas por dentro, escribo en Telegram y LinkedIn.
También están business-mcp-ru (hh.ru, VK, Diadoc, SBIS, Chestny ZNAK), moysklad-mcp-ru y humanizer-ru.
Todos los proyectos en una lista, clasificados por propósito: ilyautov.github.io.
Licencia
MIT, ver LICENSE.