Búsqueda web

SEO Metrices de palabras clave MCP

métricas de palabras clave con cobertura explícita para cada entrada. Las llamadas son idempotentes por el usuario, la rotura y UUID llave. Retrieval de resultado de sólo propietario: GET /seo/keywordMetrics/calls/{callId} o nexscope_seo_call_result. Los resultados exitosos siguen disponibles en la historia de las llamadas del propietario. Las reglas de frecuencia fuente de siete días se aplican sólo a las solicitudes dependientes. Los valores ausentes no son cero. Ejemplos describen la estructura solamente y no son resultados medidos.

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

Prompts y casos de uso de SEO Metrices de palabras clave

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 la demanda de palabras clave y la competencia

Prompt: Mira. US métricas en inglés [keyword list]. Compare el volumen de búsqueda disponible, el costo por clic y la competencia al tiempo que distingue los datos perdidos de cero.

2. Dificultad para pagar y palabra clave orgánica separada

Prompt: Mira. US métricas en inglés [keyword list]. Compare el volumen de búsqueda disponible, el costo por clic y la competencia al tiempo que distingue los datos perdidos de cero. Compare el volumen de búsqueda devuelto y la dificultad de palabra clave orgánica por separado de la competencia pagada y USD costo por clic. Uso [my stated criteria] para acortar los términos disponibles sin sustituir una medida de competencia por otra.

3. Revisión Mensual de la palabra clave

Prompt: Mira. US métricas en inglés [keyword list]. Compare el volumen de búsqueda disponible, el costo por clic y la competencia al tiempo que distingue los datos perdidos de cero. Mostrar cada palabra clave ha devuelto la serie mensual de volumen de búsqueda y fecha de actualización métrica. Destacan los picos observados, preservan los meses desaparecidos y evitan extrapolar la demanda futura.

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_metrics

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-metrics-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_seo_keyword_metrics",
    "arguments": {
      "keywords": [
        "nexscope"
      ],
      "language": "en",
      "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
`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	Trimmed, a la mayoría de diez palabras separadas del espacio blanco. Longitud mínima: 1 Longitud máxima: 80
`language`	`string`	obligatorio	Valor de Language usado por esta operación de API. Permitidos: en
`market`	`string`	obligatorio	Valor de Market usado por esta operación de API. Permitidos: 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`	opcional	Valor de Call id usado por esta operación de API. Formato: uuid
`data.completedAt`	`string \| integer \| null`	opcional	UTC Época milisegundos.
`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.reason`	`string`	opcional	Razón estable sobre errores 42001 a 42011; errores aceptados conservan callId.
`data.requestedAt`	`string \| integer \| null`	opcional	UTC Época milisegundos.
`data.result`	`object \| null`	obligatorio	Valor de Result usado por esta operación de API.
`data.result.items`	`array`	opcional	Valor de Items usado por esta operación de API.
`data.result.items[]`	`object`	obligatorio	Elemento de data result items.
`data.result.items[].competition`	`number \| null`	opcional	Valor de Competition usado por esta operación de API.
`data.result.items[].competitionLevel`	`string \| null`	opcional	Valor de Competition level usado por esta operación de API.
`data.result.items[].cpcUsd`	`string \| null`	opcional	Valor de Cpc usd usado por esta operación de API.
`data.result.items[].dataUpdatedAt`	`integer \| null`	opcional	Valor de Data updated at usado por esta operación de API.
`data.result.items[].inputIndex`	`integer \| null`	opcional	Valor de Input index usado por esta operación de API.
`data.result.items[].inputKeyword`	`string \| null`	opcional	Valor de Input keyword usado por esta operación de API.
`data.result.items[].keywordDifficulty`	`number \| null`	opcional	Valor de Keyword difficulty usado por esta operación de API.
`data.result.items[].missing`	`array`	opcional	Valor de Missing usado por esta operación de API.
`data.result.items[].missing[]`	`object`	obligatorio	Elemento de data result items[] missing.
`data.result.items[].missing[].field`	`string \| null`	opcional	Valor de Field usado por esta operación de API.
`data.result.items[].missing[].reason`	`string \| null`	opcional	Valor de Reason usado por esta operación de API.
`data.result.items[].monthlySearches`	`array`	opcional	Valor de Monthly searches usado por esta operación de API.
`data.result.items[].monthlySearches[]`	`object`	obligatorio	Elemento de data result items[] monthlySearches.
`data.result.items[].monthlySearches[].month`	`integer \| null`	opcional	Valor de Month usado por esta operación de API.
`data.result.items[].monthlySearches[].searchVolume`	`integer \| null`	opcional	Valor de Search volume usado por esta operación de API.
`data.result.items[].monthlySearches[].year`	`integer \| null`	opcional	Valor de Year usado por esta operación de API.
`data.result.items[].normalizedKeyword`	`string \| null`	opcional	Valor de Normalized keyword usado por esta operación de API.
`data.result.items[].searchVolume`	`integer \| null`	opcional	Valor de Search volume usado por esta operación de API.
`data.result.items[].status`	`string`	opcional	Valor de Status usado por esta operación de API. Permitidos: AVAILABLE, NO_COVERAGE
`data.result.language`	`string \| null`	opcional	Valor de Language usado por esta operación de API.
`data.result.market`	`string \| null`	opcional	Valor de Market usado por esta operación de API.
`data.retryable`	`boolean`	opcional	Valor de Retryable usado por esta operación de API. Constante: false
`data.schemaVersion`	`string`	opcional	Valor de Schema version usado por esta operación de API. Constante: 1.0
`data.source`	`string`	opcional	Valor de Source usado por esta operación de API. Constante: dataforseo
`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

Mira. US métricas en inglés UGEARS UGT-24, ugears ugt-24 endurance racer. Compare el volumen de búsqueda disponible, el costo por clic y la competencia al tiempo que distingue los datos perdidos de cero.

Respuesta de ejemplo

La primera palabra clave, “UGEARS UGT-24”, ha reportado el volumen de búsqueda de 10 y la competencia de 0.71. Costo por clic y dificultad de palabra clave faltan, por lo que ninguno debe ser mostrado como cero.

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. 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",
  "keywords": [
    "UGEARS UGT-24",
    "ugears ugt-24 endurance racer"
  ],
  "language": "en"
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "usage": {
      "billingStatus": "CHARGED",
      "chargedCredits": 19
    },
    "callId": "b7f9c0cc-c642-43cc-8cde-31b876507a76",
    "result": {
      "items": [
        {
          "cpcUsd": null,
          "status": "AVAILABLE",
          "missing": [
            {
              "field": "cpcUsd",
              "reason": "UPSTREAM_FIELD_MISSING"
            },
            {
              "field": "keywordDifficulty",
              "reason": "UPSTREAM_FIELD_MISSING"
            }
          ],
          "inputIndex": 0,
          "competition": 0.71,
          "inputKeyword": "UGEARS UGT-24",
          "searchVolume": 10,
          "dataUpdatedAt": 1789212517000,
          "monthlySearches": [
            {
              "year": 2026,
              "month": 8,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 7,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 6,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 5,
              "searchVolume": 0
            },
            {
              "year": 2026,
              "month": 4,
              "searchVolume": 0
            },
            {
              "year": 2026,
              "month": 3,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 2,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 1,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 12,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 11,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 10,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 9,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 8,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 7,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 6,
              "searchVolume": 20
            },
            {
              "year": 2025,
              "month": 5,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 4,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 3,
              "searchVolume": 0
            },
            {
              "year": 2025,
              "month": 2,
              "searchVolume": 0
            },
            {
              "year": 2025,
              "month": 1,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 12,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 11,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 10,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 9,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 8,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 7,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 6,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 5,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 4,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 3,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 2,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 1,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 12,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 11,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 10,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 9,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 8,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 7,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 6,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 5,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 4,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 3,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 2,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 1,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 12,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 11,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 10,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 9,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 8,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 7,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 6,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 5,
              "searchVolume": 0
            }
          ],
          "competitionLevel": "HIGH",
          "keywordDifficulty": null,
          "normalizedKeyword": "ugears ugt-24"
        },
        {
          "cpcUsd": null,
          "status": "AVAILABLE",
          "missing": [
            {
              "field": "cpcUsd",
              "reason": "UPSTREAM_FIELD_MISSING"
            },
            {
              "field": "keywordDifficulty",
              "reason": "UPSTREAM_FIELD_MISSING"
            }
          ],
          "inputIndex": 1,
          "competition": 0.6,
          "inputKeyword": "ugears ugt-24 endurance racer",
          "searchVolume": 10,
          "dataUpdatedAt": 1789252407000,
          "monthlySearches": [
            {
              "year": 2026,
              "month": 8,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 7,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 6,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 5,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 4,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 3,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 2,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 1,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 12,
              "searchVolume": 20
            },
            {
              "year": 2025,
              "month": 11,
              "searchVolume": 20
            },
            {
              "year": 2025,
              "month": 10,
              "searchVolume": 20
            },
            {
              "year": 2025,
              "month": 9,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 8,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 7,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 6,
              "searchVolume": 0
            },
            {
              "year": 2025,
              "month": 5,
              "searchVolume": 0
            },
            {
              "year": 2025,
              "month": 4,
              "searchVolume": 0
            },
            {
              "year": 2025,
              "month": 3,
              "searchVolume": 0
            },
            {
              "year": 2025,
              "month": 2,
              "searchVolume": 0
            },
            {
              "year": 2025,
              "month": 1,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 12,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 11,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 10,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 9,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 8,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 7,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 6,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 5,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 4,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 3,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 2,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 1,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 12,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 11,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 10,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 9,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 8,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 7,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 6,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 5,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 4,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 3,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 2,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 1,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 12,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 11,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 10,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 9,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 8,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 7,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 6,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 5,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 4,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 3,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 2,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 1,
              "searchVolume": 0
            },
            {
              "year": 2021,
              "month": 12,
              "searchVolume": 0
            },
            {
              "year": 2021,
              "month": 11,
              "searchVolume": 0
            }
          ],
          "competitionLevel": "MEDIUM",
          "keywordDifficulty": null,
          "normalizedKeyword": "ugears ugt-24 endurance racer"
        }
      ],
      "market": "US",
      "language": "en"
    },
    "source": "dataforseo",
    "status": "SUCCESS",
    "coverage": {
      "status": "PARTIAL",
      "missing": []
    },
    "completedAt": 1790060219463,
    "requestedAt": 1790060218706,
    "schemaVersion": "1.0"
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos