Inteligencia de búsqueda de Amazon SF
API de resumen de palabras clave de Amazon MCP
Compare el tráfico de competidores de búsqueda, anuncios y recomendaciones. Llame al resumen de la palabra clave de Amazon API mediante REST o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de resumen 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. Compruebe fuentes de tráfico de palabras clave
Prompt: Mostrar el tráfico de productos Amazon disponibles asociado con [KEYWORD] dentro [MARKETPLACE].
2. Compruebe los últimos siete días
Prompt: Mostrar el tráfico de productos Amazon disponibles asociado con [KEYWORD] dentro [MARKETPLACE]. Utilice la última ventana de informes de siete días.
3. Compruebe un período de presentación personalizado
Prompt: Mostrar el tráfico de productos Amazon disponibles asociado con [KEYWORD] 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. Centrarse en productos competidores seleccionados
Prompt: Mostrar el tráfico de productos Amazon disponibles asociado con [KEYWORD] dentro [MARKETPLACE]. Mantener sólo productos [ASINS] en los resultados de la palabra clave.
5. Revisar varias páginas de resultados
Prompt: Mostrar el tráfico de productos Amazon disponibles asociado con [KEYWORD] 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.
6. Priorizar los resultados por visibilidad de la búsqueda
Prompt: Mostrar el tráfico de productos Amazon disponibles asociado con [KEYWORD] 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, puntaje total de exposición de palabras clave, puntuación de exposición de rango orgánico, puntuación de exposición de productos patrocinados, puntuación de exposición de marca, puntuación de exposición de vídeo, AC puntuación de la exposición a la recomendación, TR puntuación de la exposición de la recomendación o ER puntaje de exposición de recomendación. Utiliza el orden [ASCENDING_OR_DESCENDING].
7. Encontrar palabras clave por fuente de tráfico
Prompt: Mostrar el tráfico de productos Amazon disponibles asociado con [KEYWORD] dentro [MARKETPLACE]. Filtro para [KEYWORD_SEGMENT], eligiendo la búsqueda orgánica, Productos patrocinados anuncios, anuncios de vídeo, Marcas patrocinados anuncios, PPC Palabras clave publicitarias, palabras clave de recomendación de búsqueda o recomendaciones de productos patrocinados. Use un segmento para esta solicitud.
8. Encontrar nuevas palabras clave de búsqueda y recomendación
Prompt: Mostrar el tráfico de productos Amazon disponibles asociado con [KEYWORD] dentro [MARKETPLACE]. Muestra newly appearing [KEYWORD_SEGMENT], eligiendo palabras clave de tráfico, palabras clave orgánicas, palabras clave de publicidad, todas las palabras clave de productos patrocinados, Productos patrocinados búsqueda palabras claves o recomendaciones de productos patrocinados. Use un segmento para esta solicitud.
9. Revisión de búsqueda y recomendaciones palabras clave
Prompt: Mostrar el tráfico de productos Amazon disponibles asociado con [KEYWORD] dentro [MARKETPLACE]. Use el segmento de duración completa para [KEYWORD_SEGMENT], eligiendo palabras clave orgánicas, palabras clave de publicidad, todas las palabras clave de los productos patrocinados, las palabras clave de búsqueda de los productos patrocinados o las palabras clave de recomendación de los productos patrocinados. Use un segmento para esta solicitud.
10. Reseña palabras clave de marca-ad
Prompt: Mostrar el tráfico de productos Amazon disponibles asociado con [KEYWORD] dentro [MARKETPLACE]. Use el segmento de duración completa para [KEYWORD_SEGMENT], eligiendo todas las Palabras Clave de Marcas Patrocinadas, Palabras Claves Patrocinadas o Palabras clave de vídeo de Marcas Patrocinadas. Use un segmento para esta solicitud.
11. Encontrar nuevas palabras clave de marca-ad
Prompt: Mostrar el tráfico de productos Amazon disponibles asociado con [KEYWORD] dentro [MARKETPLACE]. Muestra newly appearing [KEYWORD_SEGMENT], eligiendo todas las Palabras Clave de Marcas Patrocinadas, Palabras Claves Patrocinadas o Palabras clave de vídeo de Marcas Patrocinadas. Use un segmento para esta solicitud.
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_keyword_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-keyword-summary-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_keyword_summary",
"arguments": {
"country": "US",
"last7d": true,
"pageNum": 1,
"pageSize": 10,
"searchKeyword": "phone case"
}
}
}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 |
|---|---|---|---|
searchKeyword | string | obligatorio | Palabras clave de búsqueda, traducir al idioma del país correspondiente siempre que sea posible. Max Longitud 1000 caracteres Ejemplo: phone case |
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 |
asins | string | opcional | ASIN lista de filtros, separada por coma; si no se proporciona, devuelve todo ASINs para esta palabra clave. Longitud máxima 1000 caracteres Ejemplo: B072MQ5BRX |
condition | string | opcional | Filtro de condición, sólo uno a la vez. Tipo de bandera: nfPosition (palabra clave del tráfico natural), isSpAd (SP ad keyword), isVedioAd (video ad keyword), isBrandAd (brand ad keyword), isPPCAd (PPC ad keyword), isSearchRecommend (word clave de recomendación de investigación), acAd (SP recomendación) se efectuará con el tipo de cuenta Period: totalPeriod.in (nuevas palabras clave de tráfico entrante), nfKeywordCnt.total / .in, adKeywordCnt.total / .in, allSpKeywordCnt.total / .in, spKeywordCnt.total / .in, recSpKeywordCnt.total / .in, allSbKeywordCnt.total / .in, sbKeywordCnt.total / .in, sbvKeywordCnt.total |
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: true |
startDate | string | opcional | Fecha de inicio yyyy-MM-dd (eficaz cuando la última7d=falsa; si se omite, el último sistema de la semana completa se utiliza) Ejemplo: 2026-01-01 |
endDate | string | opcional | Fecha final yyyy-MM-dd startDate) Ejemplo: 2026-01-01 |
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, totalSpSocre (nota ortografía), totalBrandScore, totalVedioScore, totalAcScore, totalTrScore, totalErScore |
pageNum | integer | opcional | Número de página, por defecto 1 Ejemplo: 1 |
pageSize | integer | opcional | Resultados por página, min 10, max 100, default 100 Ejemplo: 10 |
desc | boolean | opcional | Ya sea para ordenar descender, por defecto verdadero Ejemplo: true |
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 del negocio sf, `"1"` indica que el éxito |
msg | string | opcional | noticias |
total | integer | opcional | La cantidad real de datos devueltos esta vez |
data | array | opcional | ASIN matriz de datos de tráfico de palabras clave |
columns | array | opcional | columna |
type | string | opcional | estilo de renderización |
title | string | opcional | Título |
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 |
productImageUrl | string | opcional | Imagen principal URL |
productPrice | number | opcional | Precio de venta de productos |
customerRatingCount | integer | opcional | Total de valoraciones de clientes |
productStarRating | number | opcional | Evaluación de estrellas de producto |
productRatingScore | number | opcional | Valor de calificación del producto |
productUpdateTime | string | opcional | Tiempo de actualización del producto |
dataPeriodStartDate | string | opcional | Fecha de inicio del período de datos |
totalExposureScore | number | opcional | Total puntuación de exposición |
totalExposureRatio | number | opcional | Total de la cuota de tráfico |
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 |
sponsoredProductsExposureScore | number | opcional | SP impresión total puntuación |
sponsoredProductsExposureRatio | number | opcional | SP ratio de exposición publicitaria |
brandAdExposureScore | number | opcional | Marca total publicidad puntuación de exposición |
brandAdExposureRatio | number | opcional | Proporción de exposición publicitaria de marca |
videoAdExposureScore | number | opcional | Número total de exposición de vídeo |
videoAdExposureRatio | number | opcional | Tasa de exposición al anuncio de vídeo |
amazonsChoiceExposureScore | number | opcional | AC puntuación total |
amazonsChoiceExposureRatio | number | opcional | AC ratio de exposición |
editorialRecommendationsExposureScore | number | opcional | ER puntuación total de exposición |
editorialRecommendationsExposureRatio | number | opcional | ER ratio de exposición |
topRatedExposureScore | number | opcional | TR puntuación total |
topRatedExposureRatio | number | opcional | TR ratio de exposición |
recommendPositionExposureScore | number | opcional | Puntaje total de exposición de posición recomendada |
recommendAdExposureScore | number | opcional | Puntuación de exposición publicitaria recomendada |
recommendAdExposureRatio | number | opcional | Compartir tráfico publicitario recomendado |
recommendNonadExposureScore | number | opcional | Puntaje de exposición no publicitario recomendado |
recommendNonadExposureRatio | number | opcional | Participación recomendada en el tráfico no preventivo |
comprehensiveNaturalExposureScore | number | opcional | Puntaje completo de tráfico orgánico |
comprehensiveNaturalExposureRatio | number | opcional | Compartir tráfico orgánico combinado |
keywordTotalExposureScore | number | opcional | La puntuación total de esta palabra clave |
keywordNaturalExposureScore | number | opcional | Puntuación natural para esta palabra clave |
keywordSponsoredProductsExposureScore | number | opcional | SP puntuación de esta palabra clave |
keywordBrandAdExposureScore | number | opcional | Marca puntuación de publicidad para esta palabra clave |
keywordVideoAdExposureScore | number | opcional | Nota de anuncio de vídeo para esta palabra clave |
keywordAmazonsChoiceExposureScore | number | opcional | AC puntuación de esta palabra clave |
keywordRecommendExposureScore | number | opcional | Puntaje de posición recomendado para esta palabra clave |
keywordRecommendAdExposureScore | number | opcional | Marca de publicidad para posiciones recomendadas para esta palabra clave |
keywordRecommendNonadExposureScore | number | opcional | Esta posición de recomendación de la palabra clave no es una puntuación publicitaria |
keywordComprehensiveNaturalExposureScore | number | opcional | Puntaje natural completo para esta palabra clave |
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
Qué productos reciben exposición para “casa de teléfono” en Amazon US en los últimos siete días?
Explicación ilustrativa de la respuesta
El resultado ilustrativo contiene un producto, ASIN B000000001, con una puntuación de exposición total de 200 y una puntuación de exposición de investigación natural de 150. Estas son métricas de exposición, no clics o compras.
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-keyword-summary-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_keyword_summary",
"arguments": {
"country": "US",
"last7d": true,
"pageNum": 1,
"pageSize": 10,
"searchKeyword": "phone case"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "amazon-keyword-summary-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"total\":1,\"data\":[{\"asin\":\"B000000001\",\"productTitle\":\"Example phone case\",\"totalExposureScore\":200,\"naturalSearchExposureScore\":150}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"total": 1,
"data": [
{
"asin": "B000000001",
"productTitle": "Example phone case",
"totalExposureScore": 200,
"naturalSearchExposureScore": 150
}
]
}
},
"isError": false
}
}