Conectar Walmart Marketplace MCP con Gemini CLI

💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Walmart Marketplace, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Walmart Marketplace + Gemini

API de Walmart Marketplace para vendedores de EE. UU.: pedidos con confirmación y envío con seguimiento, devoluciones, búsqueda de artículos y catálogo, inventario, precios, cargas masivas, informes bajo demanda, envíos entrantes de WFS y configuraciones de envío. ID de cliente y secreto.

Requisitos previos

Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:

WALMART_CLIENT_ID, WALMART_CLIENT_SECRET

Paso 1 — Obtener credenciales

La configuración tarda unos 5 minutos.

1. Inicia sesión en https://developer.walmart.com con tu inicio de sesión de Seller Center (elige vendedor de Marketplace).
2. Abre Mi cuenta, luego Claves API (gestión de claves) y crea o copia el ID de cliente y el secreto de producción.
3. Pega el ID de cliente en WALMART_CLIENT_ID y el secreto de cliente en WALMART_CLIENT_SECRET.

El conector los intercambia en POST /v3/token (HTTP Basic, credenciales de cliente) por un token de acceso que dura 15 minutos, lo reutiliza hasta poco antes de que expire y obtiene uno nuevo por sí mismo. Cada llamada lleva WM_SEC.ACCESS_TOKEN, WM_SVC.NAME y un nuevo WM_QOS.CORRELATION_ID. Usa tus propias credenciales de cliente: las claves de Acceso Delegado para proveedores de soluciones están siendo retiradas (no se pueden crear nuevas, las existentes dejarán de funcionar después del 30 de abril de 2027).

Dónde empezar: walmart_marketplace_list_released_orders (pedidos que te están esperando), luego walmart_marketplace_get_order. walmart_marketplace_list_items lista tu catálogo y walmart_marketplace_get_inventory el stock de un SKU.

Pedidos: walmart_marketplace_list_orders (todos los estados), walmart_marketplace_list_released_orders (líneas en Creado), walmart_marketplace_get_order. Una línea pasa a Creado, Reconocido, Enviado, Entregado o Cancelado. Reconoce nuevos pedidos rápidamente con walmart_marketplace_acknowledge_order, luego envía cada línea con walmart_marketplace_ship_order_line (transportista, método, número de seguimiento, tiempo de envío en milisegundos epoch); el envío captura el pago del cliente. walmart_marketplace_cancel_order_line y walmart_marketplace_refund_order_lines están instalados apagados: una cancelación afecta tus métricas de vendedor y un reembolso mueve dinero. Las listas de pedidos alcanzan hasta 180 días atrás, un máximo de 10,000 pedidos, y por defecto son de los últimos 7 días.

Paginación: los pedidos y devoluciones responden con meta.nextCursor, una cadena de consulta lista que comienza con ?. Pásala sin cambios como next_cursor y deja fuera los otros filtros. Los artículos usan nextCursor (comienza con *, válido 2 minutos) o límite y desplazamiento.

Devoluciones: walmart_marketplace_list_returns (estados INICIADOS, ENTREGADOS, COMPLETADOS). walmart_marketplace_refund_return está apagado porque reembolsa al cliente.

Artículos y catálogo: walmart_marketplace_list_items, walmart_marketplace_get_item, walmart_marketplace_count_items, walmart_marketplace_search_my_catalog (tu catálogo con filtros como artículos NO PUBLICADOS) y walmart_marketplace_search_walmart_catalog (el catálogo público de Walmart.com por palabra clave, UPC o GTIN). walmart_marketplace_retire_item está apagado: retirar elimina la lista.

Inventario y precios: walmart_marketplace_get_inventory, walmart_marketplace_get_inventory_by_ship_node, walmart_marketplace_update_inventory (cantidad absoluta, unidad CADA UNO), walmart_marketplace_get_wfs_inventory (stock mantenido por WFS). walmart_marketplace_update_price establece el precio BASE de un SKU en USD (100 llamadas por hora); walmart_marketplace_get_promotional_prices muestra precios de venta.

Feeds: los cambios masivos se realizan a través de feeds. walmart_marketplace_submit_item_feed y walmart_marketplace_submit_price_feed están instalados apagados, porque un feed cambia muchas listas activas y los feeds de precios masivos están limitados por hora y por día (10 por hora, compartidos por todos los feeds de precios y promociones). Consulta los resultados con walmart_marketplace_list_feeds y walmart_marketplace_get_feed_status (errores por artículo con include_details).

Informes: walmart_marketplace_request_report, luego walmart_marketplace_list_report_requests o walmart_marketplace_get_report_request hasta que esté LISTO, luego walmart_marketplace_get_report_download_url. Las llamadas de estado y descarga están limitadas a 20 por hora cada una, así que espera varios minutos entre verificaciones. El enlace es un CSV comprimido de corta duración.

WFS: walmart_marketplace_list_inbound_shipments, walmart_marketplace_list_inbound_shipment_items, walmart_marketplace_create_inbound_shipment_label (etiquetas de recepción como PDF o ZPL, gratis).

Configuraciones (solo lectura): walmart_marketplace_list_ship_nodes (ids de nodos de envío), walmart_marketplace_list_carrier_methods, walmart_marketplace_list_shipping_templates, walmart_marketplace_get_lag_time (20 llamadas por hora).

Límites de tasa: cada API tiene su propio bucket de tokens (todos los pedidos 5,000 por minuto, pedidos liberados 60 por minuto, enviar, reconocer y cancelar 60 por minuto, inventario 200 por minuto, artículos 300 por minuto). Un 429 significa que el bucket está vacío; los encabezados x-current-token-count y X-Next-Replenishment-Time indican cuándo volver a intentar.

Formatos: las fechas son ISO 8601 en UTC; las fechas de los pedidos en las respuestas son milisegundos epoch. El dinero está en USD. Los SKUs son tus propios SKUs de vendedor; los ids de Walmart son purchaseOrderId (pedidos), returnOrderId (devoluciones), wpid e itemId (catálogo). Los errores regresan como errors.error[] con código, campo y descripción; un 400 INVALID_REQUEST_HEADER generalmente significa un problema de token o encabezado.

Paso 2 — Instalar el adaptador

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Agregar el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Walmart Marketplace.

Herramientas disponibles

Ejemplos de indicaciones

• "¿Qué pedidos liberados de Walmart aún necesitan ser enviados hoy?"
• "Muestra el pedido de compra 1234567890123 con la dirección de envío del cliente y las líneas."
• "¿Qué SKUs tienen menos de 5 unidades en stock en mis nodos de envío?"
• "Establece el precio del SKU WM-1001 a 24.99 USD."
• "Reconoce todos los pedidos liberados de hoy y lista los que aún faltan seguimiento."

Preguntas frecuentes

¿Qué mercados de Walmart cubre? El Walmart Marketplace de EE. UU. (marketplace.walmartapis.com). Walmart Canadá, México y Chile tienen APIs separadas y no están cubiertos.

¿Necesito una aplicación de proveedor de soluciones o Acceso Delegado? No. Creas tu propio ID de cliente y secreto en el Portal de Desarrolladores de Walmart con tu inicio de sesión de vendedor. Walmart ya no emite nuevas claves de Acceso Delegado.

¿Puede cancelar pedidos o emitir reembolsos? Las herramientas existen pero están instaladas apagadas: walmart_marketplace_cancel_order_line, walmart_marketplace_refund_order_lines y walmart_marketplace_refund_return. Actívalas en la página del conector solo si la IA debe usarlas; te pedirá que confirmes cada cambio.

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Próximos pasos

• Página de inicio del conector
• Conectar a Claude