Resumen
API de Wish Marketplace v3 para comerciantes: pedidos y cumplimiento con seguimiento, productos y variaciones con precios e inventario por almacén, categorías y atributos, tickets de soporte al cliente, valoraciones, penalizaciones, almacenes y configuraciones de envío. Token de acceso OAuth de una aplicación privada.
Configuración guiada
Conecta Wish a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Wish con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Wish
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Wish, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Wish
API de Wish Marketplace v3 para comerciantes: pedidos y cumplimiento con seguimiento, productos y variaciones con precios e inventario por almacén, categorías y atributos, tickets de soporte al cliente, valoraciones, penalizaciones, almacenes y configuraciones de envío. Token de acceso OAuth de una aplicación privada.
Configuración
Configurar toma aproximadamente 10 minutos.
- En el panel de control de comerciantes de Wish (https://merchant.wish.com) abre el menú de Cuenta, Configuración de API, y haz clic en Registrar una aplicación privada. Ingresa un nombre y una URI de redirección HTTPS que poseas (cualquier página funciona, solo tiene que aparecer en su dirección). Wish permite una aplicación privada por comerciante.
- Abre
https://merchant.wish.com/v3/oauth/authorize?client_id=seguido del ID de cliente de la aplicación, inicia sesión y aprueba. Wish redirige a tu URI de redirección con?code=en la dirección; el código es válido por 5 minutos y funciona una vez. - Intercambia el código: abre
https://merchant.wish.com/api/v3/oauth/access_token?grant_type=authorization_code&client_id=...&client_secret=...&code=...&redirect_uri=...con tus valores. Copiadata.access_tokenenWISH_ACCESS_TOKENy guardadata.refresh_tokende forma segura.
Duración del token: Los tokens de acceso de Wish expiran después de 30 días. Antes de eso, abre https://merchant.wish.com/api/v3/oauth/refresh_token?grant_type=refresh_token&client_id=...&client_secret=...&refresh_token=... y pega el nuevo token de acceso en el conector (el antiguo es revocado). Wish renueva los tokens solo con solicitudes GET, que la renovación automática de OAuth del conector no envía, así que la renovación es manual por ahora.
Por dónde empezar: wish_test_token verifica el token y muestra sus alcances. wish_list_orders con estados APPROVED lista los pedidos para enviar; wish_list_products lista el catálogo; wish_list_warehouses proporciona los IDs de los almacenes que necesita el inventario.
Pedidos: wish_list_orders, wish_get_order. Envía con wish_fulfill_order (transportista de wish_list_shipping_carriers, número de seguimiento, país de origen); la misma llamada corrige el seguimiento más tarde. El envío y los reembolsos son asíncronos: lee el pedido nuevamente para ver el resultado. wish_list_refund_reasons muestra razones válidas; wish_refund_order reembolsa al cliente y está instalado apagado.
Productos: wish_list_products, wish_get_product, wish_create_product, wish_update_product (precio, inventario por almacén, estado de variaciones por ID de variación), wish_create_variation. Categorías: wish_get_categories, wish_get_category, wish_get_category_attributes. wish_delete_product está instalado apagado; desactiva variaciones en su lugar. wish_get_product_rating lee la valoración.
Tickets de clientes: wish_list_tickets (estado AWAITING_MERCHANT necesita una respuesta), wish_get_ticket, wish_reply_to_ticket, wish_update_ticket (cerrar, reabrir, apelar).
Cuenta: wish_get_account_details, wish_list_penalties, wish_get_shipping_settings, wish_list_warehouses.
Paginación: las listas devuelven hasta limit elementos ordenados por tiempo; para la siguiente página llama nuevamente con updated_at_max (o created_at_max) establecido en el tiempo del último elemento. Cada respuesta tiene la forma code, message, data; code 0 significa éxito.
IDs y formatos: los IDs de pedido, producto, variación, ticket y almacén son cadenas hexadecimales de 24 caracteres. Los tiempos son ISO 8601 (2026-11-01T00:00:00Z). Los precios son objetos con amount y currency_code. Los alcances del token deciden qué funciona: un alcance faltante responde 403.
Límites de tasa: por comerciante y aplicación; el encabezado Wish-Rate-Limit-Remaining muestra lo que queda y un 429 lleva Wish-Rate-Limit-Reset. Cita el encabezado Wish-Request-Id al contactar a Wish sobre una llamada.
Requisitos previos: WISH_ACCESS_TOKEN
Instalar el conector localmente
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
Abre http://localhost:3000/connectors/store, elige Wish y pega las variables de entorno listadas bajo Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
wish_test_token | Verifica que el token de acceso funcione: devuelve el ID del comerciante y los alcances del token |
wish_get_account_details | La cuenta del comerciante: id, nombre para mostrar, contacto, país, estado y otros detalles de la cuenta |
wish_list_orders | Lista los pedidos, los más recientemente actualizados primero por defecto: id, estado (APPROVED para enviar, SHIPPED, REFUNDED, REQUIRE_REVIEW), tipo de pedido, producto… |
wish_get_order | Un pedido por id: estado, producto y variación, cantidad, precios y pago, dirección de envío, requisitos de cumplimiento y plazo… |
wish_list_shipping_carriers | Transportistas de envío aceptados: todos los transportistas (GENERAL) o aquellos aceptados para la política de Entrega Confirmada a un país de destino… |
wish_fulfill_order | Marca un pedido como enviado, o actualiza su seguimiento: transportista, número de seguimiento y país de origen. Asíncrono; lee el pedido nuevamente para ver el… |
wish_list_refund_reasons | Razones de reembolso válidas para un pedido en este momento (cambian durante la vida del pedido). Léelas justo antes de un reembolso |
wish_refund_order | Reembolsa o cancela un pedido con una razón de wish_list_refund_reasons. El cliente recibe el dinero de vuelta y no se puede deshacer; los reembolsos… |
wish_list_products | Lista productos, los más recientemente actualizados primero por defecto: id, parent_sku, nombre, estado, categoría, imágenes, variaciones (id, sku, precio, inventario… |
wish_get_product | Un producto por id con sus variaciones, precios, inventario por almacén, imágenes, atributos, estado de envío y revisión |
wish_create_product | Crea un producto con al menos una variación. Necesita nombre, descripción (texto plano, hasta 4,000 caracteres), SKU principal, categoría, principal… |
wish_update_product | Actualiza un producto: nombre, descripción, etiquetas, categoría, imágenes, precios de envío predeterminados, estado, o sus variaciones existentes (por id de variación… |
wish_delete_product | Elimina un listado de producto. No se puede deshacer. Instalado apagado; desactiva variaciones con wish_update_product en su lugar |
wish_create_variation | Agrega una variación a un producto existente: sku, precio, inventario por almacén, valores de opción e imagen |
wish_get_categories | La raíz del árbol de categorías de Wish con sus categorías hijas (id, nombre, is_leaf). Baja con wish_get_category a una hoja para category_id |
wish_get_category | Una categoría por id con sus hijos; las categorías hoja pueden usarse como category_id |
wish_get_category_attributes | Atributos de una categoría (nombre, requerido, valores permitidos) para llenar atributos y opciones al crear productos |
wish_get_product_rating | Valoración general de un producto: valoración media y conteos de valoraciones |
wish_list_tickets | Tickets de soporte al cliente, los más recientemente actualizados primero: id, tipo (ORDER, PRE_PURCHASE, POST_CUSTOMER_SUPPORT), estado (AWAITING_MERCHANT… |
wish_get_ticket | Un ticket de soporte con sus mensajes, pedido relacionado y estado |
wish_reply_to_ticket | Responde a un ticket en estado AWAITING_MERCHANT (hasta 2,000 caracteres, se permite Markdown). Wish actualiza el estado después de la respuesta |
wish_update_ticket | Cierra un ticket (CLOSED), reabre uno cerrado (AWAITING_MERCHANT, cuando se permite) o apela al soporte de Wish (AWAITING_WISH) |
wish_list_penalties | Penalizaciones en la cuenta, las más recientes primero: id, tipo, cantidad y moneda, razón, pedido o producto, tiempo creado y revertido. Hasta 500 por… |
wish_get_shipping_settings | Configuraciones de envío del comerciante por país de destino al que Wish envía: países habilitados, precios de envío y regiones |
wish_list_warehouses | Los almacenes del comerciante: id, nombre, tipo (almacén estándar primero), dirección. Se necesitan los IDs de almacén para inventario y precios de envío |
Ejemplos de prompts
- "¿Qué pedidos de Wish necesitan cumplimiento hoy?"
- "Cumple el pedido 64a1b2c3d4e5 con seguimiento de USPS 9400111899223197428490."
- "¿Qué tickets de soporte están esperando mi respuesta?"
- "¿Hay nuevas penalizaciones en mi cuenta este mes?"
- "¿Cuál es la valoración del producto 5f9e8d7c6b5a?"
Próximos pasos
¿Te ha sido útil esta guía?