Keywords Trends

Palabras clave Interés por Demografía MCP

Nexscope Tendencias relativa interés por palabra clave por edad y género. Cada dimensión tiene puntajes relativamente normalizados. No infiere las acciones, los conteos, los ingresos o los cubos demográficos no revocados.

CosteRecent 10 créditos por llamadaPrueba en línea

Prompts y casos de uso de Palabras clave Interés por Demografí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. Compare Búsqueda de interés por Demographic

2. Patrones separados de edad e intereses de género

Prompt: Mostrar US distribución demográfica del interés en la búsqueda [up to five keywords] desde [start date] a través de [end date]. Mantener estas observaciones separadas de la demografía de clientes o compradores. Crear tablas separadas de banda de edad e interés de género para cada palabra clave. Escamas de fuentes preseleccionadas y segmentos desaparecidos; no combine tablas marginales en un público de edad por género o conteos de población inferida.

3. Comparar Perfiles de Audiencia de Palabras Claves Sin Inventar Cuentas de Comprador

Prompt: Consulta los datos demográficos de interés de búsqueda en EE. UU. para [two to five keywords] entre [start date] y [end date], dentro de 366 días. Para cada palabra clave, identifique su banda de edad más fuerte devuelta y categoría de género más fuerte devuelta, a continuación, compare las etiquetas a través de palabras clave. Mantener puntuaciones en sus escalas de origen; no combinar la edad y el género en segmentos conjuntos o inferir audiencia absoluta o cuentas de clientes.

Qué debes proporcionar

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

No proporcione más de 5 palabras clave.

Elija un intervalo inclusivo de no más de 366 días, a partir del 1 de enero de 2004, y terminando a más tardar el día de aceptación de la solicitud.

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_keyword_interest_demographics

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-keyword-interest-demographics-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_seo_keyword_interest_demographics",
    "arguments": {
      "dateFrom": "2026-01-01",
      "dateTo": "2026-01-31",
      "keywords": [
        "nexscope"
      ],
      "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
`dateFrom`	`string`	obligatorio	2004-01-01 o posterior; intervalo inclusivo a la mayoría de 366 días. Formato: date
`dateTo`	`string`	obligatorio	No más tarde de la primera aceptación UTC día; la repetición conserva las fechas congeladas. Formato: date
`keywords`	`array`	obligatorio	Valor de Keywords usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 5
`keywords[]`	`string`	obligatorio	Después del corte Unicode, NFC y minúscula, 1 a 80 puntos de código y a la mayoría de las diez palabras separadas del espacio blanco; sin caracteres de control. Longitud mínima: 1
`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.dateFrom`	`string`	obligatorio	Valor de Date from usado por esta operación de API. Formato: date
`data.result.dateTo`	`string`	obligatorio	Valor de Date to usado por esta operación de API. Formato: date
`data.result.inputKeywords`	`array`	obligatorio	Valor de Input keywords usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 5
`data.result.inputKeywords[]`	`string`	obligatorio	Elemento de data result inputKeywords.
`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: 5
`data.result.items[]`	`object`	obligatorio	Elemento de data result items.
`data.result.items[].age`	`array`	obligatorio	Valor de Age usado por esta operación de API. Cantidad mínima de elementos: 0 Cantidad máxima de elementos: 5
`data.result.items[].age[]`	`object`	obligatorio	Elemento de data result items[] age.
`data.result.items[].age[].band`	`string`	obligatorio	Valor de Band usado por esta operación de API. Permitidos: 18-24, 25-34, 35-44, 45-54, 55-64
`data.result.items[].age[].interest`	`integer \| null`	obligatorio	Valor de Interest usado por esta operación de API. Mínimo: 0 Máximo: 100
`data.result.items[].age[].missing`	`array`	obligatorio	Valor de Missing usado por esta operación de API. Cantidad mínima de elementos: 0
`data.result.items[].age[].missing[]`	`object`	obligatorio	Elemento de data result items[] age[] missing.
`data.result.items[].age[].missing[].field`	`string`	obligatorio	Valor de Field usado por esta operación de API.
`data.result.items[].age[].missing[].reason`	`string`	obligatorio	Valor de Reason usado por esta operación de API. Permitidos: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING
`data.result.items[].gender`	`array`	obligatorio	Valor de Gender usado por esta operación de API. Cantidad mínima de elementos: 0 Cantidad máxima de elementos: 2
`data.result.items[].gender[]`	`object`	obligatorio	Elemento de data result items[] gender.
`data.result.items[].gender[].category`	`string`	obligatorio	Valor de Category usado por esta operación de API. Permitidos: female, male
`data.result.items[].gender[].interest`	`integer \| null`	obligatorio	Valor de Interest usado por esta operación de API. Mínimo: 0 Máximo: 100
`data.result.items[].gender[].missing`	`array`	obligatorio	Valor de Missing usado por esta operación de API. Cantidad mínima de elementos: 0
`data.result.items[].gender[].missing[]`	`object`	obligatorio	Elemento de data result items[] gender[] missing.
`data.result.items[].gender[].missing[].field`	`string`	obligatorio	Valor de Field usado por esta operación de API.
`data.result.items[].gender[].missing[].reason`	`string`	obligatorio	Valor de Reason usado por esta operación de API. Permitidos: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING
`data.result.items[].keyword`	`string`	obligatorio	Valor de Keyword usado por esta operación de API.
`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, UPSTREAM_ITEM_MISSING
`data.result.languageFilter`	`null`	obligatorio	Valor de Language filter usado por esta operación de API.
`data.result.marketScope`	`string`	obligatorio	Valor de Market scope 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, UPSTREAM_ITEM_MISSING
`data.result.normalizedKeywords`	`array`	obligatorio	Valor de Normalized keywords usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 5
`data.result.normalizedKeywords[]`	`string`	obligatorio	Elemento de data result normalizedKeywords.
`data.result.returnedCount`	`integer`	obligatorio	Valor de Returned count usado por esta operación de API. Mínimo: 0
`data.result.sourceKind`	`string`	obligatorio	Valor de Source kind usado por esta operación de API. Constante: dataforseo_trends_demographic_relative
`data.result.sourceProduct`	`string`	obligatorio	Valor de Source product usado por esta operación de API. Constante: keywords_data
`data.result.truncated`	`boolean`	obligatorio	Valor de Truncated usado por esta operación de API.
`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

Mostrar US distribución demográfica del interés de búsqueda por nike de 2025-01-01 a 2025-06-30. Mantener estas observaciones separadas de la demografía del cliente o del comprador.

Respuesta de ejemplo

Para “nike”, la muestra da al grupo de edad de 25–34 un índice de interés de 100 y el grupo 18–24 un índice de 75. Estos son índices de interés relativo, no porcentajes de clientes o compradores.

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

{
  "dateTo": "2025-06-30",
  "dateFrom": "2025-01-01",
  "marketScope": "US",
  "inputKeywords": [
    "nike"
  ],
  "normalizedKeywords": [
    "nike"
  ]
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "usage": {
      "billingStatus": "CHARGED",
      "chargedCredits": 4
    },
    "callId": "4fa498ca-6839-4625-a5a3-605be1e83a34",
    "result": {
      "items": [
        {
          "age": [
            {
              "band": "18-24",
              "missing": [],
              "interest": 75
            },
            {
              "band": "25-34",
              "missing": [],
              "interest": 100
            },
            {
              "band": "35-44",
              "missing": [],
              "interest": 89
            },
            {
              "band": "45-54",
              "missing": [],
              "interest": 58
            },
            {
              "band": "55-64",
              "missing": [],
              "interest": 24
            }
          ],
          "gender": [
            {
              "missing": [],
              "category": "female",
              "interest": 100
            },
            {
              "missing": [],
              "category": "male",
              "interest": 91
            }
          ],
          "keyword": "nike",
          "missing": []
        }
      ],
      "dateTo": "2025-06-30",
      "missing": [],
      "dateFrom": "2025-01-01",
      "truncated": false,
      "sourceKind": "dataforseo_trends_demographic_relative",
      "marketScope": "US",
      "inputKeywords": [
        "nike"
      ],
      "returnedCount": 1,
      "sourceProduct": "keywords_data",
      "languageFilter": null,
      "normalizedKeywords": [
        "nike"
      ]
    },
    "source": "dataforseo",
    "status": "SUCCESS",
    "coverage": {
      "status": "COMPLETE",
      "missing": []
    },
    "completedAt": 1789953266200,
    "requestedAt": 1789953260985,
    "schemaVersion": "MDX-F1-KW-15-1.0"
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos