Inteligencia de búsqueda de Amazon SF
API de resumen de tráfico por ASIN de Amazon MCP
Compare las fuentes de tráfico y los cambios de palabras clave para un ASIN. Consulta esta API mediante REST o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de resumen de tráfico por ASIN 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. Compare ASIN tráfico
Prompt: Compare los resúmenes de tráfico disponibles para hasta 10 productos Amazon [ASINS] dentro [MARKETPLACE].
2. Compruebe los últimos siete días
Prompt: Compare los resúmenes de tráfico disponibles para hasta 10 productos Amazon [ASINS] dentro [MARKETPLACE]. Utilice la última ventana de informes de siete días.
3. Compruebe un período de presentación personalizado
Prompt: Compare los resúmenes de tráfico disponibles para hasta 10 productos Amazon [ASINS] dentro [MARKETPLACE]. Utiliza el período de [START_DATE] a [END_DATE] en lugar de los últimos siete días. Mantenga la cobertura devuelta y las fechas explícitas.
4. Revisar varias páginas de resultados
Prompt: Compare los resúmenes de tráfico disponibles para hasta 10 productos Amazon [ASINS] dentro [MARKETPLACE]. Recoger hasta 3 páginas para esta tarea de investigación. Solicitar 10 resultados por página. Pare antes si no hay otra página, un resultado vacío o un error. Deduplicar identificadores de coincidencia y no describir la muestra como el mercado completo.
5. Priorizar los resultados por visibilidad de la búsqueda
Prompt: Compare los resúmenes de tráfico disponibles para hasta 10 productos Amazon [ASINS] dentro [MARKETPLACE]. Establece [RANKING_PRIORITY] como criterio principal y elige todas las palabras clave del tráfico, palabras clave del tráfico natural, palabras clave del anuncio de marca, video palabras clave del anuncio, AC Palabras clave recomendadas, ER Palabras clave recomendadas, TR Palabras clave recomendadas, puntuación total de exposición de palabras clave, puntuación total de exposición de rango natural, puntuación de exposición de productos patrocinados, puntuación de exposición total de anuncios de marca, puntuación total de exposición de vídeo, total AC puntuación de la exposición de la recomendación, total TR puntuación de la exposición de la recomendación o total ER puntaje de exposición de recomendación. Utiliza el orden [ASCENDING_OR_DESCENDING].
6. Encontrar palabras clave por fuente de tráfico
Prompt: Compare los resúmenes de tráfico disponibles para hasta 10 productos Amazon [ASINS] dentro [MARKETPLACE]. Filtro para [KEYWORD_SEGMENT], elegir búsqueda orgánica, Productos patrocinados anuncios, Marcas patrocinados anuncios, anuncios de vídeo, todo tráfico publicitario o recomendaciones de Productos patrocinados. Use un segmento para esta solicitud.
7. Encontrar nuevas palabras clave de búsqueda y recomendación
Prompt: Compare los resúmenes de tráfico disponibles para hasta 10 productos Amazon [ASINS] dentro [MARKETPLACE]. Mostrar palabras clave del tráfico.
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/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_amazon_asin_traffic_summaryhttps://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": "amazon-asin-traffic-summary-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_asin_traffic_summary",
"arguments": {
"country": "US",
"desc": true,
"last7d": true,
"pageNum": 1,
"pageSize": 10,
"searchValue": "B072MQ5BRX"
}
}
}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 |
|---|---|---|---|
searchValue | string | obligatorio | Valor de búsqueda, ASIN códigos, separado por coma, max 10 ASINs, longitud máxima 1000 caracteres Ejemplo: B072MQ5BRX |
country | string | opcional | Sitio del país, predeterminado US. Opciones (13 totales): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA |
last7d | boolean | opcional | Ya sea para obtener datos de los últimos 7 días, por defecto es cierto. Cuando es falso, usa startDate/endDate rango Ejemplo: false |
startDate | string | opcional | Fecha de inicio yyyy-MM-dd (eficaz cuando la última7d=falsa; si se omite, se utiliza la última semana del sistema) Ejemplo: 2026-01-01 |
endDate | string | opcional | Fecha final yyyy-MM-dd startDate) Ejemplo: 2026-01-01 |
conditions | string | opcional | Filtros de condición, separados por coma. Opciones: nf (trafico natural), sp (SP ads), sb (SB regular), sbv (video ads), ad (acceso mayor), acAd (SP Recomendación) totalPeriod.in (nuevas palabras clave de tráfico entrante) |
sortBy | string | opcional | Un campo. Opciones: totalKeywordNum (todas las palabras clave de tráfico), naturalKeywordNum (palabras clave del tráfico natural), brandKeywordNum (brand ad keywords), vedioKeywordNum (video ad keywords), acKeywordNum (AC Palabras clave recomendadas), erKeywordNum (ER Palabras clave recomendadas), trKeywordNum (TR Palabras clave recomendadas), sumScore (punto total de exposición de palabras clave), totalNfScore (punto total de exposición de rango natural), totalSpSocre (total) SP puntuación de exposición de anuncios, ortografía de notas), totalBrandScore (número total de exposición de anuncios) totalVedioScore (número total de exposición de vídeos) totalAcScore (total) AC puntuación de la exposición de la recomendación), totalTrScore (total) TR puntuación de la exposición de la recomendación), totalErScore (total) ER puntuación de la exposición de la recomendación) |
pageNum | integer | opcional | Número de página, por defecto 1 Ejemplo: 1 |
pageSize | integer | opcional | Resultados por página, min 10, max 10000, default 10000 Ejemplo: 10 |
desc | boolean | opcional | Ya sea para ordenar descender, por defecto verdadero 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 devolución |
msg | string | opcional | noticias |
total | integer | opcional | La cantidad real de datos devueltos esta vez |
data | array | opcional | ASIN array de objeto sumario (Convención de sufijo de Field: `*Prev` es el valor del período anterior; `*In` / `*Out` es el número de nuevo entries/exits en este ciclo relativo al período anterior) |
columns | array | opcional | columna |
type | string | opcional | estilo de renderización |
title | string | opcional | Título |
isParentAsin | boolean | opcional | Si el objeto de búsqueda es un padre ASIN |
variantsNum | integer | opcional | Número de variaciones con palabras clave |
noKeywordVariantsNum | integer | opcional | Número de variaciones sin palabras clave |
costTime | integer | opcional | Tiempo de consumo (ms) |
costToken | integer | opcional | Consume token |
asin | string | opcional | ASIN código |
productTitle | string | opcional | Título del producto |
productCategory | string | opcional | Categoría de productos |
productPrice | number | opcional | Precio de venta de productos |
productImageUrl | string | opcional | Imagen principal URL |
productFeatures | array | opcional | Lista de características del producto |
customerRatingCount | integer | opcional | Total de valoraciones de clientes |
productStarRating | number | opcional | Evaluación de estrellas de producto (0–5) |
productRatingScore | number | opcional | Valor de la calificación del producto (0–5) |
isVariantProduct | boolean | opcional | ¿Es una variante? |
recentMonthlySalesBucket | string | opcional | Cubo de ventas en el mes pasado; este campo sólo tiene un valor en el `keywordSummary` camino, en forma de `"300+"` o `"1,000+"` |
isMonitored | boolean | opcional | ¿Lo han monitoreado? |
monitoringStartTime | string | opcional | tiempo de atención |
dataPeriodStartDate | string | opcional | Fecha de inicio del período de datos |
totalExposureScore | number | opcional | Total puntuación de exposición |
totalExposureScorePrev | number | opcional | Puntaje total de exposición último ciclo |
totalTrafficKeywordCount | integer | opcional | Número total de palabras clave de tráfico |
totalTrafficKeywordCountIn | integer | opcional | Número de nuevas palabras clave de tráfico este ciclo |
totalTrafficKeywordCountOut | integer | opcional | Número de palabras clave de tráfico de salida este ciclo |
totalTrafficKeywordCountPrev | integer | opcional | Número total de palabras clave de tráfico en el último ciclo |
naturalSearchExposureScore | number | opcional | Número total de exposición a la búsqueda orgánica |
naturalSearchExposureRatio | number | opcional | Tasa de exposición a la búsqueda natural |
naturalSearchExposureScorePrev | number | opcional | Puntaje de exposición de búsqueda natural último ciclo |
naturalSearchKeywordCount | integer | opcional | Número de palabras clave de búsqueda naturales |
naturalSearchKeywordCountIn | integer | opcional | Número de nuevas palabras clave naturales este ciclo |
naturalSearchKeywordCountOut | integer | opcional | Número de palabras clave naturales que salen de este ciclo |
naturalSearchKeywordCountPrev | integer | opcional | Número de palabras clave naturales en el ciclo anterior |
sponsoredProductsExposureScore | number | opcional | SP impresión total puntuación |
sponsoredProductsExposureRatio | number | opcional | SP ratio de exposición publicitaria |
sponsoredProductsExposureScorePrev | number | opcional | Último ciclo SP puntuación de exposición |
sponsoredProductsKeywordCount | integer | opcional | SP número de palabras clave de publicidad |
brandAdExposureScore | number | opcional | Marca total publicidad puntuación de exposición |
brandAdExposureRatio | number | opcional | Proporción de exposición publicitaria de marca |
brandAdExposureScorePrev | number | opcional | Marca publicidad puntuación de exposición último ciclo |
brandAdKeywordCount | integer | opcional | Número de palabras clave de publicidad de marca |
topBrandAdKeywordCount | integer | opcional | Número de palabras clave de anuncio de la marca superior |
bottomBrandAdKeywordCount | integer | opcional | Número de palabras clave para anuncios de marca en la parte inferior |
videoAdExposureScore | number | opcional | Número total de exposición de vídeo |
videoAdExposureRatio | number | opcional | Tasa de exposición al anuncio de vídeo |
videoAdExposureScorePrev | number | opcional | Nota de exposición de vídeo último ciclo |
videoAdKeywordCount | integer | opcional | Número de palabras clave de anuncio de vídeo |
amazonsChoiceExposureScore | number | opcional | Amazon Choice Impression Total Score |
amazonsChoiceExposureRatio | number | opcional | Amazon Choice impresion share |
amazonsChoiceExposureScorePrev | number | opcional | Último ciclo AC puntuación de exposición |
amazonsChoiceKeywordCount | integer | opcional | AC keyword count |
amazonsChoiceKeywordCountIn | integer | opcional | Número de nuevos AC palabras clave en este ciclo |
amazonsChoiceKeywordCountOut | integer | opcional | Número de AC palabras clave saliendo de este ciclo |
editorialRecommendationsExposureScore | number | opcional | ER puntuación total de exposición |
editorialRecommendationsExposureRatio | number | opcional | ER ratio de exposición |
editorialRecommendationsKeywordCount | integer | opcional | ER keyword count |
topRatedExposureScore | number | opcional | TR Puntaje total de exposición recomendado |
topRatedExposureRatio | number | opcional | TR ratio de exposición recomendada |
topRatedKeywordCount | integer | opcional | TR keyword count |
frequentlyBoughtKeywordCount | integer | opcional | Número de palabras clave recomendadas para compras de alta frecuencia |
recommendPositionExposureScore | number | opcional | Puntaje total de exposición de posición recomendada |
recommendAdExposureScore | number | opcional | Puntuación de exposición publicitaria recomendada |
recommendNonadExposureScore | number | opcional | Puntaje de exposición no publicitario recomendado |
nonAcRecommendExposureScore | number | opcional | Non-AC puntuación recomendada de exposición de posición |
recommendKeywordCount | integer | opcional | Número total de palabras clave recomendadas |
recommendAdKeywordCount | integer | opcional | Número de palabras clave de publicidad recomendadas |
recommendNonadKeywordCount | integer | opcional | Número de palabras clave recomendadas no publicitarias |
ppcTrafficSources | array | opcional | PPC Traffic Source Tags |
naturalSearchTrafficSources | array | opcional | Mapa orgánico fuente de tráfico |
amazonRecommendationSources | array | opcional | Amazon Fuente recomendada |
promotionalDealSources | array | opcional | Fuente de promoción |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Resume los últimos siete días de tráfico para ASIN B072MQ5BRX en Amazon US.
Explicación ilustrativa de la respuesta
El resultado ilustrativo reporta 80 palabras clave de tráfico, incluyendo 50 palabras clave de búsqueda natural. Su puntuación total de exposición es de 1.000, en comparación con 800 en el período anterior. Las puntuaciones de exposición no cuentan con visitantes.
Sobre esta muestra: Ejemplo meramente ilustrativo: los nombres, identificadores y cifras son ficticios y no se hizo una llamada real. Tus resultados dependen de tu cuenta, las entradas y los datos disponibles.
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": "amazon-asin-traffic-summary-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_asin_traffic_summary",
"arguments": {
"country": "US",
"desc": true,
"last7d": true,
"pageNum": 1,
"pageSize": 10,
"searchValue": "B072MQ5BRX"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "amazon-asin-traffic-summary-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"total\":1,\"data\":[{\"asin\":\"B072MQ5BRX\",\"totalTrafficKeywordCount\":80,\"naturalSearchKeywordCount\":50,\"totalExposureScore\":1000,\"totalExposureScorePrev\":800}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"total": 1,
"data": [
{
"asin": "B072MQ5BRX",
"totalTrafficKeywordCount": 80,
"naturalSearchKeywordCount": 50,
"totalExposureScore": 1000,
"totalExposureScorePrev": 800
}
]
}
},
"isError": false
}
}