Amazon ABA e información empresarial

API de inteligencia de palabras clave de Amazon MCP

Explore los datos semanales de búsqueda de Amazon Brand Analytics. Llama a la Inteligencia de Palabras Clave de Amazon API mediante REST o MCP con tu clave de API de Nexscope.

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

Prompts y casos de uso de API de inteligencia 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. Términos de búsqueda semanales

Prompt: Utilizar datos de búsqueda de Amazon Brand Analytics [MARKETPLACE] para investigar esta pregunta: [RESEARCH_QUESTION].

2. Descargar investigación de palabras clave

Prompt: Research [RESEARCH_QUESTION] usando datos de Amazon Brand Analytics para [MARKETPLACE]. [INCLUDE_OR_SKIP] a CSV enlace de descarga para los resultados devueltos.

3. Comparar Haga clic en Compartir con conversión Compartir

Prompt: Utilizar datos de búsqueda de Amazon Brand Analytics [MARKETPLACE] para investigar esta pregunta: [RESEARCH_QUESTION]. Para cada término de búsqueda devuelto, semana y región de presentación de informes, compare los productos con clic utilizando sus acciones de clic y conversión. Mostrar cuota de conversión menos clic en compartir en puntos porcentuales sólo cuando ambas fracciones se devuelven; nunca trate esa diferencia como tasa de conversión.

4. Priorizar los Términos de Búsqueda Semanal

Prompt: Utilizar datos de búsqueda de Amazon Brand Analytics [MARKETPLACE] para investigar esta pregunta: [RESEARCH_QUESTION]. Ordene los términos devueltos por rango de frecuencia de búsqueda, con rangos inferiores primero. Mantenga la presentación de informes semanas y regiones separadas y mostrar lo que hizo clic ASINs pertenecen a cada término. No interprete el rango como volumen de búsqueda.

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_intelligence

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-intelligence-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_keyword_intelligence",
    "arguments": {
      "analysisDescription": "Find Amazon Brand Analytics search demand for phone case in the US marketplace",
      "createDownloadUrl": false,
      "region": "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
`analysisDescription`	`string`	obligatorio	Descripción del lenguaje natural que expresa precisamente la intención de la consulta Ejemplo: Analyze Amazon Brand Analytics search demand for phone case in the US marketplace
`region`	`string`	opcional	Código del sitio, predeterminado US. Opciones: US, DE, BR, CA, AU, JP, AE, ES, FR, IT, SA, TR, MX, SE, NL Ejemplo: US
`createDownloadUrl`	`boolean`	opcional	Ya sea para generar un CSV enlace de descarga, predeterminado falso 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
`success`	`boolean`	opcional	Si la consulta es exitosa.
`tables`	`array`	opcional	matriz de datos resultante; cada elemento contiene `data` (rema de datos), `columns` (definición de columnas) y `name` (nombre de hoja).
`total`	`integer`	opcional	Número total de resultados.
`downloadUrl`	`string`	opcional	El CSV dirección de archivo devuelto cuando `createDownloadUrl` es `true`.
`msg`	`string`	opcional	Mensaje adicional.
`downloadNote`	`string`	opcional	Consejos para descargar.
`code`	`string`	opcional	Código de devolución.
`costTime`	`integer`	opcional	Tiempo tomado, en milisegundos.
`costToken`	`integer`	opcional	La señal consumida por esta llamada.
`data`	`array`	opcional	Consultar filas de datos de resultados. Las columnas reales variarán dependiendo de las condiciones de consulta.
`columns`	`array`	opcional	Definición de columna de resultados.
`name`	`string`	opcional	Nombre de hoja.
`searchTerm`	`string`	opcional	Palabras clave de búsqueda de consumidores.
`reportStartDate`	`string`	opcional	La fecha de inicio de la semana de recopilación de datos.
`region`	`string`	opcional	Código del sitio de Amazon.
`searchFrequencyRank`	`integer`	opcional	Buscar popularidad ranking; el menor el valor, el mayor la popularidad de búsqueda, y 1 es el más popular.
`clickedAsin`	`string`	opcional	El ASIN del producto clicado.
`clickedItemName`	`string`	opcional	El nombre del producto clicado.
`clickShareRank`	`integer`	opcional	El ranking de compartir clic en este ASIN bajo este término de búsqueda.
`clickShare`	`number`	opcional	El click share recibido por este ASIN, que van de 0 a 1.
`conversionShare`	`number`	opcional	La cuota de conversión obtenida ASIN, que van de 0 a 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

Mostrar las cifras de Brand Analytics devueltas para “garage door handle kit” en el US.

Respuesta de ejemplo

Para el informe que comienza el 6 de septiembre de 2026, la muestra indica una posición de frecuencia de búsqueda de 2.088.543. Uno de los productos en los que se hizo clic es el ASIN B000KKX9SU, con una cuota de clics de 0.0938 y una cuota de conversión de 0.2, tal como se devolvieron. La muestra incluye filas repetidas; no deben sumarse como observaciones independientes.

Sobre esta muestra: El rango de frecuencia de búsqueda no es volumen de búsqueda. Las acciones se retienen como se devuelve, y esta muestra histórica no es el último informe disponible. El MCP JSON normaliza las cuerdas numéricas a los tipos numéricos en el esquema documentado; el original publicado REST muestra permanece disponible por separado.

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

{
  "analysisDescription": "List the top 40 Amazon search terms by Brand Analytics search frequency rank (smaller rank = higher search volume) for the most recent available report week in the US marketplace, restricted to search terms containing or closely matching any of: door handle kit, trim replacement kit, auto interior accessories, car trim panel, replacement car parts interior. For each term return reportStartDate, searchTerm, searchFrequencyRank, and the top clicked ASINs with clickedAsin, clickedItemName, clickShare and conversionShare.",
  "region": "US",
  "createDownloadUrl": false
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "tables": [
      {
        "data": [
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "Prime-Line GD 52121 Tee Latching Handle, Diecast Zinc (Single Pack)",
            "clickedasin": "B000KKX9SU",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.2"
          },
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "Prime-Line GD 52121 Tee Latching Handle, Diecast Zinc (Single Pack)",
            "clickedasin": "B000KKX9SU",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.2"
          },
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "Garage Door Lock Kit, Complete Set with Spring Latch and Keyed Handle",
            "clickedasin": "B0D9LSBTLP",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.0"
          },
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "Garage Door Lock Kit, Complete Set with Spring Latch and Keyed Handle",
            "clickedasin": "B0D9LSBTLP",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.0"
          },
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "QZATTCAEN Heavy-Duty Garage Door Lock Kit, Universal L-Handle with Inside Side Latch, Copper Cylinder & Keys, Zinc Alloy Handle, Complete Hardware Set for Shed Barn Garage Doors, 3 Sizes Screws-1 Set",
            "clickedasin": "B0GT95PT1V",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.0"
          },
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "QZATTCAEN Heavy-Duty Garage Door Lock Kit, Universal L-Handle with Inside Side Latch, Copper Cylinder & Keys, Zinc Alloy Handle, Complete Hardware Set for Shed Barn Garage Doors, 3 Sizes Screws-1 Set",
            "clickedasin": "B0GT95PT1V",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.0"
          }
        ],
        "columns": [
          {
            "filterable": true,
            "cellType": "text",
            "field": "reportstartdate",
            "sortable": true,
            "title": "reportstartdate"
          },
          {
            "filterable": true,
            "cellType": "text",
            "field": "searchterm",
            "sortable": true,
            "title": "searchterm"
          },
          {
            "filterable": true,
            "cellType": "number",
            "field": "searchfrequencyrank",
            "sortable": true,
            "title": "searchfrequencyrank"
          },
          {
            "filterable": true,
            "cellType": "text",
            "field": "clickedasin",
            "sortable": true,
            "title": "clickedasin"
          },
          {
            "filterable": true,
            "cellType": "text",
            "field": "clickeditemname",
            "sortable": true,
            "title": "clickeditemname"
          },
          {
            "filterable": true,
            "cellType": "number",
            "field": "clickShare",
            "description": "该ASIN获得的点击数占该搜索词总点击数的比例，取值范围：0-1",
            "sortable": true,
            "title": "点击占比"
          },
          {
            "filterable": true,
            "cellType": "number",
            "field": "conversionShare",
            "description": "该ASIN获得的购买数占该搜索词总购买数的比例，取值范围：0-1",
            "sortable": true,
            "title": "转化占比"
          }
        ],
        "name": "美国站最新一周汽车内饰配件相关搜索词Top 40",
        "userExplanation": "筛选美国站最新一周的数据，查找包含以下任一短语的搜索词：door handle kit（门把手套件）、trim replacement kit（装饰条更换套件）、auto interior accessories（汽车内饰配件）、car trim panel（汽车装饰板）、replacement car parts interior（内饰替换配件）。按搜索频率排名升序排列，返回排名前40的搜索词，以及每个搜索词对应的被点击ASIN、商品名称、点击占比和转化占比。站点：美国站。返回数量：40个搜索词。",
        "analysisStatement": ""
      }
    ],
    "total": 6,
    "downloadNote": "如需下载结果，请在消息栏发\"下载CSV文件\"告诉我。",
    "costTime": 44428,
    "success": true,
    "type": "tablesListWorkbenches",
    "title": "数据挖掘结果"
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos