Keywords Trends

Categoría MCP

Categoría Palabras clave. Librada Nexscope Datos de la base de datos con evidencia explícita faltante. Una tarea fija; sin paginación. Los valores ausentes no son cero. Los precios y la publicación no se aprueban. Los resultados exitosos sólo para propietarios siguen disponibles en la historia de llamadas. Las reglas de frecuencia fuente de siete días se aplican sólo a las solicitudes dependientes.

CosteRecent Avg. 20 · Range 18–20 créditos por llamadaPrueba en línea

Prompts y casos de uso de Categoría

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. Buscar Palabras clave en categorías seleccionadas

Prompt: Encontrar US Palabras clave en inglés que coinciden con todas las categorías en [category ID list]. Mostrar el volumen de búsqueda devuelto y las métricas de publicidad sin tratarlas como conversiones. Volver a 10 resultados en esta solicitud.

2. Revise una muestra de resultados más pequeña

3. Partido Cualquier categoría seleccionada

Prompt: Encontrar US Palabras clave en inglés que se ajuste a cualquier categoría en [category ID list]. Mostrar el volumen de búsqueda devuelto y las métricas de publicidad sin tratarlas como conversiones.

Qué debes proporcionar

Esta herramienta solo admite el mercado US; no selecciones otro país.

Introduce los datos en inglés y mantén el alcance limitado a ese idioma.

Proveer no más de 20 categorías IDs.

Un valor ausente no equivale a cero. Interpreta únicamente los datos devueltos dentro del período de observación y del alcance de la muestra.

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_seo_category_keywords

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": "seo-category-keywords-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_seo_category_keywords",
    "arguments": {
      "categoryIds": [
        12191
      ],
      "categoryMatch": "ALL",
      "language": "en",
      "limit": 10,
      "market": "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
`categoryIds`	`array`	obligatorio	Valor de Category ids usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 20
`categoryIds[]`	`integer`	obligatorio	Elemento de categoryIds. Mínimo: 1 Máximo: 2147483647
`categoryMatch`	`string`	opcional	Valor de Category match usado por esta operación de API. Permitidos: ALL, ANY Predeterminado: ALL
`language`	`string`	opcional	Valor de Language usado por esta operación de API. Constante: en Predeterminado: en
`limit`	`integer`	opcional	Valor de Limit usado por esta operación de API. Predeterminado: 10 Mínimo: 1 Máximo: 20
`market`	`string`	opcional	Valor de Market usado por esta operación de API. Constante: US Predeterminado: US

Campos de respuesta

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

Nombre	Tipo	Obligatorio	Descripción
`code`	`integer`	obligatorio	0 es un sobre exitoso; inspeccionar data.status por separado. Permitidos: 0, 42008, 42009
`cost`	`string`	obligatorio	Procesamiento transcurrido milisegundos; no precio. -1 para contextos no-web.
`data`	`object`	obligatorio	Valor de Data usado por esta operación de API.
`data.callId`	`string \| null`	opcional	Valor de Call id usado por esta operación de API.
`data.completedAt`	`string \| integer \| null`	opcional	Valor de Completed at usado por esta operación de API.
`data.coverage`	`object`	opcional	Valor de Coverage usado por esta operación de API.
`data.coverage.missing`	`array`	opcional	Valor de Missing usado por esta operación de API.
`data.coverage.missing[]`	`object`	obligatorio	Elemento de data coverage missing.
`data.coverage.missing[].field`	`string`	opcional	Valor de Field usado por esta operación de API.
`data.coverage.missing[].reason`	`string`	opcional	Valor de Reason usado por esta operación de API.
`data.coverage.status`	`string`	opcional	Valor de Status usado por esta operación de API.
`data.requestedAt`	`string \| integer \| null`	opcional	Valor de Requested at usado por esta operación de API.
`data.result`	`object \| null`	obligatorio	Valor de Result usado por esta operación de API.
`data.result.categoryIds`	`array`	obligatorio	Valor de Category ids usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 20
`data.result.categoryIds[]`	`integer`	obligatorio	Elemento de data result categoryIds. Mínimo: 1
`data.result.categoryMatch`	`string`	obligatorio	Valor de Category match usado por esta operación de API. Permitidos: ALL, ANY
`data.result.items`	`array`	obligatorio	Valor de Items usado por esta operación de API. Cantidad mínima de elementos: 0 Cantidad máxima de elementos: 20
`data.result.items[]`	`object`	obligatorio	Elemento de data result items.
`data.result.items[].categoryIds`	`array`	obligatorio	Valor de Category ids usado por esta operación de API. Cantidad mínima de elementos: 0
`data.result.items[].categoryIds[]`	`integer`	obligatorio	Elemento de data result items[] categoryIds. Mínimo: 1 Máximo: 2147483647
`data.result.items[].competition`	`number \| null`	obligatorio	Valor de Competition usado por esta operación de API. Mínimo: 0 Máximo: 1
`data.result.items[].cpcUsd`	`string \| null`	obligatorio	Valor de Cpc usd usado por esta operación de API. Patrón: ^(0\|[1-9][0-9]*)(\.[0-9]+)?$
`data.result.items[].keyword`	`string`	obligatorio	Valor de Keyword usado por esta operación de API. Longitud mínima: 1
`data.result.items[].missing`	`array`	obligatorio	Valor de Missing usado por esta operación de API. Cantidad mínima de elementos: 0
`data.result.items[].missing[]`	`object`	obligatorio	Elemento de data result items[] missing.
`data.result.items[].missing[].field`	`string`	obligatorio	Valor de Field usado por esta operación de API.
`data.result.items[].missing[].reason`	`string`	obligatorio	Valor de Reason usado por esta operación de API. Permitidos: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM
`data.result.items[].searchVolume`	`integer \| null`	obligatorio	Valor de Search volume usado por esta operación de API. Mínimo: 0
`data.result.language`	`string`	obligatorio	Valor de Language usado por esta operación de API. Constante: en
`data.result.market`	`string`	obligatorio	Valor de Market usado por esta operación de API. Constante: US
`data.result.missing`	`array`	obligatorio	Valor de Missing usado por esta operación de API. Cantidad mínima de elementos: 0
`data.result.missing[]`	`object`	obligatorio	Elemento de data result missing.
`data.result.missing[].field`	`string`	obligatorio	Valor de Field usado por esta operación de API.
`data.result.missing[].reason`	`string`	obligatorio	Valor de Reason usado por esta operación de API. Permitidos: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM
`data.result.normalizedCategoryIds`	`array`	obligatorio	Valor de Normalized category ids usado por esta operación de API. Cantidad mínima de elementos: 0
`data.result.normalizedCategoryIds[]`	`integer`	obligatorio	Elemento de data result normalizedCategoryIds. Mínimo: 1 Máximo: 2147483647
`data.result.ordering`	`string`	obligatorio	Valor de Ordering usado por esta operación de API. Constante: search_volume_desc
`data.result.requestedLimit`	`integer`	obligatorio	Valor de Requested limit usado por esta operación de API. Mínimo: 1 Máximo: 20
`data.result.returnedCount`	`integer`	obligatorio	Valor de Returned count usado por esta operación de API. Mínimo: 0 Máximo: 20
`data.result.taxonomy`	`string`	obligatorio	Valor de Taxonomy usado por esta operación de API. Constante: google_product_service
`data.schemaVersion`	`string \| null`	opcional	Valor de Schema version usado por esta operación de API.
`data.source`	`string \| null`	opcional	Valor de Source usado por esta operación de API.
`data.status`	`string`	opcional	Valor de Status usado por esta operación de API. Permitidos: SUCCESS, PARTIAL, EMPTY, PROCESSING, UNKNOWN, FAILED
`data.usage`	`object \| null`	opcional	Valor de Usage usado por esta operación de API.
`data.usage.billingStatus`	`string \| null`	opcional	Valor de Billing status usado por esta operación de API.
`data.usage.chargedCredits`	`string \| integer \| null`	opcional	Valor de Charged credits usado por esta operación de API.
`msg`	`string \| null`	obligatorio	Disponible aguas arriba msg/errmsg/message es preferido por el éxito y el fracaso; el chino se traduce al inglés. Perder el mensaje exitoso es nulo. Solo errores y estados de tareas utilizan la plataforma Inglés. El texto del mensaje nunca determina el éxito o la reingresación.
`time`	`string`	obligatorio	Sí...MM- No. HH:mm:ss
`traceId`	`string \| null`	obligatorio	Valor de Trace id usado por esta operación de API.
`ts`	`string`	obligatorio	Epoch milliseconds; global long serializer.

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

Encontrar US Palabras clave en inglés que corresponden a todas las categorías en 12199. Mostrar el volumen de búsqueda devuelto y las métricas de publicidad sin tratarlas como conversiones. Mostrar hasta 10 resultados.

Respuesta de ejemplo

La primera palabra clave devuelta es “compare el tamaño”, con volumen de búsqueda de 18,100. Su costo por clic está desaparecido, por lo que esta muestra no puede soportar una estimación de costo por clic o costo de publicidad.

Sobre esta muestra: Este ejemplo se basa en una muestra de la documentación publicada; no procede de una llamada nueva ni en vivo. Conserva las fechas, el alcance de la fuente y los datos ausentes: las métricas de la muestra no describen el rendimiento actual. La solicitud siguiente adapta las entradas publicadas a los nombres de argumentos MCP documentados; la muestra REST original se muestra por separado. Los valores exigidos por la envoltura de transporte (cost, time, traceId y ts) son ilustrativos para completar el esquema, no tiempos publicados; los datos del resultado se conservan.

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

{
  "limit": 10,
  "market": "US",
  "language": "en",
  "categoryIds": [
    12199
  ],
  "categoryMatch": "ALL",
  "normalizedCategoryIds": [
    12199
  ]
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "usage": {
      "billingStatus": "CHARGED",
      "chargedCredits": 20
    },
    "callId": "1027b027-6bb8-42d5-9010-1cb2ea8fbfd1",
    "result": {
      "items": [
        {
          "cpcUsd": null,
          "keyword": "compare the size",
          "missing": [
            {
              "field": "result[0].items[0].keyword_info.cpc",
              "reason": "UPSTREAM_FIELD_MISSING"
            }
          ],
          "categoryIds": [
            10019,
            10168,
            12199
          ],
          "competition": 0,
          "searchVolume": 18100
        },
        {
          "cpcUsd": null,
          "keyword": "size comparison",
          "missing": [
            {
              "field": "result[0].items[1].keyword_info.cpc",
              "reason": "UPSTREAM_FIELD_MISSING"
            }
          ],
          "categoryIds": [
            10019,
            10168,
            12199
          ],
          "competition": 0,
          "searchVolume": 18100
        },
        {
          "cpcUsd": null,
          "keyword": "sizes comparison",
          "missing": [
            {
              "field": "result[0].items[2].keyword_info.cpc",
              "reason": "UPSTREAM_FIELD_MISSING"
            }
          ],
          "categoryIds": [
            10019,
            10168,
            12199
          ],
          "competition": 0,
          "searchVolume": 18100
        },
        {
          "cpcUsd": null,
          "keyword": "size comparisons",
          "missing": [
            {
              "field": "result[0].items[3].keyword_info.cpc",
              "reason": "UPSTREAM_FIELD_MISSING"
            }
          ],
          "categoryIds": [
            10019,
            10168,
            12199
          ],
          "competition": 0,
          "searchVolume": 18100
        },
        {
          "cpcUsd": null,
          "keyword": "compare 14-inch and 15.6 inch laptop",
          "missing": [
            {
              "field": "result[0].items[4].keyword_info.cpc",
              "reason": "UPSTREAM_FIELD_MISSING"
            }
          ],
          "categoryIds": [
            10019,
            10168,
            10883,
            12187,
            12199,
            13069
          ],
          "competition": 0,
          "searchVolume": 8100
        },
        {
          "cpcUsd": "2.74",
          "keyword": "side by side comparisons",
          "missing": [],
          "categoryIds": [
            10019,
            10168,
            12199
          ],
          "competition": 0,
          "searchVolume": 5400
        },
        {
          "cpcUsd": "2.74",
          "keyword": "side-by-side comparisons",
          "missing": [],
          "categoryIds": [
            10019,
            10168,
            12199
          ],
          "competition": 0,
          "searchVolume": 5400
        },
        {
          "cpcUsd": "2.74",
          "keyword": "side by-side comparisons",
          "missing": [],
          "categoryIds": [
            10019,
            10168,
            12199
          ],
          "competition": 0,
          "searchVolume": 5400
        },
        {
          "cpcUsd": "2.74",
          "keyword": "side by side comparison",
          "missing": [],
          "categoryIds": [
            10019,
            10168,
            12199
          ],
          "competition": 0,
          "searchVolume": 5400
        },
        {
          "cpcUsd": "9.86",
          "keyword": "compare device sizes",
          "missing": [],
          "categoryIds": [
            10019,
            10168,
            12199
          ],
          "competition": 0.02,
          "searchVolume": 3600
        }
      ],
      "market": "US",
      "missing": [
        {
          "field": "result[0].items[0].keyword_info.cpc",
          "reason": "UPSTREAM_FIELD_MISSING"
        },
        {
          "field": "result[0].items[1].keyword_info.cpc",
          "reason": "UPSTREAM_FIELD_MISSING"
        },
        {
          "field": "result[0].items[2].keyword_info.cpc",
          "reason": "UPSTREAM_FIELD_MISSING"
        },
        {
          "field": "result[0].items[3].keyword_info.cpc",
          "reason": "UPSTREAM_FIELD_MISSING"
        },
        {
          "field": "result[0].items[4].keyword_info.cpc",
          "reason": "UPSTREAM_FIELD_MISSING"
        }
      ],
      "language": "en",
      "ordering": "search_volume_desc",
      "taxonomy": "google_product_service",
      "categoryIds": [
        12199
      ],
      "categoryMatch": "ALL",
      "returnedCount": 10,
      "requestedLimit": 10,
      "normalizedCategoryIds": [
        12199
      ]
    },
    "source": "dataforseo",
    "status": "SUCCESS",
    "coverage": {
      "status": "PARTIAL",
      "missing": [
        {
          "field": "result[0].items[0].keyword_info.cpc",
          "reason": "UPSTREAM_FIELD_MISSING"
        },
        {
          "field": "result[0].items[1].keyword_info.cpc",
          "reason": "UPSTREAM_FIELD_MISSING"
        },
        {
          "field": "result[0].items[2].keyword_info.cpc",
          "reason": "UPSTREAM_FIELD_MISSING"
        },
        {
          "field": "result[0].items[3].keyword_info.cpc",
          "reason": "UPSTREAM_FIELD_MISSING"
        },
        {
          "field": "result[0].items[4].keyword_info.cpc",
          "reason": "UPSTREAM_FIELD_MISSING"
        }
      ]
    },
    "completedAt": 1790240712384,
    "requestedAt": 1790240711285,
    "schemaVersion": "MDX-F1-LABS-1.0"
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos