Search Results Rankings

Orgánica histórica SERP Juegos de rol MCP

Orgánica histórica SERP Captura. 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.

CosteEstimated 10 créditos por llamadaPrueba en línea

Prompts y casos de uso de Orgánica histórica SERP Juegos de rol

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. Inspeccionar resultados de búsqueda histórica

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

3. Compara las imágenes de búsqueda observadas

Prompt: Mostrar histórico US Inglés Google orgánico búsqueda instantáneas para [keyword] entre [start date] y [end date]. Conserva cada fecha de observación y las posiciones originales de la clasificación. Volver a 10 resultados en esta solicitud. Partido exacto URLs entre las instantáneas retornadas y los cambios de rango muestran sólo cuando existen ambas observaciones. Conserva las fechas de observación, la consulta corregida y los tipos de resultados; la ausencia en una muestra limitada no demuestra que una página haya dejado de estar indexada.

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.

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_historical_serps

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-historical-serps-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_seo_historical_serps",
    "arguments": {
      "dateFrom": "2026-01-01",
      "dateTo": "2026-01-31",
      "keyword": "nexscope",
      "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
`dateFrom`	`string`	obligatorio	-
`dateTo`	`string`	obligatorio	-
`keyword`	`string`	obligatorio	-
`language`	`string`	opcional	-
`limit`	`integer`	opcional	-
`market`	`string`	opcional	-

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.
`data.result.dateTo`	`string`	obligatorio	Valor de Date to 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.items`	`array`	obligatorio	Valor de Items usado por esta operación de API. Cantidad mínima de elementos: 0 Cantidad máxima de elementos: 31
`data.result.items[]`	`object`	obligatorio	Elemento de data result items.
`data.result.items[].checkUrl`	`string \| null`	obligatorio	Valor de Check url usado por esta operación de API.
`data.result.items[].correctedKeyword`	`string \| null`	obligatorio	Valor de Corrected keyword usado por esta operación de API.
`data.result.items[].correctionType`	`string \| null`	obligatorio	Valor de Correction type usado por esta operación de API. Permitidos: did_you_mean, showing_results_for, no_results_found_for, null
`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[].observedAt`	`integer`	obligatorio	Valor de Observed at usado por esta operación de API. Mínimo: 0
`data.result.items[].observedSerpTypes`	`array`	obligatorio	Valor de Observed serp types usado por esta operación de API. Cantidad mínima de elementos: 0 Cantidad máxima de elementos: 10000
`data.result.items[].observedSerpTypes[]`	`string`	obligatorio	Elemento de data result items[] observedSerpTypes.
`data.result.items[].organicResults`	`array`	obligatorio	Valor de Organic results usado por esta operación de API. Cantidad mínima de elementos: 0 Cantidad máxima de elementos: 20
`data.result.items[].organicResults[]`	`object`	obligatorio	Elemento de data result items[] organicResults.
`data.result.items[].organicResults[].description`	`string \| null`	obligatorio	Valor de Description usado por esta operación de API.
`data.result.items[].organicResults[].missing`	`array`	obligatorio	Valor de Missing usado por esta operación de API. Cantidad mínima de elementos: 0
`data.result.items[].organicResults[].missing[]`	`object`	obligatorio	Elemento de data result items[] organicResults[] missing.
`data.result.items[].organicResults[].missing[].field`	`string`	obligatorio	Valor de Field usado por esta operación de API.
`data.result.items[].organicResults[].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[].organicResults[].rankAbsolute`	`integer \| null`	obligatorio	Valor de Rank absolute usado por esta operación de API. Mínimo: 1
`data.result.items[].organicResults[].rankGroup`	`integer \| null`	obligatorio	Valor de Rank group usado por esta operación de API. Mínimo: 1
`data.result.items[].organicResults[].title`	`string \| null`	obligatorio	Valor de Title usado por esta operación de API.
`data.result.items[].organicResults[].type`	`string`	obligatorio	Valor de Type usado por esta operación de API. Constante: organic
`data.result.items[].organicResults[].url`	`string`	obligatorio	Valor de Url usado por esta operación de API.
`data.result.keyword`	`string`	obligatorio	Valor de Keyword usado por esta operación de API.
`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, UPSTREAM_ITEM_MISSING
`data.result.normalizedKeyword`	`string`	obligatorio	Valor de Normalized keyword usado por esta operación de API.
`data.result.projection`	`string`	obligatorio	Valor de Projection usado por esta operación de API. Constante: organic
`data.result.requestedResultsPerSnapshot`	`integer`	obligatorio	Valor de Requested results per snapshot 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
`data.result.sourceKind`	`string`	obligatorio	Valor de Source kind usado por esta operación de API. Constante: historical_serp_database
`data.result.sourceProduct`	`string`	obligatorio	Valor de Source product usado por esta operación de API. Constante: dataforseo_labs
`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 histórico US Inglés Google orgánico búsqueda instantáneas para silla de camping entre 2026-01-01 y 2026-01-31. Preserve cada fecha de observación y posiciones de clasificación originales. Mostrar hasta 10 resultados.

Explicación ilustrativa de la respuesta

La instantánea ilustrativa está fechada el 1 de enero de 2026, pero no contiene entradas de resultados orgánicos. No hay movimiento de rango para calcular de esta instantánea vacía.

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-historical-serps-example",
  "method": "tools/call",
  "params": {
    "name": "nexscope_seo_historical_serps",
    "arguments": {
      "dateFrom": "2026-01-01",
      "dateTo": "2026-01-31",
      "keyword": "camping chair",
      "language": "en",
      "limit": 10,
      "market": "US"
    }
  }
}

Formato de respuesta MCP

{
  "jsonrpc": "2.0",
  "id": "seo-historical-serps-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\",\"engine\":\"google\",\"items\":[{\"checkUrl\":null,\"correctedKeyword\":null,\"correctionType\":null,\"missing\":[],\"observedAt\":1767225600000,\"observedSerpTypes\":[],\"organicResults\":[]}],\"keyword\":\"camping chair\",\"language\":\"en\",\"market\":\"US\",\"missing\":[],\"normalizedKeyword\":\"camping chair\",\"projection\":\"organic\",\"requestedResultsPerSnapshot\":1,\"returnedCount\":1,\"sourceKind\":\"historical_serp_database\",\"sourceProduct\":\"dataforseo_labs\",\"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",
          "engine": "google",
          "items": [
            {
              "checkUrl": null,
              "correctedKeyword": null,
              "correctionType": null,
              "missing": [],
              "observedAt": 1767225600000,
              "observedSerpTypes": [],
              "organicResults": []
            }
          ],
          "keyword": "camping chair",
          "language": "en",
          "market": "US",
          "missing": [],
          "normalizedKeyword": "camping chair",
          "projection": "organic",
          "requestedResultsPerSnapshot": 1,
          "returnedCount": 1,
          "sourceKind": "historical_serp_database",
          "sourceProduct": "dataforseo_labs",
          "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
  }
}