Keywords Trends
Palabras clave Interés por Región MCP
Nexscope Tendencias relativa interés de palabra clave en todas las regiones de los Estados Unidos. Las puntuaciones regionales son índices relativos, no porcentajes de países o recuentos absolutos de búsqueda. Región proveedora de Preserve IDs.
Prompts y casos de uso de Palabras clave Interés por Región
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. Comparar intereses de búsqueda regional
Prompt: Mostrar regional US búsqueda de interés [up to five keywords] desde [start date] a través de [end date]. Señala los datos regionales ausentes y conserva la escala de interés relativo.
2. Seleccionar regiones para investigar
Prompt: Mostrar regional US búsqueda de interés [up to five keywords] desde [start date] a través de [end date]. Señala los datos regionales ausentes y conserva la escala de interés relativo. Dentro de cada palabra clave, orden devuelto regiones por interés, preservando geográficamente IDs y etiquetas. No compare por separado serie normalizada como demanda absoluta o trate regiones ausentes como demanda cero.
3. Encontrar regiones compartidas por varias listas de palabras clave
Prompt: Consulta el interés regional de búsqueda en EE. UU. para [two to five keywords] sobre [start date] a [end date], dentro de 366 días. Para cada palabra clave, seleccione su parte superior [number] regiones devueltas, conservando lazos, identificando la superposición geográfica IDs en esas listas. No resumir los puntos de interés normalizados por separado o inferir la demanda de población de las regiones desaparecidas.
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/jsonAutenticació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
nexscope_seo_keyword_interest_regionshttps://api.nexscope.ai/mcptools/callInicializa 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-regions-1",
"method": "tools/call",
"params": {
"name": "nexscope_seo_keyword_interest_regions",
"arguments": {
"dateFrom": "2026-01-01",
"dateTo": "2026-01-31",
"keywords": [
"nexscope"
],
"market": "US"
}
}
}MCP 2025-11-25 · Streamable HTTPLa 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[].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.items[].regions | array | obligatorio | Valor de Regions usado por esta operación de API. Cantidad mínima de elementos: 0 Cantidad máxima de elementos: 300 |
data.result.items[].regions[] | object | obligatorio | Elemento de data result items[] regions. |
data.result.items[].regions[].geoId | string | null | obligatorio | Valor de Geo id usado por esta operación de API. |
data.result.items[].regions[].geoName | string | null | obligatorio | Valor de Geo name usado por esta operación de API. |
data.result.items[].regions[].interest | integer | null | obligatorio | Valor de Interest usado por esta operación de API. Mínimo: 0 Máximo: 100 |
data.result.items[].regions[].missing | array | obligatorio | Valor de Missing usado por esta operación de API. Cantidad mínima de elementos: 0 |
data.result.items[].regions[].missing[] | object | obligatorio | Elemento de data result items[] regions[] missing. |
data.result.items[].regions[].missing[].field | string | obligatorio | Valor de Field usado por esta operación de API. |
data.result.items[].regions[].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_region_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. |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Mostrar regional US buscar interés para la silla de camping de 2026-01-01 a 2026-01-31. Preserve evidencia regional desaparecida y la escala relativa-interés.
Explicación ilustrativa de la respuesta
La respuesta ilustrativa identifica la palabra clave pero no devuelve observaciones regionales. No puede establecer la región más interesada o una cuota de demanda geográfica.
Sobre esta muestra: Ejemplo ilustrativo con datos ficticios; no procede de una llamada real. Los dominios y referencias reservados solo muestran el formato y no prueban resultados actuales. Un campo nulo indica que no hay datos disponibles, no que su valor sea cero.
No hay datos de ejemplo publicados para esta página. Una ilustración del formato o una guía de flujo de trabajo no sustituye un resultado publicado.
Ver el formato de solicitud y respuesta MCP
Ejemplos
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
La estructura JSON-RPC siguiente muestra cómo se presentan en MCP los argumentos y los datos indicados. No procede de una captura de tráfico ni demuestra que la llamada se haya completado. Los ejemplos de flujo de trabajo no muestran un resultado.
Solicitud MCP
{
"jsonrpc": "2.0",
"id": "seo-keyword-interest-regions-example",
"method": "tools/call",
"params": {
"name": "nexscope_seo_keyword_interest_regions",
"arguments": {
"dateFrom": "2026-01-01",
"dateTo": "2026-01-31",
"keywords": [
"camping chair"
],
"market": "US"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "seo-keyword-interest-regions-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"cost\":\"-1\",\"data\":{\"callId\":\"00000000-0000-4000-8000-000000000001\",\"completedAt\":\"1767225601000\",\"coverage\":{\"missing\":[],\"status\":\"PARTIAL\"},\"requestedAt\":\"1767225600000\",\"result\":{\"dateFrom\":\"2026-01-01\",\"dateTo\":\"2026-01-31\",\"inputKeywords\":[\"camping chair\"],\"items\":[{\"keyword\":\"camping chair\",\"missing\":[],\"regions\":[]}],\"languageFilter\":null,\"marketScope\":\"US\",\"missing\":[],\"normalizedKeywords\":[\"camping chair\"],\"returnedCount\":1,\"sourceKind\":\"dataforseo_trends_region_relative\",\"sourceProduct\":\"keywords_data\",\"truncated\":false},\"schemaVersion\":\"1.0\",\"source\":\"dataforseo\",\"status\":\"PARTIAL\",\"usage\":null},\"msg\":null,\"time\":\"2026-01-01 00:00:01\",\"traceId\":null,\"ts\":\"1767225601000\"}"
}
],
"structuredContent": {
"code": 0,
"cost": "-1",
"data": {
"callId": "00000000-0000-4000-8000-000000000001",
"completedAt": "1767225601000",
"coverage": {
"missing": [],
"status": "PARTIAL"
},
"requestedAt": "1767225600000",
"result": {
"dateFrom": "2026-01-01",
"dateTo": "2026-01-31",
"inputKeywords": [
"camping chair"
],
"items": [
{
"keyword": "camping chair",
"missing": [],
"regions": []
}
],
"languageFilter": null,
"marketScope": "US",
"missing": [],
"normalizedKeywords": [
"camping chair"
],
"returnedCount": 1,
"sourceKind": "dataforseo_trends_region_relative",
"sourceProduct": "keywords_data",
"truncated": false
},
"schemaVersion": "1.0",
"source": "dataforseo",
"status": "PARTIAL",
"usage": null
},
"msg": null,
"time": "2026-01-01 00:00:01",
"traceId": null,
"ts": "1767225601000"
},
"isError": false
}
}