Inteligencia de Walmart ST
API de análisis de productos de Walmart MCP
Analiza productos Walmart, registros detallados, tendencias de rendimiento y volumen de ventas de fecha. Los resultados se devuelven como datos JSON estructurados. Consulta esta API mediante REST o MCP.
Prompts y casos de uso de API de análisis 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. Encontrar un producto Walmart
Prompt: Encontrar productos Walmart que coincidan [product name]. Mostrar página [page number] y para antes de solicitar otra página.
2. Inspección de detalles del producto
Prompt: Busca producto Walmart [product ID] y resumir sus datos de producto devueltos. Falta información.
3. Revisa Product Trends
Prompt: Mostrar los datos de tendencia disponibles para el producto Walmart [product ID]. Mantener las fechas de presentación de informes visibles y no inferir valores entre las observaciones desaparecidas.
4. Revisión de ventas en un rango de fecha
Prompt: Mostrar ventas para el producto Walmart [product ID] desde [start date] a través de [end date]. Página de lectura [page number] sólo y mantener el rango de fecha notificado.
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_analysishttps://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-analysis-1",
"method": "tools/call",
"params": {
"name": "nexscope_walmart_product_analysis",
"arguments": {
"operation": "detail",
"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
operation: searchByName
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
name | string | obligatorio | Nombre del producto requerido por searchByName Longitud mínima: 1 |
operation | string | obligatorio | Operación: searchByName, detalle, tendencia o salesVolume Constante: searchByName |
pageIndex | integer | opcional | Número de página, a partir de 1 Predeterminado: 1 Mínimo: 1 |
operation: detail
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
operation | string | obligatorio | Operación: searchByName, detalle, tendencia o salesVolume Constante: detail |
productId | string | obligatorio | Producto Walmart ID requerido por el detalle, la tendencia y salesVolume Longitud mínima: 1 |
operation: trend
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
operation | string | obligatorio | Operación: searchByName, detalle, tendencia o salesVolume Constante: trend |
productId | string | obligatorio | Producto Walmart ID requerido por el detalle, la tendencia y salesVolume Longitud mínima: 1 |
operation: salesVolume
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
operation | string | obligatorio | Operación: searchByName, detalle, tendencia o salesVolume Constante: salesVolume |
pageIndex | integer | opcional | Número de página, a partir de 1 Predeterminado: 1 Mínimo: 1 |
productId | string | obligatorio | Producto Walmart ID requerido por el detalle, la tendencia y salesVolume Longitud mínima: 1 |
queryDate | string | opcional | Fecha de inicio de volumen de ventas en YYYY-MM-DD formato Formato: date |
queryEndDate | string | opcional | Fecha final del volumen de ventas en YYYY-MM-DD formato Formato: date |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
errcode | integer | opcional | Código de estado de la capa marco de la puerta de entrada; `200` indica que la solicitud entró con éxito en la respuesta empresarial |
errmsg | string | opcional | Mensaje de estado de la capa marco de la puerta de entrada; típicamente `ok` sobre el éxito |
code | integer | opcional | `200` indica que el éxito |
msg | string | opcional | mensaje de respuesta |
data | object | opcional | contenedor de respuesta fijo; `data.value` conserva cada operación ST objeto primitivo, array, escalar, o `null` |
operation | string | opcional | `searchByName`, `detail`, `trend` o `salesVolume` en realidad ejecutado esta vez |
requestConsumed | integer | opcional | Este consumo de corriente arriba; cuando la corriente ascendente falta o devuelve 0, se completa según el consumo de documentos de la operación; cuando ST Devoluciones explícitas `Code=11` (sin datos), sigue siendo 0 |
costTime | integer | opcional | Tiempo tomado, unidad es milisegundos |
costToken | integer / absent | opcional | Cabecera de respuesta de puerta de producción `X-Cost-Token`; el script de entrada será copiado a este campo, y este campo está actualmente desaparecido cuando se analiza el JSON cuerpo directamente. |
costCredit | integer / absent | opcional | Cabecera de respuesta de puerta de producción `X-Cost-Credit`, que es el verdadero poder de cálculo deducido esta vez; el script de entrada será copiado a este campo |
sourceType | string | opcional | `st` |
searchByName | array<object> | opcional | Related product summary array |
detail | object | opcional | Objeto de detalles de producto único |
trend | object | opcional | Objeto de tendencia de producto único |
salesVolume | array<array> | opcional | matriz de registro de ventas; cada fila es `[date, sales, type]` |
Title | string | opcional | Título del producto |
Photo | array<string> | opcional | Imagen del producto URL array |
ListingSalesVolumeOfMonth | integer | opcional | Volumen estimado de ventas en los últimos 30 días en la dimensión de lista, sin distinguir entre variantes |
ListingSalesOfMonth | integer | opcional | Las ventas estimadas en los últimos 30 días en la dimensión de la Lista; la unidad para la US el sitio es centes |
ProductId | string | opcional | Walmart ProductId |
ParentProductId | string | opcional | Producto de propiedad ProductId |
Price | integer | opcional | Precio de venta; el US unidad de sitio es centes, como `1999` medios `$19.99` |
Brand | string | opcional | marca |
Seller | string | opcional | Nombre del vendedor en el momento de la colección |
Shipedby | string | opcional | El método de entrega en el momento de la colección; el nombre de campo es la ortografía original de la corriente |
WFSFee | integer | opcional | WFS honorarios; US unidad de sitio es centes |
Attribute | array<string> / null | opcional | Atributos de producto, codificación entrelazada según `[attribute name, attribute value, ...]` |
FirstReviewsDate | string / null | opcional | Fecha de primer comentario en el formato `yyyy-MM-dd` |
ReviewsCount | integer | opcional | Número de comentarios |
Ratings | number | opcional | Clasificación, como `4.8` |
NodePath | array<string\|null> | opcional | Los registros de categoría y clasificación se agrupan y codifican según `[category name, NodeId, ranking date, ranking, ...]`; cuando el ranking en un día determinado está desaparecido, la posición correspondiente es `null` |
Label | array<string> | opcional | Etiquetas de productos, tales como `pickup`, `savewith`, `bestsell` |
PopularPick | integer | opcional | Etiquetas Popular Pick; `1` indica la existencia |
Clearance | integer | opcional | Etiquetas de limpieza; `1` indica la existencia |
ReducedPrice | integer | opcional | etiqueta de precio reducido; `1` indica la existencia |
Rollback | integer | opcional | Token Rollback; `1` indica la existencia |
FlashDeal | integer | opcional | Flash Deal tag; `1` indica la existencia |
Size | array<string> / null | opcional | Tamaño del embalaje/envase exterior `[longest side, second longest side, shortest side]`, unidad es cm |
Weight | number | opcional | Peso del producto en gramos |
Variants | array / null | opcional | Datos variables; `searchByName` está codificado de forma diferente que `detail`, ver abajo |
NumberOfStar | array<number\|string> / null | opcional | El número de opiniones para cada estrella, según `[star rating, number of reviews, ...]` codificación escalonada |
Pickup | integer | opcional | Extensión del detalle: Marca de la etiqueta de recogida; `1` indica la existencia |
Savewith | integer | opcional | Extensión detallada: Guardar con marca de etiquetas; `1` indica la existencia |
Bestseller | integer | opcional | Extensión al detalle: Best Seller tag; `1` indica la existencia |
UpdateDate | string / null | opcional | Extensión detallada: tiempo de actualización de datos del producto, generalmente `yyyy-MM-dd` |
VariantId | string | opcional | Variante ProductId |
Url | string | opcional | Producto variable URL |
Property | array<string> | opcional | Atributos variables, codificados por `[attribute name, attribute value, ...]` |
PriceUpdate | string / null | opcional | Tiempo de actualización del precio, generalmente `yyyy-MM-dd` |
DetailUpdate | string / null | opcional | Detalles tiempo de actualización, generalmente `yyyy-MM-dd`; cuando no hay fecha válida, los titulares de los lugares de arriba como `--` puede utilizarse |
ProductId | string | opcional | Walmart ProductId |
ListingSalesVolumeOfMonth | integer | opcional | Volumen estimado de ventas de la dimensión actual de la Lista en los últimos 30 días |
ListingSalesOfMonth | integer | opcional | Ventas estimadas de la actual dimensión de lista en los últimos 30 días; la unidad para la US el sitio es centes |
ListingSalesVolumeOfMonthTrend | array<string> | opcional | Historial mensual de ventas, codificado por `[yyyy-MM-dd, sales volume, ...]` |
ListingSalesOfMonthTrend | array<string> | opcional | Historial mensual de ventas, codificado por `[yyyy-MM-dd, sales, ...]`; la unidad de la cantidad es de centavos |
PriceTrend | array<string> | opcional | Historia del precio, codificada por `[yyyy-MM-dd, price, ...]`; las cantidades en centavos |
ReviewsTrend | array<string> | opcional | Comentario contar historia, codificado por `[yyyy-MM-dd, comment count, ...]` |
StarTrend | array<string> | opcional | Historial de la clasificación, codificado como `[yyyy-MM-dd, rating, ...]`; valor actual del ejemplo de respuesta `5.00` |
RankTrend | array<array<string>> | opcional | Historial de clasificación de cada categoría; cada fila es codificada por `[category name, NodeId, date, ranking, date, ranking, ...]` |
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
Inspeccione los detalles del producto para las entradas de esta muestra de documentación.
Respuesta de ejemplo
En la muestra publicada, su reportado ventas de mes es 0. Su reportado savewith es 0. Su popular es 0. 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.
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
{
"operation": "detail",
"productId": "546427139"
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"data": {
"value": {
"ListingSalesOfMonth": 0,
"Shipedby": "自发货",
"Savewith": 0,
"Attribute": [
"Hair type",
"All Hair Types",
"Brand",
"Aquage",
"Hair care key benefits",
"Strengthening & Split End Repair, Cleansing, Moisturizing",
"Primary ingredient",
"Glycerin",
"Scent",
"Aquage",
"Size",
"16 fl oz",
"Shampoo & conditioner type",
"Conditioners",
"Hair product form",
"Creams",
"Container type",
"Bottle",
"Active ingredients",
"Glycerin",
"Instructions",
"Cleanse with Aquage Strengthening Shampoo. Apply Strengthening Conditioner. Gently comb through and rinse.",
"Product net content uom",
"Fluid Ounces",
"Product net content parent",
"16 Fluid Ounces",
"Age group",
"Adult",
"Gender",
"Female",
"Count per pack",
"1",
"Inactive ingredients",
"Water/Aqua/Eau, Myristyl Alcohol, Propylene Glycol, Cetearyl Alcohol, Cetrimonium Chloride*, Hippophae Rhamnoides (Sea Buckthorn/Argousier) Fruit/Seed Oil, Borago Officinalis (Borage/Bourrache) Seed Oil, Mangifera Indica (Mango/Mangue) Seed Butter, Butyrospermum Parkii (Shea/Karite) Butter, Hydroxypropyl Guar Hydroxypropyltrimonium Chloride, Aloe Barbadensis Leaf Juice, Glycerin, Hydrolyzed Quinoa, Aminomethyl Propanol, Bis-PCA Dimethicone, Butylene Glycol, C11-15 Pareth-7, C12-16 Pareth-9, Caprylyl Glycol, Decyl Oleate, Disodium PEG-12 Dimethicone Sulfosuccinate, Trideceth-12, Trimethylsiloxyamodimethicone, Citric Acid, Etidronic Acid, Lauryl Alcohol, Hydrogenated Palm Glycerides Citrate, Phenoxyethanol, Potassium Sorbate, Sodium Benzoate, Cetyl Alcohol, Benzyl Alcohol, Tocopherol, Fragrance/Parfum, Hydroxycitronellal, Limonene, Ext. Violet 2 (CI 60730) *antistatic agent/agent antistatique"
],
"FirstReviewsDate": null,
"Size": null,
"PopularPick": 0,
"Label": [],
"ReducedPrice": 0,
"Photo": [
"https://i5.walmartimages.com/seo/Aquage-SeaExtend-Strengthening-Conditioner-16-oz_d3a31b9b-0bbe-49c1-af75-cd3ed55f8788.b8b5b0e6b92a8bb489db501d1d11c211.jpeg",
"https://i5.walmartimages.com/asr/14636eb9-1bab-42ec-8ccb-e45eb052ae22.ec31255e50e0ac212fd57603599c9bd3.jpeg",
"https://i5.walmartimages.com/asr/d00485b4-2b2d-43fd-9471-bef08f91ab8f.8d0711f32aebd85f69057f70f29cede7.jpeg",
"https://i5.walmartimages.com/asr/f50d7eba-663f-4139-a6e8-5ada6d3a085c.e352eef32b49c9944a3f740b206000be.jpeg",
"https://i5.walmartimages.com/asr/2f36fd73-0f22-4cc3-bb6c-01aef6d7facf.62f2c4aca822002f3e4def0a57f66dd7.jpeg",
"https://i5.walmartimages.com/asr/ee6ba57e-362b-4666-b496-ba34b777a0b9.0eb8ebd9753455b2d59bb641c1931728.jpeg",
"https://i5.walmartimages.com/asr/35533f6e-3f31-4d24-bc3d-5f6d7e5afcd3.2ee717878eb67eae9e553c639a19d1b0.jpeg",
"https://i5.walmartimages.com/asr/fb4b6934-ab8d-4138-ad7d-755439b1947c.f1d6a59197ee32356f54f7524ed00b10.jpeg"
],
"ProductId": "546427139",
"Clearance": 0,
"Ratings": 4.7,
"UpdateDate": null,
"FlashDeal": 0,
"ParentProductId": "546427139",
"Rollback": 0,
"NumberOfStar": [
1,
1,
2,
1,
3,
0,
4,
4,
5,
28
],
"ReviewsCount": 34,
"Pickup": 0,
"Title": "Aquage SeaExtend Strengthening Conditioner 16 oz",
"Bestseller": 0,
"NodePath": [
"Premium Conditioners in Beauty",
"1085666_3020074",
"2026-09-30",
"195",
"Premium Conditioners in Beauty",
"1085666_3020074",
"2026-10-01",
null,
"Premium Conditioners in Beauty",
"1085666_3020074",
"2026-10-02",
"119",
"Premium Conditioners in Beauty",
"1085666_3020074",
"2026-10-03",
null,
"Premium Conditioners in Beauty",
"1085666_3020074",
"2026-10-04",
"131",
"Premium Conditioners in Beauty",
"1085666_3020074",
"2026-10-05",
"112"
],
"Weight": 0,
"Brand": "Aquage",
"Variants": [
"546427139",
" https://www.walmart.com/ip/Aquage-SeaExtend-Strengthening-Conditioner-16-oz/546427139",
[
"Size",
"16 fl oz"
]
],
"WFSFee": 0,
"Price": 3030,
"ListingSalesVolumeOfMonth": 0,
"Seller": "Beautyvice"
}
},
"costTime": 962,
"sourceType": "sorftime",
"operation": "detail",
"requestConsumed": 1
}
}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-analysis-example",
"method": "tools/call",
"params": {
"name": "nexscope_walmart_product_analysis",
"arguments": {
"operation": "detail",
"productId": "546427139"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "walmart-product-analysis-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":{\"value\":{\"ListingSalesOfMonth\":0,\"Shipedby\":\"自发货\",\"Savewith\":0,\"Attribute\":[\"Hair type\",\"All Hair Types\"],\"FirstReviewsDate\":null,\"Size\":null,\"PopularPick\":0,\"Label\":[],\"ReducedPrice\":0,\"Photo\":[\"https://i5.walmartimages.com/seo/Aquage-SeaExtend-Strengthening-Conditioner-16-oz_d3a31b9b-0bbe-49c1-af75-cd3ed55f8788.b8b5b0e6b92a8bb489db501d1d11c211.jpeg\",\"https://i5.walmartimages.com/asr/14636eb9-1bab-42ec-8ccb-e45eb052ae22.ec31255e50e0ac212fd57603599c9bd3.jpeg\"],\"ProductId\":\"546427139\",\"Clearance\":0}},\"operation\":\"detail\",\"requestConsumed\":1}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": {
"value": {
"ListingSalesOfMonth": 0,
"Shipedby": "自发货",
"Savewith": 0,
"Attribute": [
"Hair type",
"All Hair Types"
],
"FirstReviewsDate": null,
"Size": null,
"PopularPick": 0,
"Label": [],
"ReducedPrice": 0,
"Photo": [
"https://i5.walmartimages.com/seo/Aquage-SeaExtend-Strengthening-Conditioner-16-oz_d3a31b9b-0bbe-49c1-af75-cd3ed55f8788.b8b5b0e6b92a8bb489db501d1d11c211.jpeg",
"https://i5.walmartimages.com/asr/14636eb9-1bab-42ec-8ccb-e45eb052ae22.ec31255e50e0ac212fd57603599c9bd3.jpeg"
],
"ProductId": "546427139",
"Clearance": 0
}
},
"operation": "detail",
"requestConsumed": 1
}
},
"isError": false
}
}