Investigación de productos de Walmart
API de detalles de productos de Walmart MCP
Busque detalles de productos Walmart, historial de precios y tendencias de ventas. Llame al detalle del producto Walmart API mediante REST o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de detalles de productos de Walmart
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. Vea los detalles del producto Walmart, historial de precios y tendencias de ventas
Prompt: Busca producto Walmart [product ID] sin solicitar las estadísticas opcionales. Resume los detalles actuales del anuncio devuelto y señala los campos ausentes.
2. Incluir estadísticas de productos
Prompt: Buscar detalles de productos Walmart, historia de precios y tendencias de ventas [product ID]. Incluir las estadísticas de productos ampliados disponibles. Informe sólo lo que los registros seleccionados soportan.
3. Revisión de precios e historia de ventas
Prompt: Buscar detalles de productos Walmart, historia de precios y tendencias de ventas [product ID]. Incluir las estadísticas de productos ampliados disponibles. Informe sólo lo que los registros seleccionados soportan. Presentar las estadísticas de precios y ventas devueltos utilizando sus fechas y unidades reales. No rellenar la historia perdida o inferir que un cambio de precio causó ventas.
4. Revisión Contenido y Disponibilidad Gaps
Prompt: Busca producto Walmart [product ID] sin solicitar las estadísticas opcionales. Resume los detalles actuales del anuncio devuelto y señala los campos ausentes. Inspeccione el título, descripción, imágenes, contenido y puntuaciones de listado, estado de stock y cumplimiento. Tratar puntuaciones como indicadores fuente, no prueba que un listado cumple con cada regla de mercado.
Qué debes proporcionar
Sustituye las entradas entre corchetes por tus propios valores. Usa únicamente los mercados, períodos y formatos de entrada documentados.
Las estimaciones y clasificaciones devueltas corresponden a los datos y al período seleccionados. Un valor ausente no equivale a cero y una página de resultados no representa todo el mercado.
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_walmart_product_detailhttps://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": "walmart-product-detail-1",
"method": "tools/call",
"params": {
"name": "nexscope_walmart_product_detail",
"arguments": {
"includeStats": true,
"productId": "5169493923"
}
}
}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 |
|---|---|---|---|
productId | integer | obligatorio | Producto ID (ItemId), la numérica ID contenido en el enlace de detalles del producto. Por ejemplo: el 5169493923 en https://www.walmart.com/ip/5169493923 |
includeStats | boolean | opcional | Ya sea para incluir el histórico price/historical ventas, por defecto verdadera Ejemplo: true |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | string | opcional | Código de devolución; `"200"` indica éxito. |
msg | string | opcional | Mensaje; `"ok"` sobre el éxito, descripción de errores en el fracaso. |
total | integer | opcional | La cantidad de bienes devueltos es generalmente 1 para esta interfaz. |
products | array | opcional | Lista de productos, campos de elementos se muestran en la tabla siguiente. |
columns | array | opcional | Definición de columna, describiendo la meta información de cada campo en `products`, incluido `field`, `title`, `cellType`, etc. |
type | string | opcional | Tipo de respuesta, valor fijo `"productWorkbenches"`. |
costTime | integer | opcional | La interfaz lleva tiempo en milisegundos. |
costToken | integer | opcional | El número de fichas consumidas. |
usItemId | integer | opcional | El producto interno ID, que es `productId` en la solicitud. |
productId | string | opcional | Un identificador único para el producto Walmart, que puede ser una cadena alfanumérica. |
title | string | opcional | Nombre del producto. |
description | string | opcional | Descripción del producto. |
price | number | opcional | Precio de venta actual en US dólares. |
wasPrice | number/null | opcional | Precio acelerado en USD; puede ser `null` sin descuento. |
minPrice | number | opcional | Precio más bajo en USD. |
brand | string | opcional | Nombre de marca. |
rating | number | opcional | Valoración de producto, desde 0.0-5.0. |
reviews | integer | opcional | Número de comentarios. |
salesEstimate | integer | opcional | Estimación del volumen de ventas para el ciclo reciente, en unidades. |
revenue | number | opcional | Estimaciones de ingresos U.SDólares. |
sellerName | string | opcional | Nombre del vendedor. |
fulfillmentType | string | opcional | Tipo de envío: `MARKETPLACE` (llenado por terceros vendedor) o `WFS` (Walmart Fulfillment Services). |
productPageUrl | string | opcional | Página de producto URL. |
imageUrl | string | opcional | Imagen del producto URL (thumbnail). |
departmentName | string | opcional | El nombre del departamento al que perteneces. |
departmentId | integer | opcional | Departamento ID. |
listingScore | integer | opcional | Lista de puntuación de calidad. |
contentScore | integer | opcional | Puntos de calidad de contenido. |
outOfStock | integer | opcional | Ya sea que no esté disponible: `0`=en stock, `1`Sin stock. |
sponsored | integer | opcional | Ya sea para anunciar productos: `0`=No, `1`Sí. |
isBranded | integer | opcional | Ya sea un producto de marca: `0`=No, `1`Sí. |
multipleOptionsAvailable | integer | opcional | Hay variaciones: `0`=No, `1`Sí. |
createdAt | string | opcional | ws Primer tiempo de colección, en el formato de `yyyy-MM-dd'T'HH:mm:ss.SSSSSS'Z'`. |
updatedAt | string | opcional | El último tiempo de actualización de datos, el formato es el mismo que el anterior. |
stats | object/null | opcional | Estadísticas históricas; devueltas si `includeStats=true`, de lo contrario `null`. |
sourceType | string | opcional | Plataforma fuente de producto, valor fijo `"walmart"`. |
stats.price | array | opcional | Serie histórica de tiempo de venta de precios, ordenados por fecha en orden ascendente. |
stats.sales | array | opcional | Serie de tiempo de ventas históricas, ordenados por fecha en orden ascendente. |
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
Busque detalles de productos Walmart, historial de precios y tendencias de ventas. Uso del producto ID 17815415970.
Respuesta de ejemplo
En la muestra publicada, el primer registro mostrado es “Acer Nitro V 16 ANV16S-41-R2AJ Gaming Laptop 16" WQXGA 165Hz AMD Ryzen 7 260 NVIDIA GeForce RTX 5060 16GB RAM 1TB SSD. Su precio comunicado es 1559.99. Sus ingresos notificados son 26519.83. Estas observaciones se aplican únicamente al ámbito de registro y presentación de informes mostrados.
Sobre esta muestra: Extracto de la documentación publicada, no de una consulta en vivo. Las listas muestran como máximo dos registros y algunos textos largos pueden estar abreviados. Si faltan unidades, fechas o datos sobre la cobertura, el extracto no permite determinarlos ni representa el conjunto de datos completo. El MCP la solicitud representa el mismo identificador de producto como un entero, como exige su esquema; el original REST muestra lo representa como una cadena de dígitos.
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
{
"productId": "17815415970",
"includeStats": true
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"total": 1,
"costTime": 924,
"columns": [
{
"filterable": true,
"cellType": "number",
"field": "usItemId",
"sortable": true,
"title": "商品内部ID"
},
{
"filterable": true,
"cellType": "text",
"field": "productId",
"sortable": true,
"title": "Walmart商品ID"
},
{
"filterable": true,
"cellType": "number",
"field": "departmentId",
"sortable": true,
"title": "所属部门ID"
},
{
"filterable": true,
"cellType": "text",
"field": "departmentName",
"sortable": true,
"title": "所属部门名称"
},
{
"filterable": true,
"cellType": "text",
"field": "productPageUrl",
"sortable": true,
"title": "商品页面URL"
},
{
"filterable": true,
"cellType": "text",
"field": "imageUrl",
"sortable": true,
"title": "商品图片URL"
},
{
"filterable": true,
"cellType": "text",
"field": "title",
"sortable": true,
"title": "商品名称"
},
{
"filterable": true,
"cellType": "text",
"field": "description",
"sortable": true,
"title": "商品描述"
},
{
"filterable": true,
"cellType": "number",
"field": "price",
"sortable": true,
"title": "当前售价（美元）"
},
{
"filterable": true,
"cellType": "number",
"field": "wasPrice",
"sortable": true,
"title": "划线价（美元）"
},
{
"filterable": true,
"cellType": "number",
"field": "minPrice",
"sortable": true,
"title": "最低价格（美元）"
},
{
"filterable": true,
"cellType": "number",
"field": "rating",
"sortable": true,
"title": "商品评分"
},
{
"filterable": true,
"cellType": "number",
"field": "reviews",
"sortable": true,
"title": "评论数量（条）"
},
{
"filterable": true,
"cellType": "number",
"field": "outOfStock",
"sortable": true,
"title": "是否缺货"
},
{
"filterable": true,
"cellType": "number",
"field": "sponsored",
"sortable": true,
"title": "是否广告商品"
},
{
"filterable": true,
"cellType": "number",
"field": "isBranded",
"sortable": true,
"title": "是否品牌商品"
},
{
"filterable": true,
"cellType": "number",
"field": "multipleOptionsAvailable",
"sortable": true,
"title": "是否有变体"
},
{
"filterable": true,
"cellType": "text",
"field": "fulfillmentType",
"sortable": true,
"title": "配送类型"
},
{
"filterable": true,
"cellType": "text",
"field": "brand",
"sortable": true,
"title": "品牌名称"
},
{
"filterable": true,
"cellType": "text",
"field": "sellerName",
"sortable": true,
"title": "卖家名称"
},
{
"filterable": true,
"cellType": "number",
"field": "salesEstimate",
"sortable": true,
"title": "销量估算（件）"
},
{
"filterable": true,
"cellType": "number",
"field": "revenue",
"sortable": true,
"title": "收入估算（美元）"
},
{
"filterable": true,
"cellType": "number",
"field": "contentScore",
"sortable": true,
"title": "内容质量分"
},
{
"filterable": true,
"cellType": "number",
"field": "listingScore",
"sortable": true,
"title": "Listing评分"
},
{
"filterable": true,
"cellType": "text",
"field": "createdAt",
"sortable": true,
"title": "创建时间(yyyy-MM-dd'T'HH:mm:ss"
},
{
"filterable": true,
"cellType": "text",
"field": "updatedAt",
"sortable": true,
"title": "更新时间(yyyy-MM-dd'T'HH:mm:ss"
},
{
"filterable": true,
"cellType": "text",
"field": "stats",
"sortable": true,
"title": "历史统计数据（按天，UTC，按时间升序）"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceType",
"sortable": true,
"title": "商品来源"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceTool",
"sortable": true,
"title": "来源工具"
}
],
"type": "productWorkbenches",
"products": [
{
"departmentName": "Electronics",
"productId": "2VH6SH3M6F3P",
"listingScore": 56,
"departmentId": 10,
"sellerName": "DemProductSales",
"description": "The Acer Nitro V 16 ANV16S-41-R2AJ is a state-of-the-art AI gaming laptop designed to provide a competitive edge through advanced processing and brilliant visuals. At its core, the AMD Ryzen 7 260 processor features a sophisticated multi-core architecture with a dedicated NPU for localized AI acceleration, ensuring peak efficiency during intense gaming and creative multitasking. Graphical superiority is delivered by the NVIDIA GeForce RTX 5060 Laptop GPU, which utilizes the latest Blackwell architecture and 8GB of dedicated GDDR7 VRAM to produce lifelike ray-traced environments and AI-enhanced DLSS 4 frame rates. The expansive 16-inch WQXGA display features a 165Hz refresh rate and a 16:10 aspect ratio, providing ultra-smooth motion and expanded vertical screen real estate. Equipped with 16GB of high-speed DDR5 RAM and a massive 1TB PCIe Gen 4 SSD, this machine offers lightning-fast responsiveness and ample storage. The sophisticated dual-fan cooling system and NitroSense software maintain system stability in a sleek Obsidian Black chassis.",
"sponsored": 0,
"title": "Acer Nitro V 16 ANV16S-41-R2AJ Gaming Laptop 16\" WQXGA 165Hz AMD Ryzen 7 260 NVIDIA GeForce RTX 5060 16GB RAM 1TB SSD",
"productPageUrl": "https://www.walmart.com/ip/Acer-Nitro-V-16S-AI-16-Gaming-Laptop-AMD-Ryzen-7-260-NVIDIA-GeForce-RTX-5060-8-GB-1TB-SSD-Windows-11-Home-ANV16S-41-R2AJ/17815415970?classType=REGULAR",
"createdAt": "2026-05-01T20:36:45.000000Z",
"revenue": 26519.83,
"sourceTool": "WallySmarter商品详情",
"stats": {
"price": [
{
"2026-05-04": 1559.99
},
{
"2026-05-18": 1559.99
},
{
"2026-06-01": 1559.99
},
{
"2026-06-15": 1559.99
},
{
"2026-06-29": 1559.99
},
{
"2026-07-13": 1559.99
},
{
"2026-07-20": 1559.99
},
{
"2026-08-03": 1559.99
},
{
"2026-08-24": 1559.99
},
{
"2026-08-31": 1559.99
},
{
"2026-09-21": 1559.99
}
],
"sales": [
{
"2026-05-04": 1
},
{
"2026-05-18": 2
},
{
"2026-06-01": 3
},
{
"2026-06-15": 5
},
{
"2026-06-29": 5
},
{
"2026-07-13": 4
},
{
"2026-07-20": 17
},
{
"2026-08-03": 12
},
{
"2026-08-24": 14
},
{
"2026-08-31": 17
},
{
"2026-09-21": 17
}
]
},
"sourceType": "walmart",
"usItemId": "17815415970",
"price": 1559.99,
"imageUrl": "https://i5.walmartimages.com/seo/Acer-Nitro-V-16S-AI-16-Gaming-Laptop-AMD-Ryzen-7-260-NVIDIA-GeForce-RTX-5060-8-GB-1TB-SSD-Windows-11-Home-ANV16S-41-R2AJ_3a6459a2-ca38-4fe9-9a3a-f25b5d74aa69.deba93f713d196d0dc94d10beb49f900.jpeg",
"outOfStock": 0,
"isBranded": 0,
"contentScore": 67,
"multipleOptionsAvailable": 0,
"brand": "Acer",
"salesEstimate": 17,
"updatedAt": "2026-09-21T00:00:00.000000Z"
}
]
}
}Ver el formato de solicitud y respuesta MCP
Ejemplos
Se basa en una muestra de la documentación publicada, no en 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": "walmart-product-detail-example",
"method": "tools/call",
"params": {
"name": "nexscope_walmart_product_detail",
"arguments": {
"productId": 17815415970,
"includeStats": true
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "walmart-product-detail-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"products\":[{\"title\":\"Acer Nitro V 16 ANV16S-41-R2AJ Gaming Laptop 16\\\" WQXGA 165Hz AMD Ryzen 7 260 NVIDIA GeForce RTX 5060 16GB RAM 1TB SSD\",\"productId\":\"2VH6SH3M6F3P\",\"price\":1559.99,\"revenue\":26519.83,\"departmentName\":\"Electronics\",\"listingScore\":56,\"departmentId\":10,\"sellerName\":\"DemProductSales\",\"description\":\"The Acer Nitro V 16 ANV16S-41-R2AJ is a state-of-the-art AI gaming laptop designed to provide a competitive edge through advanced processing and brilliant visuals. At its core, the AMD Ryzen 7 260 processor features a sophisticated multi-core architecture with a dedicated NPU for localized AI acceleration, ensuring peak efficiency during intense gaming and creative multitasking. Graphical superior…\",\"sponsored\":0,\"productPageUrl\":\"https://www.walmart.com/ip/Acer-Nitro-V-16S-AI-16-Gaming-Laptop-AMD-Ryzen-7-260-NVIDIA-GeForce-RTX-5060-8-GB-1TB-SSD-Windows-11-Home-ANV16S-41-R2AJ/17815415970?classType=REGULAR\",\"createdAt\":\"2026-05-01T20:36:45.000000Z\"}],\"total\":1}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"products": [
{
"title": "Acer Nitro V 16 ANV16S-41-R2AJ Gaming Laptop 16\" WQXGA 165Hz AMD Ryzen 7 260 NVIDIA GeForce RTX 5060 16GB RAM 1TB SSD",
"productId": "2VH6SH3M6F3P",
"price": 1559.99,
"revenue": 26519.83,
"departmentName": "Electronics",
"listingScore": 56,
"departmentId": 10,
"sellerName": "DemProductSales",
"description": "The Acer Nitro V 16 ANV16S-41-R2AJ is a state-of-the-art AI gaming laptop designed to provide a competitive edge through advanced processing and brilliant visuals. At its core, the AMD Ryzen 7 260 processor features a sophisticated multi-core architecture with a dedicated NPU for localized AI acceleration, ensuring peak efficiency during intense gaming and creative multitasking. Graphical superior…",
"sponsored": 0,
"productPageUrl": "https://www.walmart.com/ip/Acer-Nitro-V-16S-AI-16-Gaming-Laptop-AMD-Ryzen-7-260-NVIDIA-GeForce-RTX-5060-8-GB-1TB-SSD-Windows-11-Home-ANV16S-41-R2AJ/17815415970?classType=REGULAR",
"createdAt": "2026-05-01T20:36:45.000000Z"
}
],
"total": 1
}
},
"isError": false
}
}