Pages Websites
Página Datos estructurados MCP
Página Datos estructurados de una muestra de rastreo atado. Devoluciones tipo de evidencia fuente y diagnósticos de campo perdido. La propiedad de la fuente, la versión, el vencimiento y la membresía se verifican cuando se ejecutan. Esta muestra no describe cada página de un sitio web.
Prompts y casos de uso de Página Datos estructurados
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 datos estructurados
Prompt: Inspeccionar los datos estructurados encontrados [page URL] en mi auditoría del sitio web completada [audit reference]. Mostrar los documentos devueltos y el resumen de pruebas sin elegibilidad prometedora de los resultados.
2. Preparar una Lista de Revisión de Datos Estructurados
Prompt: Inspeccionar los datos estructurados encontrados [page URL] en mi auditoría del sitio web completada [audit reference]. Mostrar los documentos devueltos y el resumen de pruebas sin elegibilidad prometedora de los resultados. Grupo devolvió documentos de datos estructurados por formato y tipo, preservando sus campos. Mostrar fatal, error y advertencia cuenta por separado; no inventar mensajes validadores o prometer elegibilidad a ricos resultados.
3. Comparar datos estructurados a través de dos plantillas de página
Prompt: De la auditoría final [audit reference], recuperar datos estructurados [page URL A] y [page URL B] en dos solicitudes. Compare los formatos de documentos devueltos, tipos y nombres de campo junto con sus cuentas de test-summary. Diferencias destacadas para la revisión de plantillas sin inventar requisitos de propiedad perdidos, mensajes de validador detallados o elegibilidad de los resultados ricos.
Qué debes proporcionar
Proporciona la referencia real que devolvió la solicitud de origen en tu cuenta. Una referencia de ejemplo no permite recuperar un resultado real.
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_page_structured_datahttps://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": "page-structured-data-1",
"method": "tools/call",
"params": {
"name": "nexscope_page_structured_data",
"arguments": {
"pageUrl": "https://www.nexscope.ai/",
"task_id": ""
}
}
}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 |
|---|---|---|---|
pageUrl | string | obligatorio | - |
task_id | string | obligatorio | - |
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.coverage | object | obligatorio | Valor de Coverage usado por esta operación de API. |
data.result.coverage.invalidItemCount | integer | obligatorio | Valor de Invalid item count usado por esta operación de API. Mínimo: 0 |
data.result.coverage.limit | integer | obligatorio | Valor de Limit usado por esta operación de API. Mínimo: 0 |
data.result.coverage.maxCrawlPages | integer | null | obligatorio | Valor de Max crawl pages usado por esta operación de API. Mínimo: 0 |
data.result.coverage.offset | integer | obligatorio | Valor de Offset usado por esta operación de API. Mínimo: 0 |
data.result.coverage.pagesCrawled | integer | null | obligatorio | Valor de Pages crawled usado por esta operación de API. Mínimo: 0 |
data.result.coverage.providerTotal | integer | null | obligatorio | Valor de Provider total usado por esta operación de API. Mínimo: 0 |
data.result.coverage.returnedCount | integer | obligatorio | Valor de Returned count usado por esta operación de API. Mínimo: 0 |
data.result.coverage.sampled | boolean | obligatorio | Valor de Sampled usado por esta operación de API. Constante: true |
data.result.coverage.stopReason | string | null | obligatorio | Valor de Stop reason usado por esta operación de API. |
data.result.coverage.truncated | boolean | obligatorio | Valor de Truncated usado por esta operación de API. |
data.result.items | array | obligatorio | Valor de Items usado por esta operación de API. Cantidad máxima de elementos: 1 |
data.result.items[] | object | obligatorio | Elemento de data result items. |
data.result.items[].documents | array | obligatorio | Valor de Documents usado por esta operación de API. Cantidad máxima de elementos: 200 |
data.result.items[].documents[] | object | obligatorio | Elemento de data result items[] documents. |
data.result.items[].documents[].fields | array | obligatorio | Valor de Fields usado por esta operación de API. Cantidad máxima de elementos: 200 |
data.result.items[].documents[].fields[] | object | obligatorio | Elemento de data result items[] documents[] fields. |
data.result.items[].documents[].fields[].children | array | obligatorio | Valor de Children usado por esta operación de API. Cantidad máxima de elementos: 200 |
data.result.items[].documents[].fields[].issues | array | obligatorio | Valor de Issues usado por esta operación de API. Cantidad máxima de elementos: 100 |
data.result.items[].documents[].fields[].issues[] | object | obligatorio | Elemento de data result items[] documents[] fields[] issues. |
data.result.items[].documents[].fields[].issues[].level | string | obligatorio | Valor de Level usado por esta operación de API. Permitidos: fatal, error, warning, info |
data.result.items[].documents[].fields[].issues[].message | string | obligatorio | Valor de Message usado por esta operación de API. Longitud máxima: 4096 |
data.result.items[].documents[].fields[].name | string | obligatorio | Valor de Name usado por esta operación de API. |
data.result.items[].documents[].fields[].types | array | obligatorio | Valor de Types usado por esta operación de API. Cantidad máxima de elementos: 100 |
data.result.items[].documents[].fields[].types[] | string | obligatorio | Elemento de data result items[] documents[] fields[] types. |
data.result.items[].documents[].fields[].values | array | obligatorio | Valor de Values usado por esta operación de API. Cantidad máxima de elementos: 100 |
data.result.items[].documents[].fields[].values[] | any | obligatorio | Elemento de data result items[] documents[] fields[] values. |
data.result.items[].documents[].format | string | obligatorio | Valor de Format usado por esta operación de API. Constante: JSON_LD |
data.result.items[].documents[].types | array | obligatorio | Valor de Types usado por esta operación de API. Cantidad máxima de elementos: 100 |
data.result.items[].documents[].types[] | string | obligatorio | Elemento de data result items[] documents[] types. |
data.result.items[].testSummary | object | obligatorio | Valor de Test summary usado por esta operación de API. |
data.result.items[].testSummary.error | integer | null | obligatorio | Valor de Error usado por esta operación de API. Mínimo: 0 |
data.result.items[].testSummary.fatal | integer | null | obligatorio | Valor de Fatal usado por esta operación de API. Mínimo: 0 |
data.result.items[].testSummary.info | integer | null | obligatorio | Valor de Info usado por esta operación de API. Mínimo: 0 |
data.result.items[].testSummary.warning | integer | null | obligatorio | Valor de Warning usado por esta operación de API. Mínimo: 0 |
data.result.missingFields | array | obligatorio | Valor de Missing fields usado por esta operación de API. Cantidad máxima de elementos: 10000 |
data.result.missingFields[] | object | obligatorio | Elemento de data result missingFields. |
data.result.missingFields[].field | string | obligatorio | Valor de Field usado por esta operación de API. |
data.result.missingFields[].reason | string | obligatorio | Valor de Reason usado por esta operación de API. |
data.result.source | object | obligatorio | Valor de Source usado por esta operación de API. |
data.result.source.candidateId | string | obligatorio | Valor de Candidate id usado por esta operación de API. Constante: MD-PW-13 |
data.result.source.collectedAt | integer | null | obligatorio | Valor de Collected at usado por esta operación de API. Mínimo: 0 Máximo: 9007199254740991 |
data.result.source.observationKind | string | obligatorio | Valor de Observation kind usado por esta operación de API. Constante: CRAWL_SAMPLE |
data.result.source.product | string | obligatorio | Valor de Product usado por esta operación de API. Constante: on_page |
data.result.source.provider | string | obligatorio | Valor de Provider usado por esta operación de API. Constante: DATAFORSEO |
data.result.source.queriedAt | integer | obligatorio | Valor de Queried at usado por esta operación de API. Mínimo: 0 Máximo: 9007199254740991 |
data.result.source.sourceCallId | string | null | obligatorio | Valor de Source call id usado por esta operación de API. |
data.result.source.sourcePlanVersion | string | null | obligatorio | Valor de Source plan version usado por esta operación de API. |
data.result.source.sourceSchemaVersion | string | null | obligatorio | Valor de Source schema version usado por esta operación de API. |
data.result.warnings | array | obligatorio | Valor de Warnings usado por esta operación de API. Cantidad máxima de elementos: 1000 |
data.result.warnings[] | string | obligatorio | Elemento de data result warnings. |
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. |
Opción 1 de una alternativa — requiere kind, value
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.items[].documents[].fields[].values[] | object | obligatorio | Elemento de data result items[] documents[] fields[] values. |
data.result.items[].documents[].fields[].values[].kind | string | obligatorio | Valor de Kind usado por esta operación de API. Constante: STRING |
data.result.items[].documents[].fields[].values[].value | string | obligatorio | Valor de Value usado por esta operación de API. Longitud máxima: 4096 |
Opción 2 de una alternativa — requiere kind, value
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.items[].documents[].fields[].values[] | object | obligatorio | Elemento de data result items[] documents[] fields[] values. |
data.result.items[].documents[].fields[].values[].kind | string | obligatorio | Valor de Kind usado por esta operación de API. Constante: NUMBER |
data.result.items[].documents[].fields[].values[].value | number | obligatorio | Valor de Value usado por esta operación de API. |
Opción 3 de una alternativa — requiere kind, value
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.items[].documents[].fields[].values[] | object | obligatorio | Elemento de data result items[] documents[] fields[] values. |
data.result.items[].documents[].fields[].values[].kind | string | obligatorio | Valor de Kind usado por esta operación de API. Constante: BOOLEAN |
data.result.items[].documents[].fields[].values[].value | boolean | obligatorio | Valor de Value usado por esta operación de API. |
Opción 4 de una alternativa — requiere kind, value
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.items[].documents[].fields[].values[] | object | obligatorio | Elemento de data result items[] documents[] fields[] values. |
data.result.items[].documents[].fields[].values[].kind | string | obligatorio | Valor de Kind usado por esta operación de API. Constante: NULL |
data.result.items[].documents[].fields[].values[].value | null | obligatorio | Valor de Value usado por esta operación de API. |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Examina los datos estructurados encontrados en https://example.com/product durante mi auditoría web finalizada 00000000-0000-4000-8000-000000000001. Muestra los documentos devueltos y el resumen de las pruebas sin prometer que la página cumpla los requisitos para resultados enriquecidos.
Explicación ilustrativa de la respuesta
La respuesta ilustrativa no tiene documentos de datos estructurados devueltos y no cuenta de prueba. No puede establecer si la página es elegible para resultados ricos.
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": "page-structured-data-example",
"method": "tools/call",
"params": {
"name": "nexscope_page_structured_data",
"arguments": {
"pageUrl": "https://example.com/product",
"task_id": "00000000-0000-4000-8000-000000000001"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "page-structured-data-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\":{\"coverage\":{\"invalidItemCount\":0,\"limit\":0,\"maxCrawlPages\":null,\"offset\":0,\"pagesCrawled\":null,\"providerTotal\":null,\"returnedCount\":0,\"sampled\":true,\"stopReason\":null,\"truncated\":false},\"items\":[{\"documents\":[],\"testSummary\":{\"error\":null,\"fatal\":null,\"info\":null,\"warning\":null}}],\"missingFields\":[],\"source\":{\"candidateId\":\"MD-PW-13\",\"collectedAt\":null,\"observationKind\":\"CRAWL_SAMPLE\",\"product\":\"on_page\",\"provider\":\"DATAFORSEO\",\"queriedAt\":0,\"sourceCallId\":null,\"sourcePlanVersion\":null,\"sourceSchemaVersion\":null},\"warnings\":[]},\"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": {
"coverage": {
"invalidItemCount": 0,
"limit": 0,
"maxCrawlPages": null,
"offset": 0,
"pagesCrawled": null,
"providerTotal": null,
"returnedCount": 0,
"sampled": true,
"stopReason": null,
"truncated": false
},
"items": [
{
"documents": [],
"testSummary": {
"error": null,
"fatal": null,
"info": null,
"warning": null
}
}
],
"missingFields": [],
"source": {
"candidateId": "MD-PW-13",
"collectedAt": null,
"observationKind": "CRAWL_SAMPLE",
"product": "on_page",
"provider": "DATAFORSEO",
"queriedAt": 0,
"sourceCallId": null,
"sourcePlanVersion": null,
"sourceSchemaVersion": null
},
"warnings": []
},
"schemaVersion": "1.0",
"source": "dataforseo",
"status": "PARTIAL",
"usage": null
},
"msg": null,
"time": "2026-01-01 00:00:01",
"traceId": null,
"ts": "1767225601000"
},
"isError": false
}
}