Keywords Trends

Palabras clave Perfil histórico MCP

Palabras clave Perfil histórico instantáneas. Datos encontrados de la base de datos de Google; el tráfico estimado no se mide visitas. Una vida fija POSTSin paginación. Los campos desconocidos y los valores ausentes son explícitos. La ejecución y publicación siguen sin aprobarse. Los resultados obtenidos con éxito siguen estando disponibles en el historial de llamadas del propietario. Las reglas de frecuencia fuente de siete días se aplican sólo a las solicitudes dependientes.

CosteRecent 19 créditos por llamadaPrueba en línea

Prompts y casos de uso de Palabras clave Perfil histórico

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. Revisión Metrices históricas de la palabra clave

2. Reseña Palabra clave Estacionalidad y Cambios de Costo

Prompt: Mostrar métricas históricas mensuales para [keyword list] desde [first month] a través de [last month] dentro US Búsqueda en inglés. Conserva la fuente e indica los períodos sin datos. Mostrar volumen de búsqueda mensual, competencia pagada y USD cost-per-click para cada palabra clave devuelta. Identificar picos y cambios observados sin prever o tratar la competencia pagada como dificultad orgánica.

3. Buscar palabras claves con creciente demanda y aumento CPC

Prompt: Recuperar mensualmente US métricas en inglés [up to 20 keywords] desde [first month] a [last month]. Comparación [selected month A] y [selected month B] sólo donde el volumen de búsqueda y USD costo por clic existen. Los términos de bandera donde ambos valores aumentaron y muestran cada cambio absoluto; no inferir causación, ofertas reales o dificultad de palabra clave orgánica.

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.

Proporciona como máximo 20 palabras clave.

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_history

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-history-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_seo_keyword_history",
    "arguments": {
      "fromMonth": "2026-01",
      "keywords": [
        "nexscope"
      ],
      "language": "en",
      "market": "US",
      "toMonth": "2026-06"
    }
  }
}

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
`fromMonth`	`string`	obligatorio	Valor de From month usado por esta operación de API. Patrón: ^\d{4}-\d{2}$
`keywords`	`array`	obligatorio	Valor de Keywords usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 20
`keywords[]`	`string`	obligatorio	Elemento de keywords. Longitud mínima: 1 Longitud máxima: 80
`language`	`string`	opcional	Valor de Language usado por esta operación de API. Constante: en Predeterminado: en
`market`	`string`	opcional	Valor de Market usado por esta operación de API. Constante: US Predeterminado: US
`toMonth`	`string`	obligatorio	Valor de To month usado por esta operación de API. Patrón: ^\d{4}-\d{2}$

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.engine`	`string`	obligatorio	Valor de Engine usado por esta operación de API. Constante: google
`data.result.fromMonth`	`string`	obligatorio	Valor de From month usado por esta operación de API.
`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[].history`	`array`	obligatorio	Valor de History usado por esta operación de API. Cantidad mínima de elementos: 0 Cantidad máxima de elementos: 12
`data.result.items[].history[]`	`object`	obligatorio	Elemento de data result items[] history.
`data.result.items[].history[].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[].history[].metricsUpdatedAt`	`integer \| null`	obligatorio	Valor de Metrics updated at usado por esta operación de API. Mínimo: 0
`data.result.items[].history[].missing`	`array`	obligatorio	Valor de Missing usado por esta operación de API. Cantidad mínima de elementos: 0
`data.result.items[].history[].missing[]`	`object`	obligatorio	Elemento de data result items[] history[] missing.
`data.result.items[].history[].missing[].field`	`string`	obligatorio	Valor de Field usado por esta operación de API.
`data.result.items[].history[].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[].history[].month`	`integer`	obligatorio	Valor de Month usado por esta operación de API. Mínimo: 1 Máximo: 12
`data.result.items[].history[].paidCompetition`	`number \| null`	obligatorio	Valor de Paid competition usado por esta operación de API. Mínimo: 0 Máximo: 1
`data.result.items[].history[].searchVolume`	`integer \| null`	obligatorio	Valor de Search volume usado por esta operación de API. Mínimo: 0
`data.result.items[].history[].year`	`integer`	obligatorio	Valor de Year usado por esta operación de API. Mínimo: 1
`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.keywords`	`array`	obligatorio	Valor de Keywords usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 20
`data.result.keywords[]`	`string`	obligatorio	Elemento de data result keywords.
`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.metricSource`	`string`	obligatorio	Valor de Metric source usado por esta operación de API. Constante: google_ads_historical_keyword_profile
`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: 20
`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.sourceProduct`	`string`	obligatorio	Valor de Source product usado por esta operación de API. Constante: dataforseo_labs
`data.result.timeGranularity`	`string`	obligatorio	Valor de Time granularity usado por esta operación de API. Constante: month
`data.result.toMonth`	`string`	obligatorio	Valor de To month usado por esta operación de API.
`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 métricas históricas mensuales para Black White Cardigan de 2026-01 a 2026-06 en US Búsqueda en inglés. Preserve la fuente y los períodos perdidos.

Respuesta de ejemplo

Para “Cardigan blanco negro”, la muestra reporta enero 2026 volumen de búsqueda de 1.900 y costo por clic de USD 0.59, seguido por el volumen de febrero de 1.600 y costo por clic USD 0,75. Estos son perfiles históricos mensuales.

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

{
  "market": "US",
  "toMonth": "2026-06",
  "keywords": [
    "Black White Cardigan"
  ],
  "language": "en",
  "fromMonth": "2026-01",
  "normalizedKeywords": [
    "black white cardigan"
  ]
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "usage": {
      "billingStatus": "CHARGED",
      "chargedCredits": 19
    },
    "callId": "71b8f73f-66b5-419b-93ef-945ffffce95f",
    "result": {
      "items": [
        {
          "history": [
            {
              "year": 2026,
              "month": 1,
              "cpcUsd": "0.59",
              "missing": [],
              "searchVolume": 1900,
              "paidCompetition": 1,
              "metricsUpdatedAt": 1773063925000
            },
            {
              "year": 2026,
              "month": 2,
              "cpcUsd": "0.75",
              "missing": [],
              "searchVolume": 1600,
              "paidCompetition": 1,
              "metricsUpdatedAt": 1773594157000
            },
            {
              "year": 2026,
              "month": 3,
              "cpcUsd": "0.82",
              "missing": [],
              "searchVolume": 1600,
              "paidCompetition": 1,
              "metricsUpdatedAt": 1776267650000
            },
            {
              "year": 2026,
              "month": 4,
              "cpcUsd": "0.98",
              "missing": [],
              "searchVolume": 1600,
              "paidCompetition": 1,
              "metricsUpdatedAt": 1779531208000
            },
            {
              "year": 2026,
              "month": 5,
              "cpcUsd": "0.97",
              "missing": [],
              "searchVolume": 1600,
              "paidCompetition": 1,
              "metricsUpdatedAt": 1781581368000
            },
            {
              "year": 2026,
              "month": 6,
              "cpcUsd": "0.82",
              "missing": [],
              "searchVolume": 1600,
              "paidCompetition": 1,
              "metricsUpdatedAt": 1784000741000
            }
          ],
          "keyword": "black white cardigan",
          "missing": []
        }
      ],
      "engine": "google",
      "market": "US",
      "missing": [],
      "toMonth": "2026-06",
      "keywords": [
        "Black White Cardigan"
      ],
      "language": "en",
      "fromMonth": "2026-01",
      "truncated": false,
      "metricSource": "google_ads_historical_keyword_profile",
      "returnedCount": 1,
      "sourceProduct": "dataforseo_labs",
      "timeGranularity": "month",
      "normalizedKeywords": [
        "black white cardigan"
      ]
    },
    "source": "dataforseo",
    "status": "SUCCESS",
    "coverage": {
      "status": "COMPLETE",
      "missing": []
    },
    "completedAt": 1792528530055,
    "requestedAt": 1792528519700,
    "schemaVersion": "MDX-F1-KW02-1.0"
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos