Inteligencia de Ozon MP
API de productos por vendedor de Ozon MCP
Listar un vendedor de Ozon SKUs con ventas, ingresos, precio, puntuación, stock, volumen de negocios, y métricas de ingresos perdidos para el análisis de la competencia. Llámalo REST API o MCP.
Prompts y casos de uso de API de productos por vendedor de Ozon
Después de conectar esta herramienta MCP a tu asistente de IA, puedes plantear las preguntas siguientes. Sustituye los marcadores entre corchetes por tus datos y usa los valores admitidos en Argumentos.
¿Es tu primera vez con Nexscope MCP? Sigue la guía de conexión, y después usa los prompts siguientes. Las pestañas Integración y Parámetros y respuesta contienen los pasos de conexión, un ejemplo de llamada y la referencia técnica.
1. Revise un surtido de productos del vendedor de Ozon
Prompt: Revise el surtido de productos del vendedor de Ozon [seller ID]. Mostrar los resultados disponibles e identificar claramente la información que falta.
2. Investigación en una moneda seleccionada
Prompt: Revise el surtido de productos del vendedor de Ozon [seller ID]. Presentar los valores monetarios disponibles [my selected currency], utilizando [my supplied conversion rate] sólo si la herramienta requiere uno. No compare las cantidades en diferentes monedas.
3. Investigación en una moneda seleccionada para esta búsqueda
Prompt: Revise el surtido de productos del vendedor de Ozon [seller ID]. Presentar los valores monetarios disponibles [my selected currency], utilizando [my supplied conversion rate] sólo si la herramienta requiere uno. No compare las cantidades en diferentes monedas.
4. Revise un período específico de presentación de informes
Prompt: Revise el surtido de productos del vendedor de Ozon [seller ID]. Uso [my chosen reporting period] y mostrar el período con las cifras devueltas. Mantenga las instantáneas datadas distintas de los datos actuales.
5. Continuar los resultados dentro de un límite de página
Prompt: Revise el surtido de productos del vendedor de Ozon [seller ID]. Inicio [my selected page] y retorno [my requested page size] dentro de los límites documentados. Pregunte antes de solicitar otra página y no describa una página como conjunto de datos completo.
6. Priorizar los resultados para la revisión
Prompt: Revise el surtido de productos del vendedor de Ozon [seller ID]. Prioridad [my chosen ranking metric] dentro [my chosen order]. Mantenga la clasificación limitada a los filtros seleccionados y el período de presentación de informes.
7. Incluir listas llenas de vendedores
Prompt: Revise el surtido de productos del vendedor de Ozon [seller ID]. Incluye listados llenos de vendedores en la investigación. Informe sólo lo que los registros seleccionados soportan.
8. Buscar productos Reunir todos los filtros numéricos
Prompt: Revise el surtido de productos del vendedor de Ozon [seller ID]. Mantener productos que satisfagan todos [my numeric conditions]: una medida puede estar por encima, por lo menos, por debajo, por lo menos igual, diferente de, o entre [my selected bounds]. Para una condición entre, suministre los límites inferiores y superiores. Las medidas respaldadas incluyen ventas, precio final, calificación, comentarios, balance de acciones, ingresos, días en stock, días de facturación, lucro perdido y posición de categoría.
Qué debes proporcionar
Sustituye las entradas entre corchetes por tus propios valores. Usa únicamente los mercados, períodos y formatos de entrada documentados.
Las estimaciones y clasificaciones devueltas corresponden a los datos y al período seleccionados. Un valor ausente no equivale a cero y una página de resultados no representa todo el mercado.
Paso 1 · Conectar
Conecta tu asistente de IA
Conecta un cliente MCP compatible a Nexscope y selecciona esta herramienta en tu asistente. Completa la autenticación en la configuración de conexión del cliente.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAutenticación
Usa el código de autorización OAuth 2.1 con PKCE y el ámbito mcp:tools. Las claves de API siguen siendo una opción de compatibilidad admitida.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx¿Usas una clave de API? Obtén tu clave en Acceso a la API e inclúyela en el encabezado Authorization que se muestra arriba.
Llamar a esta herramienta MCP
nexscope_ozon_seller_productshttps://api.nexscope.ai/mcptools/callInicializa una sesión HTTP Streamable MCP 2025-11-25 en https://api.nexscope.ai/mcp y después usa tools/call.
{
"jsonrpc": "2.0",
"id": "ozon-seller-products-1",
"method": "tools/call",
"params": {
"name": "nexscope_ozon_seller_products",
"arguments": {
"currencyRate": 1,
"endDate": "2026-01-31",
"page": 1,
"pageSize": 100,
"sellerId": "1581151",
"startDate": "2026-01-01"
}
}
}MCP 2025-11-25 · Streamable HTTPLa respuesta SSE del POST inicial comunica el progreso. El flujo SSE por GET transmite notificaciones; si se restablece la conexión, consulta la tarea asíncrona existente en vez de enviarla de nuevo.
Argumentos
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
sellerId | string | obligatorio | Ozon vendedor ID ( cuerda numérica), que coincide con el identificador vendedor en el producto lists/seller rankings Ejemplo: 1581151 |
startDate | string | opcional | Fecha de inicio de las estadísticas YYYY-MM-DD; último es ayer Ejemplo: 2026-01-01 |
endDate | string | opcional | Fecha final de las estadísticas YYYY-MM-DD; último es ayer Ejemplo: 2026-01-01 |
page | integer | opcional | Número de página, a partir de 1 Ejemplo: 1 |
pageSize | integer | opcional | Filas por página 1-100, por defecto 100 Ejemplo: 100 |
sortField | string | opcional | Nombre de la columnasnake_case), e.g., ventas, ingresos, final_price, balance, calificación |
sortDirection | string | opcional | asc / desc |
currency | string | opcional | Código de moneda, predeterminado RUB, e.g., USD Ejemplo: RUB |
currencyRate | integer | opcional | Tipo de cambio personalizado (para moneda no predeterminada) Ejemplo: 1 |
includeFbs | boolean | opcional | Ya sea para incluir FBS datos Ejemplo: false |
filters | array | opcional | Condiciones numéricas combinadas con AND Ejemplo: [] |
filters[].field | string | opcional | Snake-case numeric column name, such as sales, final_price, puntuación, comentarios, balance, revenue, days_in_stock, turnover_days, lost_profit o category_position Ejemplo: sales |
filters[].op | string | opcional | GTE, LTE, GT, LT, EQ, NOT_EQ o BETWEEN Ejemplo: GTE |
filters[].value | number | opcional | Valor primario; límite inferior BETWEEN Ejemplo: 1 |
filters[].value2 | number | opcional | Límite superior requerido para BETWEEN Ejemplo: 2 |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | string | opcional | Código de devolución, `"200"` éxito |
msg | string | opcional | Mensaje; éxito `ok` |
total | integer | opcional | El número total de visitas del vendedor |
products | array | opcional | Lista de productos |
columns | array | opcional | Definición de columna |
costTime | integer | opcional | Tiempo de interfase (milliseconds) |
costToken | integer | opcional | Cantidad de Token consumida |
type | string | opcional | tipo de respuesta |
productId | integer | opcional | SKU ID |
title | string | opcional | Nombre del producto (ruso) |
brand | string | opcional | marca |
brandId | integer | opcional | Marca ID |
sellerName | string | opcional | Nombre del vendedor |
sellerId | integer | opcional | Vendedor ID |
category | string | opcional | Carril de categoría (ruso, ruso) `/` separados) |
nicheName | string | opcional | Track path (ruso) |
nicheId | integer | opcional | Pista ID |
country | string | opcional | País de venta, Ozon Hengwei `RU` |
firstDate | string | opcional | Fecha de lanzamiento (`yyyy-MM-dd`) |
imageUrl | string | opcional | Imagen principal URL |
productPageUrl | string | opcional | Página de producto URL |
price | number | opcional | Precio de venta actual |
oldPrice | number | opcional | Precio original antes del descuento |
ozonCardPrice | number | opcional | Ozon Card Price |
currency | string | opcional | Símbolo de moneda (`₽` / `$` / `€`) |
rating | number | opcional | Valoración, 0-5 |
reviewCount | integer | opcional | Número de comentarios |
balance | integer | opcional | Inventario actual |
balanceFbs | integer | opcional | FBS inventario (número de artículos enviados por el vendedor) |
frozenStocks | integer | opcional | inventario lento |
warehousesCount | integer | opcional | Número de FBO posiciones |
isFbs | boolean | opcional | Ya sea para enviar por FBS |
salesPerDay | number | opcional | Volumen promedio de ventas diarias (pieces/day) |
monthlySalesUnits | integer | opcional | Volumen de ventas durante el período estadístico |
monthlySalesRevenue | number | opcional | Ventas durante el período estadístico |
lostProfit | number | opcional | Las ventas perdidas (causadas por acciones, etc.) |
daysInSite | integer | opcional | Número de días en venta (período estadístico, incluidos días fuera de existencia) |
daysInStock | integer | opcional | días en stock |
turnoverDays | number | opcional | Días de giro (los más pequeños, más rápidos) |
position | integer | opcional | Clasificación dentro de la dimensión actual de la consulta (este punto final es el vendedor) |
categoryPosition | integer | opcional | Ranking dentro de la categoría |
revenueSharePercent | number | opcional | La relación de ventas de este SKU en la dimensión actual de la consulta, 0-100 |
Preguntas y respuestas de ejemplo
Se basa en una muestra de la documentación publicada, no en una llamada en vivo a la herramienta.
Tu pregunta
Revise el surtido de productos de un vendedor de Ozon. vendedor ID 985891.
Respuesta de ejemplo
En la muestra publicada, el primer registro mostrado es “Соль таблетированная для вододготовки умягчения воды 25 кг Уцененый товар”. Su precio comunicado es 1746. Su calificación reportada es 0. Estas observaciones se aplican únicamente al ámbito de registro y presentación de informes mostrados.
Sobre esta muestra: Extracto de la documentación publicada, no de una consulta en vivo. Las listas muestran como máximo dos registros y algunos textos largos pueden estar abreviados. Si faltan unidades, fechas o datos sobre la cobertura, el extracto no permite determinarlos ni representa el conjunto de datos completo. Los campos opcionales con conflictos de cadena-versus-número en la documentación fuente se omiten de esto MCP extracto; la muestra original permanece inalterada en la evidencia fuente.
Ver los datos de ejemplo publicados (JSON)
Ejemplo de datos REST publicado. Para llamar a esta herramienta, consulta los argumentos MCP en Parámetros y respuesta.
Ejemplo de datos
Ejemplo de solicitud y respuesta
Parámetros de solicitud
{
"sellerId": "985891",
"page": 1,
"pageSize": 1,
"currency": "RUB"
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"total": 1,
"costTime": 3349,
"columns": [
{
"filterable": true,
"cellType": "number",
"field": "productId",
"sortable": true,
"title": "SKU ID"
},
{
"filterable": true,
"cellType": "text",
"field": "title",
"sortable": true,
"title": "商品名称"
},
{
"filterable": true,
"cellType": "text",
"field": "productPageUrl",
"sortable": true,
"title": "商品页URL"
},
{
"filterable": true,
"cellType": "text",
"field": "imageUrl",
"sortable": true,
"title": "主图URL"
},
{
"filterable": true,
"cellType": "text",
"field": "brand",
"sortable": true,
"title": "品牌"
},
{
"filterable": true,
"cellType": "number",
"field": "brandId",
"sortable": true,
"title": "品牌ID"
},
{
"filterable": true,
"cellType": "text",
"field": "sellerName",
"sortable": true,
"title": "卖家"
},
{
"filterable": true,
"cellType": "number",
"field": "sellerId",
"sortable": true,
"title": "卖家ID"
},
{
"filterable": true,
"cellType": "text",
"field": "category",
"sortable": true,
"title": "品类路径"
},
{
"filterable": true,
"cellType": "number",
"field": "categoryPosition",
"sortable": true,
"title": "品类排名"
},
{
"filterable": true,
"cellType": "number",
"field": "nicheId",
"sortable": true,
"title": "赛道ID"
},
{
"filterable": true,
"cellType": "text",
"field": "nicheName",
"sortable": true,
"title": "赛道路径"
},
{
"filterable": true,
"cellType": "text",
"field": "currency",
"sortable": true,
"title": "币种符号"
},
{
"filterable": true,
"cellType": "number",
"field": "price",
"sortable": true,
"title": "当前售价"
},
{
"filterable": true,
"cellType": "number",
"field": "averagePrice",
"sortable": true,
"title": "均价"
},
{
"filterable": true,
"cellType": "number",
"field": "minPrice",
"sortable": true,
"title": "最低价"
},
{
"filterable": true,
"cellType": "number",
"field": "maxPrice",
"sortable": true,
"title": "最高价"
},
{
"filterable": true,
"cellType": "number",
"field": "ozonCardPrice",
"sortable": true,
"title": "Ozon Card 价"
},
{
"filterable": true,
"cellType": "number",
"field": "oldPrice",
"sortable": true,
"title": "原价"
},
{
"filterable": true,
"cellType": "number",
"field": "rating",
"sortable": true,
"title": "评分"
},
{
"filterable": true,
"cellType": "number",
"field": "reviewCount",
"sortable": true,
"title": "评论数"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits",
"sortable": true,
"title": "销量"
},
{
"filterable": true,
"cellType": "number",
"field": "salesPerDay",
"sortable": true,
"title": "日均销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesRevenue",
"sortable": true,
"title": "销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "lostProfit",
"sortable": true,
"title": "损失销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "revenueSharePercent",
"sortable": true,
"title": "营收占比"
},
{
"filterable": true,
"cellType": "number",
"field": "balance",
"sortable": true,
"title": "库存"
},
{
"filterable": true,
"cellType": "number",
"field": "balanceFbs",
"sortable": true,
"title": "FBS库存"
},
{
"filterable": true,
"cellType": "number",
"field": "daysInStock",
"sortable": true,
"title": "有货天数"
},
{
"filterable": true,
"cellType": "number",
"field": "daysInSite",
"sortable": true,
"title": "在售天数"
},
{
"filterable": true,
"cellType": "number",
"field": "turnoverDays",
"sortable": true,
"title": "周转天数"
},
{
"filterable": true,
"cellType": "number",
"field": "frozenStocks",
"sortable": true,
"title": "滞销库存"
},
{
"filterable": true,
"cellType": "number",
"field": "warehousesCount",
"sortable": true,
"title": "分仓数"
},
{
"filterable": true,
"cellType": "text",
"field": "isFbs",
"sortable": true,
"title": "是否FBS仓发货"
},
{
"filterable": true,
"cellType": "text",
"field": "firstDate",
"sortable": true,
"title": "上架日期"
},
{
"filterable": true,
"cellType": "text",
"field": "country",
"sortable": true,
"title": "销售国"
},
{
"filterable": true,
"cellType": "number",
"field": "position",
"sortable": true,
"title": "排名"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceType",
"sortable": true,
"title": "数据源"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceTool",
"sortable": true,
"title": "来源工具"
}
],
"type": "productWorkbenches",
"products": [
{
"daysInSite": 9,
"warehousesCount": 0,
"sellerName": "ART LITE",
"nicheName": "Строительство и ремонт/Водоснабжение/Водоочистка и фильтры/Умягчители воды",
"rating": 0,
"title": "Соль таблетированная для водоподготовки и умягчения воды 25 кг Уцененный товар",
"frozenStocks": 0,
"productPageUrl": "https://www.ozon.ru/context/detail/id/5932831435/",
"salesPerDay": 0.03,
"isFbs": false,
"sellerId": 985891,
"sourceTool": "MPSTATS-Ozon商品列表",
"balance": 0,
"reviewCount": 0,
"price": 1746,
"imageUrl": "https://ir.ozone.ru/s3/multimedia-1-3/d100/9839676423.jpg",
"daysInStock": 1,
"firstDate": "2026-10-01",
"currency": "₽",
"ozonCardPrice": 1571,
"brand": "ТУЛЬСКАЯ СОЛЬ",
"categoryPosition": 0,
"revenueSharePercent": 100,
"productId": "5932831435",
"oldPrice": 7000,
"balanceFbs": 0,
"lostProfit": 50634,
"turnoverDays": 0,
"monthlySalesRevenue": 1746,
"sourceType": "ozon",
"minPrice": 1549,
"averagePrice": 1746,
"maxPrice": 2565,
"category": "",
"nicheId": 33051,
"monthlySalesUnits": 1
}
]
}
}Ver el formato de solicitud y respuesta MCP
Ejemplos
Se basa en una muestra de la documentación publicada, no en una llamada en vivo a la herramienta.
La estructura JSON-RPC siguiente muestra cómo se presentan en MCP los argumentos y los datos indicados. No procede de una captura de tráfico ni demuestra que la llamada se haya completado. Los ejemplos de flujo de trabajo no muestran un resultado.
Solicitud MCP
{
"jsonrpc": "2.0",
"id": "ozon-seller-products-example",
"method": "tools/call",
"params": {
"name": "nexscope_ozon_seller_products",
"arguments": {
"sellerId": "985891",
"page": 1,
"pageSize": 1,
"currency": "RUB"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "ozon-seller-products-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"products\":[{\"title\":\"Соль таблетированная для водоподготовки и умягчения воды 25 кг Уцененный товар\",\"price\":1746,\"rating\":0,\"monthlySalesUnits\":1,\"daysInSite\":9,\"warehousesCount\":0,\"sellerName\":\"ART LITE\",\"nicheName\":\"Строительство и ремонт/Водоснабжение/Водоочистка и фильтры/Умягчители воды\",\"frozenStocks\":0,\"productPageUrl\":\"https://www.ozon.ru/context/detail/id/5932831435/\",\"salesPerDay\":0.03}],\"total\":1}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"products": [
{
"title": "Соль таблетированная для водоподготовки и умягчения воды 25 кг Уцененный товар",
"price": 1746,
"rating": 0,
"monthlySalesUnits": 1,
"daysInSite": 9,
"warehousesCount": 0,
"sellerName": "ART LITE",
"nicheName": "Строительство и ремонт/Водоснабжение/Водоочистка и фильтры/Умягчители воды",
"frozenStocks": 0,
"productPageUrl": "https://www.ozon.ru/context/detail/id/5932831435/",
"salesPerDay": 0.03
}
],
"total": 1
}
},
"isError": false
}
}