Inteligencia de Walmart ST

API de mercado de categorías de Walmart MCP

Encuentre las categorías de Walmart y revise los informes de mercado de categoría. Llama al mercado de la categoría Walmart API mediante REST o MCP en su aplicación o AI agente.

CosteRecent Avg. 74 · Range 63–79 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de mercado de categorías 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. Categorías de Walmart

Prompt: Mostrar el árbol de la categoría Walmart para que pueda elegir la categoría para mi investigación de productos. Conserva las relaciones entre elementos principales y secundarios.

2. Encontrar un Walmart Categoría

Prompt: Encontrar las categorías de Walmart [category name]. Mostrar las rutas de la categoría devuelta para que pueda seleccionar la correcta.

3. Revisa a Category Market Report

Prompt: Obtener el informe de mercado de la categoría Walmart [category path from lookup]. Resume la información disponible de la categoría sin inventar cifras de ventas ausentes.

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/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_walmart_category_market

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": "walmart-category-market-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_walmart_category_market",
    "arguments": {
      "operation": "tree"
    }
  }
}

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

operation: tree

Nombre	Tipo	Obligatorio	Descripción
`operation`	`string`	obligatorio	Operación: árbol, searchByNameo marketReport Constante: tree

operation: searchByName

Nombre	Tipo	Obligatorio	Descripción
`name`	`string`	obligatorio	Nombre de categoría requerido por searchByName Longitud mínima: 1
`operation`	`string`	obligatorio	Operación: árbol, searchByNameo marketReport Constante: searchByName

operation: marketReport

Nombre	Tipo	Obligatorio	Descripción
`nodePath`	`string`	obligatorio	Carril de nodos de categoría separada inferior requerido por marketReport Patrón: ^\d+(?:_\d+)+$
`operation`	`string`	obligatorio	Operación: árbol, searchByNameo marketReport Constante: marketReport

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; cuando no hay datos, puede ser "query successful, but no data"
`data`	`object`	opcional	contenedor de respuesta fijo; `data.value` retenciones ST primitivo, objeto, escalar o `null` por operación
`operation`	`string`	opcional	`tree`, `searchByName` o `marketReport` 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`
`tree`	`array<object>`	opcional	Árbol de categoría completa; elementos de array son nodos de categoría
`searchByName`	`array<object>`	opcional	Categorías relacionadas; máximo 3 artículos
`marketReport`	`array<object>`	opcional	Categoría producto resumen array; devolver el array directamente sin cubrir el `Products` capa
`Id`	`integer`	opcional	Categoría ID
`ParentId`	`integer`	opcional	Categoría de parientes ID; `0` representa el nivel superior
`NodeId`	`string`	opcional	Nodo de categoría Walmart ID
`Name`	`string`	opcional	Nombre de la categoría en inglés
`CNName`	`string`	opcional	Nombre de la categoría china
`URL`	`string`	opcional	Categoría URL
`NodeId`	`string`	opcional	La ruta completa de categoría separada por los subrayados se puede utilizar directamente como `marketReport.nodePath`
`CategoryName`	`string`	opcional	Categoría nombre de visualización
`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<object> / null`	opcional	Lista de variación, los campos se muestran en el cuadro siguiente
`NumberOfStar`	`array<number\\|string> / null`	opcional	El número de opiniones para cada estrella, según `[star rating, number of reviews, ...]` codificación escalonada
`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

Ilustración del formato

Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.

Pregunta ilustrativa

Mostrar el árbol de la categoría Walmart para que pueda elegir una categoría para la investigación de productos.

Explicación ilustrativa de la respuesta

El resultado ilustrativo contiene una categoría de alto nivel, “Categoría electrónica de ejemplos”, con el padre ID 0. Usar un camino de categoría devuelto por una búsqueda real antes de solicitar su informe de mercado.

Sobre esta muestra: Registro de categoría ilustrativa, no una taxonomía actual verificada Walmart.

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": "walmart-category-market-example",
  "method": "tools/call",
  "params": {
    "name": "nexscope_walmart_category_market",
    "arguments": {
      "operation": "tree"
    }
  }
}

Formato de respuesta MCP

{
  "jsonrpc": "2.0",
  "id": "walmart-category-market-example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"code\":0,\"msg\":null,\"data\":{\"operation\":\"tree\",\"data\":{\"value\":[{\"Id\":1,\"ParentId\":0,\"NodeId\":\"3944\",\"Name\":\"Example electronics category\"}]}}}"
      }
    ],
    "structuredContent": {
      "code": 0,
      "msg": null,
      "data": {
        "operation": "tree",
        "data": {
          "value": [
            {
              "Id": 1,
              "ParentId": 0,
              "NodeId": "3944",
              "Name": "Example electronics category"
            }
          ]
        }
      }
    },
    "isError": false
  }
}