Inteligencia de búsqueda de Amazon SF
API de resumen de palabras clave de Amazon MCP
Evaluar la demanda de búsqueda y la competencia para una palabra clave de Amazon. Consulta esta 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. Consultar la demanda de palabras clave
Prompt: Mostrar la demanda de búsqueda disponible y la competencia para [KEYWORD] en Amazon en [MARKETPLACE].
2. Compruebe los últimos siete días
Prompt: Mostrar la demanda de búsqueda disponible y la competencia para [KEYWORD] en Amazon en [MARKETPLACE]. Utilice la última ventana de informes de siete días.
3. Compruebe un período de presentación personalizado
Prompt: Mostrar la demanda de búsqueda disponible y la competencia para [KEYWORD] en Amazon en [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.
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_overviewhttps://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-overview-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_keyword_overview",
"arguments": {
"country": "US",
"keyword": "phone case",
"last7d": true
}
}
}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 |
|---|---|---|---|
keyword | string | obligatorio | Palabras clave, traducir al idioma del país correspondiente siempre que sea posible. Longitud máxima: 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 |
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) Ejemplo: 2026-01-01 |
endDate | string | opcional | Fecha final yyyy-MM-dd startDate) Ejemplo: 2026-01-01 |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
msg | string | opcional | noticias |
total | integer | opcional | Cantidad total de datos, generalmente 1 |
code | string | opcional | código de devolución del negocio sf, `"1"` indica que el éxito |
data | array | opcional | keyword array vista |
costTime | integer | opcional | Tiempo de consumo (ms) |
costToken | integer | opcional | Consume token |
columns | array | opcional | columna |
type | string | opcional | estilo de renderización |
title | string | opcional | Título |
keyword | string | opcional | palabras clave |
keywordPopularityRank | integer | opcional | Clasificación de popularidad de palabras clave. Cuanto menor sea el valor, mayor será el volumen de búsqueda. |
estimatedWeeklySearchVolume | integer | opcional | Volumen de búsqueda estimado por semana |
supplyDemandRatio | number | opcional | Relación de oferta y demanda (número de productos de resultados de búsqueda / volumen de búsqueda mensual), menor es el valor, menor es la competencia y mayor es la oportunidad. |
totalSearchResultProductCount | integer | opcional | Número total de artículos de resultados de la búsqueda |
naturalSearchProductCount | integer | opcional | Número de artículos de búsqueda natural |
sponsoredProductsCount | integer | opcional | SP Número de artículos anunciados |
brandAdProductCount | integer | opcional | Número de productos de publicidad de marca |
videoAdProductCount | integer | opcional | Número de productos de publicidad de vídeo |
paidAdvertisingProductCount | integer | opcional | Número total de PPC Productos publicitarios pagados |
amazonChoiceProductCount | integer | opcional | Cuenta de la selección de Amazon |
topRatedProductCount | integer | opcional | Número máximo de artículos |
searchRecommendationProductCount | integer | opcional | Buscar el número de productos recomendados |
editorialRecommendationsProductCount | integer | opcional | Número de artículos recomendados por los editores |
recNonadProductCount | integer | opcional | Número de productos no publicitarios recomendados |
recAdProductCount | integer | opcional | Número de productos de publicidad recomendados |
trackedAsinTotalCount | integer | opcional | El número total de personas expuestas ASIN deduplicación rastreada por sf; el campo aguas arriba es `totalAsinNum` |
totalMarketplaceKeywordCount | integer | opcional | Número total de palabras clave del sitio |
dataPeriodStartDate | string | opcional | Fecha de inicio del período de datos |
dataPeriodEndDate | string | opcional | Fecha final del período de datos |
keywordDataUpdateTime | string | opcional | Tiempo de actualización de datos de palabras clave |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Resume demand for “phone case” on Amazon US en los últimos siete días.
Explicación ilustrativa de la respuesta
Los resultados ilustrativos reportan un volumen de búsqueda semanal estimado de 2.000 y 500 productos de búsqueda. La demanda de búsqueda y los recuentos de productos describen diferentes medidas; tampoco es un total de ventas.
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-overview-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_keyword_overview",
"arguments": {
"country": "US",
"keyword": "phone case",
"last7d": true
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "amazon-keyword-overview-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":[{\"keyword\":\"phone case\",\"estimatedWeeklySearchVolume\":2000,\"totalSearchResultProductCount\":500}],\"total\":1}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": [
{
"keyword": "phone case",
"estimatedWeeklySearchVolume": 2000,
"totalSearchResultProductCount": 500
}
],
"total": 1
}
},
"isError": false
}
}