Search Results Rankings
Ofertas del vendedor de compras MCP
El vendedor de Google Compras de código fuente ofrece precios observados y evidencia explícita faltante. Un envío y al menos ocho lecturas fijas. Los valores ausentes no son cero. Los precios y la publicación no se aprueban. 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.
Prompts y casos de uso de Ofertas del vendedor de compras
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. Comparación de Ofertas de Vendedor de Compras
Prompt: Usando mi referencia de búsqueda completa [search reference] y su referencia al producto devuelto [product reference], comparar ofertas de vendedor. Mantenga el precio base, envío, impuesto y total separado cuando esté disponible. Volver a 10 resultados en esta solicitud.
2. Revise una muestra de resultados más pequeña
Prompt: Usando mi referencia de búsqueda completa [search reference] y su referencia al producto devuelto [product reference], comparar ofertas de vendedor. Mantenga el precio base, envío, impuesto y total separado cuando esté disponible. Limitar el examen [number of results, at most 10] e identificar si la muestra devuelta es incompleta.
3. Comparar Totalmente reportado Oferta Total
Prompt: Usando mi referencia de búsqueda completa [search reference] y su referencia al producto devuelto [product reference], comparar ofertas de vendedor. Mantenga el precio base, envío, impuesto y total separado cuando esté disponible. Volver a 10 resultados en esta solicitud. Dentro de cada moneda, las ofertas de rango con los precios totales devueltos al mostrar el precio base, el envío y el impuesto por separado. Dejar los totales incompletos sin cobrar y no suponer que las tarifas faltantes son cero o los precios de instalación son precios de compra completos.
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.
Una tarea presentada no es un resultado completo. Mantenga su referencia y compruebe la terminación antes de resumir la salida; no cree trabajos duplicados.
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_shopping_seller_offershttps://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-shopping-seller-offers-1",
"method": "tools/call",
"params": {
"name": "nexscope_seo_shopping_seller_offers",
"arguments": {
"limit": 10,
"productRef": "",
"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.
Flujo de tareas asíncronas
- 1. Crear una sola vez
Conserva el taskId devuelto.
- 2. Consultar con espera progresiva
Usa nexscope_media_task_result después de 5 segundos y luego de 10, 20 y 30 segundos.
- 3. Usar el resultado final
Detén las consultas al obtener éxito, fallo o tiempo de espera agotado.
{
"jsonrpc": "2.0",
"id": "seo-shopping-seller-offers-result-1",
"method": "tools/call",
"params": {
"name": "nexscope_media_task_result",
"arguments": {
"skillSlug": "seo-shopping-seller-offers",
"taskId": "TASK_ID_FROM_THE_GENERATION_RESULT"
}
}
}Argumentos
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | integer | opcional | - |
productRef | 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.meta | object | obligatorio | Valor de Meta usado por esta operación de API. |
data.result.meta.market | object | obligatorio | Valor de Market usado por esta operación de API. |
data.result.meta.market.country | string | obligatorio | Valor de Country usado por esta operación de API. Constante: US |
data.result.meta.market.language | string | obligatorio | Valor de Language usado por esta operación de API. Constante: en |
data.result.meta.market.locationCode | integer | obligatorio | Valor de Location code usado por esta operación de API. Constante: 2840 |
data.result.meta.missing | array | obligatorio | Valor de Missing usado por esta operación de API. Cantidad máxima de elementos: 100 |
data.result.meta.missing[] | object | obligatorio | Elemento de data result meta missing. |
data.result.meta.missing[].path | string | obligatorio | Valor de Path usado por esta operación de API. Longitud máxima: 256 |
data.result.meta.missing[].reason | string | obligatorio | Valor de Reason usado por esta operación de API. Permitidos: MISSING, NULL, INVALID, UNSUPPORTED, TRUNCATED |
data.result.meta.missingOverflow | boolean | obligatorio | Valor de Missing overflow usado por esta operación de API. |
data.result.meta.retrievedAt | any | obligatorio | Valor de Retrieved at usado por esta operación de API. |
data.result.meta.sampledAt | any | obligatorio | Valor de Sampled at usado por esta operación de API. |
data.result.meta.source | string | obligatorio | Valor de Source usado por esta operación de API. Constante: DATAFORSEO_GOOGLE_SHOPPING_SELLERS |
data.result.meta.truncated | boolean | obligatorio | Valor de Truncated usado por esta operación de API. |
data.result.offers | array | obligatorio | Valor de Offers usado por esta operación de API. Cantidad máxima de elementos: 10 |
data.result.offers[] | object | obligatorio | Elemento de data result offers. |
data.result.offers[].basePrice | any | obligatorio | Valor de Base price usado por esta operación de API. |
data.result.offers[].currency | any | obligatorio | Valor de Currency usado por esta operación de API. |
data.result.offers[].details | any | obligatorio | Valor de Details usado por esta operación de API. |
data.result.offers[].domain | any | obligatorio | Valor de Domain usado por esta operación de API. |
data.result.offers[].installmentMonths | any | obligatorio | Valor de Installment months usado por esta operación de API. |
data.result.offers[].paymentBreakdown | any | obligatorio | Valor de Payment breakdown usado por esta operación de API. |
data.result.offers[].rankAbsolute | any | obligatorio | Valor de Rank absolute usado por esta operación de API. |
data.result.offers[].rankGroup | any | obligatorio | Valor de Rank group usado por esta operación de API. |
data.result.offers[].sellerName | any | obligatorio | Valor de Seller name usado por esta operación de API. |
data.result.offers[].shippingPrice | any | obligatorio | Valor de Shipping price usado por esta operación de API. |
data.result.offers[].tax | any | obligatorio | Valor de Tax usado por esta operación de API. |
data.result.offers[].title | any | obligatorio | Valor de Title usado por esta operación de API. |
data.result.offers[].totalPrice | any | obligatorio | Valor de Total price usado por esta operación de API. |
data.result.offers[].url | any | obligatorio | Valor de Url usado por esta operación de API. |
data.result.productRef | string | obligatorio | Valor de Product ref usado por esta operación de API. Patrón: ^[0-9a-f]{64}$ |
data.result.sourceCallId | string | obligatorio | Valor de Source call id usado por esta operación de API. Formato: uuid |
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 cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.meta.retrievedAt | integer | obligatorio | Valor de Retrieved at usado por esta operación de API. Mínimo: 0 Máximo: 9007199254740991 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.meta.retrievedAt | null | obligatorio | Valor de Retrieved at usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.meta.sampledAt | integer | obligatorio | Valor de Sampled at usado por esta operación de API. Mínimo: 0 Máximo: 9007199254740991 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.meta.sampledAt | null | obligatorio | Valor de Sampled at usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].basePrice | number | obligatorio | Valor de Base price usado por esta operación de API. Mínimo: 0 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].basePrice | null | obligatorio | Valor de Base price usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].currency | string | obligatorio | Valor de Currency usado por esta operación de API. Patrón: ^[A-Z]{3}$ |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].currency | null | obligatorio | Valor de Currency usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].details | string | obligatorio | Valor de Details usado por esta operación de API. Longitud máxima: 8192 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].details | null | obligatorio | Valor de Details usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].domain | string | obligatorio | Valor de Domain usado por esta operación de API. Longitud máxima: 1024 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].domain | null | obligatorio | Valor de Domain usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].installmentMonths | integer | obligatorio | Valor de Installment months usado por esta operación de API. Mínimo: 0 Máximo: 9007199254740991 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].installmentMonths | null | obligatorio | Valor de Installment months usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].paymentBreakdown | string | obligatorio | Valor de Payment breakdown usado por esta operación de API. Longitud máxima: 8192 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].paymentBreakdown | null | obligatorio | Valor de Payment breakdown usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].rankAbsolute | integer | obligatorio | Valor de Rank absolute usado por esta operación de API. Mínimo: 0 Máximo: 9007199254740991 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].rankAbsolute | null | obligatorio | Valor de Rank absolute usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].rankGroup | integer | obligatorio | Valor de Rank group usado por esta operación de API. Mínimo: 0 Máximo: 9007199254740991 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].rankGroup | null | obligatorio | Valor de Rank group usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].sellerName | string | obligatorio | Valor de Seller name usado por esta operación de API. Longitud máxima: 1024 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].sellerName | null | obligatorio | Valor de Seller name usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].shippingPrice | number | obligatorio | Valor de Shipping price usado por esta operación de API. Mínimo: 0 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].shippingPrice | null | obligatorio | Valor de Shipping price usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].tax | number | obligatorio | Valor de Tax usado por esta operación de API. Mínimo: 0 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].tax | null | obligatorio | Valor de Tax usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].title | string | obligatorio | Valor de Title usado por esta operación de API. Longitud máxima: 1024 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].title | null | obligatorio | Valor de Title usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].totalPrice | number | obligatorio | Valor de Total price usado por esta operación de API. Mínimo: 0 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].totalPrice | null | obligatorio | Valor de Total price usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].url | string | obligatorio | Valor de Url usado por esta operación de API. Longitud máxima: 4096 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result.offers[].url | null | obligatorio | Valor de Url 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
Usa mi referencia de búsqueda de compras finalizada 00000000-0000-4000-8000-000000000001 y la referencia de producto devuelta aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa para comparar las ofertas de los vendedores. Distingue el precio base, el envío, los impuestos y el total cuando estén disponibles. Muestra como máximo 10 resultados.
Explicación ilustrativa de la respuesta
Las listas de oferta ilustrativa USD 29.99 precio básico y USD 5 envíos. El impuesto y el precio total faltan, por lo que USD 34.99 no debe presentarse como un total pagadero final.
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-shopping-seller-offers-example",
"method": "tools/call",
"params": {
"name": "nexscope_seo_shopping_seller_offers",
"arguments": {
"limit": 10,
"productRef": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "00000000-0000-4000-8000-000000000001"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "seo-shopping-seller-offers-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\":{\"meta\":{\"market\":{\"country\":\"US\",\"language\":\"en\",\"locationCode\":2840},\"missing\":[],\"missingOverflow\":false,\"retrievedAt\":1767225600000,\"sampledAt\":1767225600000,\"source\":\"DATAFORSEO_GOOGLE_SHOPPING_SELLERS\",\"truncated\":false},\"offers\":[{\"basePrice\":29.99,\"currency\":\"USD\",\"details\":null,\"domain\":null,\"installmentMonths\":null,\"paymentBreakdown\":null,\"rankAbsolute\":null,\"rankGroup\":null,\"sellerName\":\"Example Seller\",\"shippingPrice\":5,\"tax\":null,\"title\":\"Example camping chair\",\"totalPrice\":null,\"url\":null}],\"productRef\":\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"sourceCallId\":\"00000000-0000-4000-8000-000000000001\"},\"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": {
"meta": {
"market": {
"country": "US",
"language": "en",
"locationCode": 2840
},
"missing": [],
"missingOverflow": false,
"retrievedAt": 1767225600000,
"sampledAt": 1767225600000,
"source": "DATAFORSEO_GOOGLE_SHOPPING_SELLERS",
"truncated": false
},
"offers": [
{
"basePrice": 29.99,
"currency": "USD",
"details": null,
"domain": null,
"installmentMonths": null,
"paymentBreakdown": null,
"rankAbsolute": null,
"rankGroup": null,
"sellerName": "Example Seller",
"shippingPrice": 5,
"tax": null,
"title": "Example camping chair",
"totalPrice": null,
"url": null
}
],
"productRef": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"sourceCallId": "00000000-0000-4000-8000-000000000001"
},
"schemaVersion": "1.0",
"source": "dataforseo",
"status": "PARTIAL",
"usage": null
},
"msg": null,
"time": "2026-01-01 00:00:01",
"traceId": null,
"ts": "1767225601000"
},
"isError": false
}
}