Inteligencia de Ozon MP

API de detalles de productos de Ozon MCP

Recuperar detalles completos para hasta 100 Ozon SKUs. Consulta esta API mediante REST o MCP con tu clave de API de Nexscope.

CosteRecent Avg. 25 · Range 10–25 créditos por llamadaPrueba en línea

Prompts y casos de uso de API 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. Recuperar detalles completos para hasta 100 Ozon SKUs

Prompt: Recuperar detalles completos para hasta 100 Ozon SKUs para [product ID]. 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: Recuperar detalles completos para hasta 100 Ozon SKUs para [product 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.

3. Incluir listas llenas de vendedores

Prompt: Recuperar detalles completos para hasta 100 Ozon SKUs para [product ID]. Incluye listados llenos de vendedores en la investigación. Informe sólo lo que los registros seleccionados soportan.

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/json

Autenticació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

Nombre de la herramienta MCP

nexscope_ozon_product_detail

Punto de conexión MCP

https://api.nexscope.ai/mcp

Método JSON-RPC

tools/call

Inicializa 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-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_ozon_product_detail",
    "arguments": {
      "endDate": "2025-03-31",
      "includeFbs": false,
      "productId": 1786874757,
      "startDate": "2025-03-01"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

La 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
`productId`	`integer\|string`	obligatorio	Un producto de Ozon SKU como un entero o cadena; arrays y productIds no se acepta Ejemplo: 1786874757
`startDate`	`string`	opcional	Fecha de inicio de las estadísticas, formato YYYY-MM-DD; último es ayer Ejemplo: 2025-03-01
`endDate`	`string`	opcional	Fecha final de la estadística, formato YYYY-MM-DD; último es ayer Ejemplo: 2025-03-31
`includeFbs`	`boolean`	opcional	Ya sea para incluir FBS los datos solicitados SKU Ejemplo: false

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 retorno (cadena), `"200"` indica que el éxito
`errcode`	`integer`	opcional	Código de devolución (integer), `200` indica que el éxito
`total`	`integer`	opcional	Número de SKUs (generalmente 0 o 1, igual a `successCount + failedCount`)
`successCount`	`integer`	opcional	El SKU número de la tarjeta devuelto con éxito (normalmente 0 o 1)
`failedCount`	`integer`	opcional	Número de fracasos SKUs (normalmente 0 o 1)
`failures`	`array`	opcional	Lista detallada de fracasos SKUs (generalmente hasta 1 punto, cada uno conteniendo el fallo `productId` y mensaje de error)
`products`	`array`	opcional	Lista de tarjetas de producto
`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
`sellerName`	`string`	opcional	Nombre del vendedor
`sellerId`	`integer`	opcional	Vendedor ID
`sellerIsBestSeller`	`boolean`	opcional	¿Es el vendedor un vendedor más vendido?
`nicheName`	`string`	opcional	Track path (ruso, ruso, `/` delimitado)
`nicheId`	`integer`	opcional	Pista ID
`firstDate`	`string`	opcional	Fecha de lanzamiento (`yyyy-MM-dd`)
`updated`	`string`	opcional	Tiempo de actualización de datos (`yyyy-MM-dd HH:mm:ss`)
`note`	`string`	opcional	Observaciones
`imageUrl`	`string`	opcional	Imagen principal URL (primera imagen grande)
`imageCount`	`integer`	opcional	Número total de imágenes
`productImageUrls`	`array<string>`	opcional	Otra imagen grande URLs excepto la imagen principal
`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	Precio de tarjeta Ozon (precio de descuento de tarjeta bancaria)
`discount`	`integer`	opcional	Descuento, porcentaje entero 0-100
`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
`deliveryScheme`	`string`	opcional	Plan de entrega; `FBO`Entrega del almacén de Ozon, `FBS`= Entrega de Seller
`salesPerDay`	`number`	opcional	Volumen promedio de ventas diarias (pieces/day)
`salesPerDayWithStock`	`number`	opcional	Volumen promedio de ventas diarias en stock (sólo contando días en stock)
`dailySalesRevenue`	`number`	opcional	promedio de ventas diarias
`dailySalesRevenueWithStock`	`number`	opcional	Promedio de ventas diarias en stock
`monthlySalesUnits`	`integer`	opcional	Volumen de ventas durante el período estadístico
`monthlySalesRevenue`	`number`	opcional	Ventas durante el período estadístico
`previousSalesUnits`	`integer`	opcional	Volumen de ventas en el período anterior (el período anterior con la misma longitud que este período estadístico)
`previousRevenue`	`number`	opcional	Ventas del último período
`revenuePotential`	`number`	opcional	Ventas potenciales (estimadas sobre la base del inventario durante todo el período)
`lostProfit`	`number`	opcional	Las ventas perdidas (causadas por acciones, etc.)
`lostProfitPercent`	`number`	opcional	Proporción de ventas perdidas (%)

Ilustración del formato

Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.

Pregunta ilustrativa

Recuperar detalles completos para hasta 100 Ozon SKUs. Uso del producto ID 1786874757.

Explicación ilustrativa de la respuesta

El resultado ilustrativo muestra el título: Ejemplo producto; producto id: 10; precio: 19.99. 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