Inteligencia de Ozon SR
API de consulta de detalles de productos de Ozon MCP
Recuperar un solo Ozon SKU's precios, ventas, stock, ranking, tendencia, marca, vendedor, cumplimiento, peso, y datos de la lista. Llámalo REST API o MCP.
Prompts y casos de uso de API de consulta de detalles de productos 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. Inspeccione las métricas disponibles para un Ozon SKU
Prompt: Inspeccione las métricas disponibles para un Ozon SKU para [SKU]. Mostrar los resultados disponibles e identificar claramente la información que falta.
2. Revise un período específico de presentación de informes
Prompt: Inspeccione las métricas disponibles para un Ozon SKU para [SKU]. Uso [my chosen reporting period] y mostrar el período con las cifras devueltas. Mantenga las instantáneas datadas distintas de los datos actuales. Para esta selección, elija los últimos 7 días, los últimos 30 días, los últimos 60 días, los últimos 90 días, los últimos 180 días o los últimos 365 días.
3. Comparar ventas diarias, ingresos y acciones
Prompt: Inspeccione las métricas disponibles para un Ozon SKU para [SKU]. Uso [my chosen reporting period] y mostrar el período con las cifras devueltas. Mantenga las instantáneas datadas distintas de los datos actuales. Para esta selección, elija los últimos 7 días, los últimos 30 días, los últimos 60 días, los últimos 90 días, los últimos 180 días o los últimos 365 días. Alinear devolvió ventas diarias, ingresos, precio y stock por fecha para el período seleccionado. Conserva la moneda y señala las fechas ausentes; no atribuyas los cambios a una causa sin pruebas.
4. Examinar el contexto de clasificación de la categoría
Prompt: Inspeccione las métricas disponibles para un Ozon SKU para [SKU]. Uso [my chosen reporting period] y mostrar el período con las cifras devueltas. Mantenga las instantáneas datadas distintas de los datos actuales. Para esta selección, elija los últimos 7 días, los últimos 30 días, los últimos 60 días, los últimos 90 días, los últimos 180 días o los últimos 365 días. Mostrar rangos de categoría devueltos con fechas y trayectorias de categoría. Mantenga las filas específicas de la categoría separadas y no las convierta en rango general de mercado.
5. Revisión Lista y Contexto Vendedor
Prompt: Inspeccione las métricas disponibles para un Ozon SKU para [SKU]. Uso [my chosen reporting period] y mostrar el período con las cifras devueltas. Mantenga las instantáneas datadas distintas de los datos actuales. Para esta selección, elija los últimos 7 días, los últimos 30 días, los últimos 60 días, los últimos 90 días, los últimos 180 días o los últimos 365 días. Resume el título, las imágenes y las reseñas del producto, así como los datos devueltos sobre el vendedor y la gestión de pedidos. Mantenga las estimaciones de fuentes separadas de los hechos del producto.
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.
Los identificadores de usuarios y miembros son contexto de atribución de cuentas, no filtros de investigación. Use el contexto de cuenta autenticada; no invente otro usuario o miembro ID.
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_product_detail_searchhttps://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-product-detail-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_ozon_product_detail_search",
"arguments": {
"dateRange": "past_30_days",
"sku": "1664362124"
}
}
}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 |
|---|---|---|---|
sku | string | obligatorio | Producto SKU (Ozon SKU, e.g., 175924376). Este es el sku devuelto por otro Nexscope Herramientas de Ozon Ejemplo: 1664362124 |
dateRange | string | opcional | Sales/metrics ventana de estadísticas, por defecto past_30_days. Opciones: past_7_days / past_30_days / past_60_days / past_90_days / past_180_days / past_365_days Ejemplo: past_30_days |
uId | string | opcional | Usuario ID (max 1000) Ejemplo: example-id |
memberId | string | opcional | Miembro ID (un identificador miembro único; un usuario puede pertenecer a múltiples equipos; los datos se atribuyen a memberId, max 1000) Ejemplo: example-id |
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"` indica éxito; devuelto cuando tenga éxito. |
errcode | integer | opcional | Código de error `200` indica el éxito; sólo este campo puede ser devuelto cuando hay un error de negocio. |
msg | string | opcional | Mensaje; El éxito `ok`. |
errmsg | string | opcional | Mensaje de error; éxito `ok`, error de negocio es una descripción de la razón. |
total | integer | opcional | Devuelve el número de registros, 1 para un éxito y 0 para una señorita. |
totalSales | integer | opcional | Ventas totales dentro de la ventana estadística. |
dailySales | number | opcional | Promedio de ventas por día. |
totalRevenue | number | opcional | Volumen de ventas dentro de la ventana estadística, en rublos. |
stock | integer | opcional | Inventario. |
startDate | string | opcional | Fecha de inicio de la ventana de estadísticas. |
endDate | string | opcional | Fecha final de la ventana de estadísticas. |
salesTrendVOList | array | opcional | Serie de datos de ventas diarias, los campos de elementos se muestran en la tabla siguiente. |
categoryRanks | array | opcional | Historial de clasificación de la categoría de producto, campos de elementos se muestran en la tabla siguiente. |
products | array | opcional | Lista de detalles del producto; generalmente 1 en hit. |
data | array | opcional | Datos de retorno, el contenido es exactamente igual que `products`. |
columns | array | opcional | Definición de columna, elementos que contienen `field`, `title`, `cellType`, `sortable`, `filterable`. |
type | string | opcional | Tipo de pantalla de respuesta, como `productWorkbenches`. |
costTime | integer | opcional | La interfaz consume tiempo en milisegundos. |
costToken | integer | opcional | El número de fichas consumidas. |
sku | integer | opcional | Producto SKU. |
productId | integer | opcional | Producto unificado ID, mapeado desde `sku`. |
title | string | opcional | Título del producto. |
price | number | opcional | Precio de productos básicos en rublos. |
currency | string | opcional | Moneda fija `₽`. |
reviewRating | number | opcional | Evaluaciones de productos. |
rating | number | opcional | Anotación unificada, mapeado desde `reviewRating`. |
reviewCount | integer | opcional | Número de comentarios. |
questionsAndAnswers | integer | opcional | QA cantidad. |
brandName | string | opcional | Nombre de marca. |
brand | string | opcional | Marca unificada, mapeada desde `brandName`. |
brandId | integer | opcional | Marca ID. |
brandUrl | string | opcional | Enlace de marca. |
sellerName | string | opcional | Nombre del vendedor. |
sellerId | integer | opcional | Vendedor ID; un valor negativo indica un vendedor autooperado en la plataforma Ozon. |
fulfillment | array | opcional | Métodos de envío de productos, como `["FBO"]` o `["OZON"]`, puede contener múltiples valores. |
upTime | integer | opcional | Tiempo de estante, milisegundos veces. |
upDays | integer | opcional | Número de días en estante. |
upMonths | integer | opcional | Número de meses en estantes. |
imageUrl | string | opcional | Imagen principal unificada URL, mapeado desde la primera imagen de `imageUrls`. |
imageUrls | array | opcional | Lista de imagen de producto URLs. |
productUrl | string | opcional | Producto URL. |
productPageUrl | string | opcional | Página de producto unificada URL, mapeado desde `productUrl`. |
categoryInfo | object | opcional | La información y la estructura de la categoría de producto figuran en el cuadro que figura a continuación. |
monthlySalesUnits | integer | opcional | El volumen de ventas mensuales unificado es en realidad igual a `totalSales` en la ventana estadística actual. |
monthlySalesRevenue | number | opcional | Venta mensual unificada, en realidad igual a `totalRevenue` en la ventana estadística actual. |
sourceType | string | opcional | Fuente de datos fijada `ozon`. |
weight | number | opcional | Peso del producto en gramos; digital/service los artículos no pueden ser devueltos. |
grossMargin | number | opcional | Margen de ganancia bruta; algunos artículos pueden no ser devueltos. |
date | string | opcional | Fecha. |
sales | integer | opcional | Volumen de ventas el día, `0` indica que no hay volumen de ventas el día. |
revenue | number | opcional | Volumen de ventas para el día, en rublos. |
price | number | opcional | Precio de hoy en rublos. |
stock | integer | opcional | Inventario del día. |
reviewCount | integer | opcional | El número de comentarios a partir de ese día, valor acumulativo. |
reviewRating | number | opcional | Clasificación de hoy. |
date | string | opcional | Mes o día específico del mes. |
rank | integer | opcional | Clasificación de categoría. |
count | integer | opcional | Cuenta estadística, el calibre está sujeto al regreso real de la puerta de entrada. |
cnTitlePath | string | opcional | Camino de la categoría china. |
enTitlePath | string | opcional | Camino de la categoría de inglés. |
titlePath | string | opcional | Categoría ruta original. |
category | object | opcional | El objeto final de la categoría, los campos se muestran en la tabla siguiente. |
fullCategoryId | array | opcional | Categoría completa ID camino, array de cuerdas. |
cnTitle | string | opcional | Categoría Nombre chino. |
enTitle | string | opcional | Categoría Nombre de inglés. |
title | string | opcional | Título original de la categoría. |
level | integer | opcional | Nivel de categoría. |
id | string | opcional | Categoría ID. |
pid | string | opcional | Categoría de parientes ID. |
crossBorderSellable | boolean | opcional | Ya sea para apoyar las ventas transfronterizas. |
disabled | boolean | opcional | Ya sea para desactivar. |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Inspeccione las métricas disponibles para un Ozon SKU. Uso SKU 1664362124.
Explicación ilustrativa de la respuesta
El resultado ilustrativo muestra el título: Ejemplo producto; id: ejemplo-id; producto id: 10. Estas cifras describen sólo el registro mostrado. A partir de este ejemplo, no se pueden calcular las medidas que faltan.
Sobre esta muestra: Ejemplo ilustrativo con registros ficticios; no procede de una llamada real. Los identificadores, precios y recuentos son datos de demostración.
No hay datos de ejemplo publicados para esta página. Una ilustración del formato o una guía de flujo de trabajo no sustituye un resultado publicado.
Ver el formato de solicitud y respuesta MCP
Ejemplos
Ejemplo ilustrativo con datos ficticios, no 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-product-detail-search-example",
"method": "tools/call",
"params": {
"name": "nexscope_ozon_product_detail_search",
"arguments": {
"dateRange": "past_30_days",
"sku": "1664362124"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "ozon-product-detail-search-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"products\":[{\"title\":\"Example product\",\"id\":\"example-id\",\"productId\":10,\"sellerId\":10}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"products": [
{
"title": "Example product",
"id": "example-id",
"productId": 10,
"sellerId": 10
}
]
}
},
"isError": false
}
}