Investigación de Amazon JS

API de cuota de presencia de palabras clave de Amazon MCP

Compare cuántas marcas aparecen en los resultados de búsqueda orgánicos y patrocinados de Amazon. Llamada vía REST API o MCP con tu clave de API de Nexscope.

CosteRecent Avg. 132 · Range 67–133 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de cuota de presencia de palabras clave de Amazon

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. Comparar la visibilidad de la búsqueda de marca

Prompt: Compara la visibilidad de la marca devuelta para [KEYWORD] en Amazon orgánico y resultados de búsqueda patrocinados en [MARKETPLACE].

2. Buscar marcas Relying on Sponsored Visibility

Prompt: Compara la visibilidad de la marca devuelta para [KEYWORD] en Amazon orgánico y resultados de búsqueda patrocinados en [MARKETPLACE]. Comparar conteos de productos orgánicos y patrocinados, acciones de visibilidad ponderadas y posiciones promedio para cada marca devuelta. Aclara que la muestra abarca las tres primeras páginas; no interpretes la visibilidad como cuota de mercado ni rentabilidad publicitaria.

3. Comparar los productos Top Clicked

Prompt: Compara la visibilidad de la marca devuelta para [KEYWORD] en Amazon orgánico y resultados de búsqueda patrocinados en [MARKETPLACE]. Compare clics, conversiones y la tasa de conversión devuelta para la parte superior ASINs. Mantenga el modelo de salida y fechas finales visibles y no extienda la muestra superior a tres a todos los productos competidores.

4. Comentario Precio de marca Posición

Prompt: Compara la visibilidad de la marca devuelta para [KEYWORD] en Amazon orgánico y resultados de búsqueda patrocinados en [MARKETPLACE]. Compare los precios promedios de cada marca orgánicos y patrocinados junto con sus acciones de visibilidad. Mantener la base de precios fuente y la moneda explícita; no inferir moneda o beneficio perdido.

Qué debes proporcionar

Sustituye los marcadores entre corchetes por tus propios datos de investigación. Indica expresamente las estimaciones de la fuente, los períodos de los informes y la información que falte.

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_amazon_keyword_share_of_voice

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": "amazon-keyword-share-of-voice-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_keyword_share_of_voice",
    "arguments": {
      "keyword": "phone case",
      "marketplace": "us"
    }
  }
}

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
`marketplace`	`string`	obligatorio	Código de mercado de destino. Opciones: nosotros, uk, de, in, ca, fr, it, es, mx, jp Ejemplo: us
`keyword`	`string`	obligatorio	Palabras clave para la consulta Ejemplo: phone case

Campos de respuesta

Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.

Nombre	Tipo	Obligatorio	Descripción
`costToken`	`integer`	opcional	Número de fichas consumidas
`shareOfVoice`	`object`	opcional	Share of Voice data subject
`id`	`string`	opcional	Recursos ID
`type`	`string`	opcional	Valor fijo `share_of_voice`
`estimated30DaySearchVolume`	`integer`	opcional	Exacto volumen de búsqueda del partido en los últimos 30 días
`exactSuggestedBidMedian`	`number`	opcional	Mediano PPC licitaciónUSD)
`productCount`	`integer`	opcional	Número total de artículos en las primeras 3 páginas de resultados de búsqueda
`updatedAt`	`string`	opcional	Tiempo de actualización de datos
`topAsinsModelStartDate`	`string`	opcional	TOP ASIN click/conversion ventana de datos fecha de inicio
`topAsinsModelEndDate`	`string`	opcional	TOP ASIN click/conversion data ventana final date
`brands`	`array`	opcional	Marca SOV Lista detallada
`topAsins`	`array`	opcional	TOP 3 ASIN lista de conversión
`brand`	`string`	opcional	nombre de marca
`organicProducts`	`integer`	opcional	Número de artículos en resultados de búsqueda orgánica
`sponsoredProducts`	`integer`	opcional	El número de productos en la ranura de anuncio
`combinedProducts`	`integer`	opcional	Cantidad de productos integrales
`organicBasicSov`	`number`	opcional	Básicos de búsqueda natural SOV (0–1)
`organicWeightedSov`	`number`	opcional	Búsqueda natural ponderada SOV (0–1)
`sponsoredBasicSov`	`number`	opcional	Básicos de búsqueda de anuncios SOV (0–1)
`sponsoredWeightedSov`	`number`	opcional	Búsqueda de anuncios Peso SOV (0–1)
`combinedBasicSov`	`number`	opcional	Básica general SOV (0–1)
`combinedWeightedSov`	`number`	opcional	Peso completo SOV (0–1)
`organicAveragePosition`	`number`	opcional	Posición media de la búsqueda orgánica
`sponsoredAveragePosition`	`number`	opcional	Posición media de búsqueda
`combinedAveragePosition`	`number`	opcional	Posición media general de clasificación
`organicAveragePrice`	`number`	opcional	Precio medio de los artículos de búsqueda natural
`sponsoredAveragePrice`	`number`	opcional	Precio medio de los productos de búsqueda anunciados
`combinedAveragePrice`	`number`	opcional	Precio medio del producto completo
`asin`	`string`	opcional	ASIN Número
`name`	`string`	opcional	Nombre del producto
`brand`	`string`	opcional	nombre de marca
`clicks`	`integer`	opcional	Clicks (30-day ventana)
`conversions`	`integer`	opcional	Conversiones (30 días de ventana)
`conversionRate`	`number`	opcional	Tasa de conversión (0-1)

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

¿Qué tan visible es Garmin en los resultados devueltos de Amazon India para “garmin”?

Respuesta de ejemplo

La marca Garmin reporta 33 productos orgánicos, 10 productos patrocinados y 43 productos combinados. Su parte básica combinada de voz es 0.6935 como devuelto.

Sobre esta muestra: La participación de la voz describe la visibilidad de los resultados de la búsqueda, no los ingresos o la cuota de mercado. Esta es una muestra histórica, no un cheque de clasificación en vivo.

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

{
  "marketplace": "in",
  "keyword": "garmin"
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "costToken": 85000,
    "shareOfVoice": {
      "topAsinsModelStartDate": "2026-10-04",
      "brands": [
        {
          "organicProducts": 33,
          "combinedBasicSov": 0.6935,
          "combinedProducts": 43,
          "sponsoredAveragePosition": 8.5,
          "sponsoredAveragePrice": 25590,
          "combinedAveragePosition": 17.77,
          "organicBasicSov": 0.6875,
          "organicWeightedSov": 0.9734,
          "organicAveragePosition": 20.58,
          "combinedAveragePrice": 33426.51,
          "organicAveragePrice": 35875.43,
          "sponsoredProducts": 10,
          "combinedWeightedSov": 0.9734,
          "brand": "Garmin",
          "sponsoredBasicSov": 0.7143,
          "sponsoredWeightedSov": 0.5418
        },
        {
          "organicProducts": 1,
          "combinedBasicSov": 0.0161,
          "combinedProducts": 1,
          "combinedAveragePosition": 11,
          "organicBasicSov": 0.0208,
          "organicWeightedSov": 0.0137,
          "organicAveragePosition": 11,
          "combinedAveragePrice": 9995,
          "organicAveragePrice": 9995,
          "sponsoredProducts": 0,
          "combinedWeightedSov": 0.0137,
          "brand": "OnePlus",
          "sponsoredBasicSov": 0,
          "sponsoredWeightedSov": 0
        },
        {
          "organicProducts": 5,
          "combinedBasicSov": 0.0968,
          "combinedProducts": 6,
          "sponsoredAveragePosition": 9,
          "sponsoredAveragePrice": 39999,
          "combinedAveragePosition": 25,
          "organicBasicSov": 0.1042,
          "organicWeightedSov": 0.0081,
          "organicAveragePosition": 28.2,
          "combinedAveragePrice": 21415.67,
          "organicAveragePrice": 17699,
          "sponsoredProducts": 1,
          "combinedWeightedSov": 0.0081,
          "brand": "Amazfit",
          "sponsoredBasicSov": 0.0714,
          "sponsoredWeightedSov": 0.0061
        },
        {
          "organicProducts": 1,
          "combinedBasicSov": 0.0323,
          "combinedProducts": 2,
          "sponsoredAveragePosition": 4,
          "sponsoredAveragePrice": 5999,
          "combinedAveragePosition": 9.5,
          "organicBasicSov": 0.0208,
          "organicWeightedSov": 0.0043,
          "organicAveragePosition": 15,
          "combinedAveragePrice": 4499,
          "organicAveragePrice": 2999,
          "sponsoredProducts": 1,
          "combinedWeightedSov": 0.0044,
          "brand": "Pebble",
          "sponsoredBasicSov": 0.0714,
          "sponsoredWeightedSov": 0.0817
        },
        {
          "organicProducts": 1,
          "combinedBasicSov": 0.0161,
          "combinedProducts": 1,
          "combinedAveragePosition": 23,
          "organicBasicSov": 0.0208,
          "organicWeightedSov": 0.0004,
          "organicAveragePosition": 23,
          "combinedAveragePrice": 311,
          "organicAveragePrice": 311,
          "sponsoredProducts": 0,
          "combinedWeightedSov": 0.0004,
          "brand": "Meliya",
          "sponsoredBasicSov": 0,
          "sponsoredWeightedSov": 0
        },
        {
          "organicProducts": 0,
          "combinedBasicSov": 0.0161,
          "combinedProducts": 1,
          "sponsoredAveragePosition": 1,
          "sponsoredAveragePrice": 21990,
          "combinedAveragePosition": 1,
          "organicBasicSov": 0,
          "organicWeightedSov": 0,
          "combinedAveragePrice": 21990,
          "sponsoredProducts": 1,
          "combinedWeightedSov": 0,
          "brand": "WHOOP",
          "sponsoredBasicSov": 0.0714,
          "sponsoredWeightedSov": 0.3445
        },
        {
          "organicProducts": 1,
          "combinedBasicSov": 0.0161,
          "combinedProducts": 1,
          "combinedAveragePosition": 34,
          "organicBasicSov": 0.0208,
          "organicWeightedSov": 0,
          "organicAveragePosition": 34,
          "combinedAveragePrice": 1099,
          "organicAveragePrice": 1099,
          "sponsoredProducts": 0,
          "combinedWeightedSov": 0,
          "brand": "Noise",
          "sponsoredBasicSov": 0,
          "sponsoredWeightedSov": 0
        },
        {
          "organicProducts": 0,
          "combinedBasicSov": 0.0161,
          "combinedProducts": 1,
          "sponsoredAveragePosition": 6,
          "sponsoredAveragePrice": 33995,
          "combinedAveragePosition": 6,
          "organicBasicSov": 0,
          "organicWeightedSov": 0,
          "combinedAveragePrice": 33995,
          "sponsoredProducts": 1,
          "combinedWeightedSov": 0,
          "brand": "Samsung",
          "sponsoredBasicSov": 0.0714,
          "sponsoredWeightedSov": 0.0259
        },
        {
          "organicProducts": 2,
          "combinedBasicSov": 0.0323,
          "combinedProducts": 2,
          "combinedAveragePosition": 43.5,
          "organicBasicSov": 0.0417,
          "organicWeightedSov": 0,
          "organicAveragePosition": 43.5,
          "combinedAveragePrice": 8247,
          "organicAveragePrice": 8247,
          "sponsoredProducts": 0,
          "combinedWeightedSov": 0,
          "brand": "Titan",
          "sponsoredBasicSov": 0,
          "sponsoredWeightedSov": 0
        },
        {
          "organicProducts": 1,
          "combinedBasicSov": 0.0161,
          "combinedProducts": 1,
          "combinedAveragePosition": 45,
          "organicBasicSov": 0.0208,
          "organicWeightedSov": 0,
          "organicAveragePosition": 45,
          "combinedAveragePrice": 2599,
          "organicAveragePrice": 2599,
          "sponsoredProducts": 0,
          "combinedWeightedSov": 0,
          "brand": "Fastrack",
          "sponsoredBasicSov": 0,
          "sponsoredWeightedSov": 0
        },
        {
          "organicProducts": 1,
          "combinedBasicSov": 0.0161,
          "combinedProducts": 1,
          "combinedAveragePosition": 46,
          "organicBasicSov": 0.0208,
          "organicWeightedSov": 0,
          "organicAveragePosition": 46,
          "combinedAveragePrice": 299,
          "organicAveragePrice": 299,
          "sponsoredProducts": 0,
          "combinedWeightedSov": 0,
          "brand": "Sounce",
          "sponsoredBasicSov": 0,
          "sponsoredWeightedSov": 0
        },
        {
          "organicProducts": 1,
          "combinedBasicSov": 0.0161,
          "combinedProducts": 1,
          "combinedAveragePosition": 47,
          "organicBasicSov": 0.0208,
          "organicWeightedSov": 0,
          "organicAveragePosition": 47,
          "combinedAveragePrice": 259,
          "organicAveragePrice": 259,
          "sponsoredProducts": 0,
          "combinedWeightedSov": 0,
          "brand": "Colorcase",
          "sponsoredBasicSov": 0,
          "sponsoredWeightedSov": 0
        },
        {
          "organicProducts": 1,
          "combinedBasicSov": 0.0161,
          "combinedProducts": 1,
          "combinedAveragePosition": 48,
          "organicBasicSov": 0.0208,
          "organicWeightedSov": 0,
          "organicAveragePosition": 48,
          "combinedAveragePrice": 599,
          "organicAveragePrice": 599,
          "sponsoredProducts": 0,
          "combinedWeightedSov": 0,
          "brand": "Zitel",
          "sponsoredBasicSov": 0,
          "sponsoredWeightedSov": 0
        }
      ],
      "topAsins": [
        {
          "conversions": 12,
          "name": "Garmin Vivoactive® 5, Health & Fitness GPS Smartwatch, 42mm, Black",
          "clicks": 438,
          "asin": "B0CKVTGBG1",
          "brand": "Garmin",
          "conversionRate": 0.03
        },
        {
          "conversions": 5,
          "name": "Garmin Forerunner 965 GPS Triathlon Smartwatch,Amoled Touchscreen, Battery Upto 23 Days, HRV Status, Advanced Sleep Score, Track Running, Cross Training, Vo2 Max, ClimbPro, Load Ratio with Black Band",
          "clicks": 266,
          "asin": "B0BY5BRLRB",
          "brand": "Garmin",
          "conversionRate": 0.02
        },
        {
          "conversions": 2,
          "name": "Garmin Forerunner 165 43mm Black/Slate Grey, GPS Running Smartwatch",
          "clicks": 213,
          "asin": "B0CT3SGHXL",
          "brand": "Garmin",
          "conversionRate": 0.01
        }
      ],
      "topAsinsModelEndDate": "2026-10-10",
      "id": "in/garmin",
      "type": "share_of_voice",
      "estimated30DaySearchVolume": 40806,
      "exactSuggestedBidMedian": 0,
      "productCount": 62,
      "updatedAt": "2026-10-14T23:30:42Z"
    }
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos