Conectar SHEIN Seller MCP con Meta Muse

💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Vendedor SHEIN, pega el App ID y el App Secret, haz clic en Authorize with Provider y aprueba con la cuenta principal de la tienda en SHEIN, genera una clave API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Vendedor SHEIN + Meta Muse

Deja que tu IA trabaje con tu tienda de vendedor de SHEIN: pedidos, dirección del comprador y carga de seguimiento, seguimiento de paquetes, productos con precios y stock, actualizaciones de stock y precios, categorías y atributos, casos de postventa y devoluciones.

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:

SHEIN_API_HOST, SHEIN_APP_ID, SHEIN_APP_SECRET

Paso 1 — Obtén credenciales

Lo que necesitas: una cuenta de desarrollador de la Plataforma Abierta SHEIN del tipo Vendedor Autodesarrollado (verificada con la información del comerciante de la tienda), una aplicación aprobada del modo de cooperación de la tienda y la cuenta principal de la tienda para aprobarla. Aproximadamente 20 minutos de trabajo, más las revisiones de la cuenta y la aplicación por parte de SHEIN.

1. Regístrate en https://open.sheincorp.com, elige el tipo de desarrollador Vendedor Autodesarrollado y envía la información del comerciante que solicita (toda está en el backend del vendedor). El tipo no se puede cambiar una vez aprobado.
2. En la consola, abre Gestión de Aplicaciones y crea una aplicación. Elige el tipo de aplicación del modo de cooperación de la tienda: Autogestionada o Semi-Gestionada para una tienda de mercado (una tienda en varios modos necesita una aplicación por modo). El nombre, el icono y la descripción se muestran a los vendedores y no se pueden editar después de enviarlos. SHEIN revisa la aplicación; hasta que sea aprobada no hay un App ID o App Secret válidos.
3. En la página de detalles de la aplicación, verifica el Paquete de Permisos API: las APIs de pedidos, productos, inventario, postventa y devoluciones deben estar suscritas (generalmente concedidas con la aprobación; de lo contrario, haz clic en Solicitar Paquete de Permisos). Agrega la dirección IP saliente de este servidor a la lista blanca de IP de la aplicación: SHEIN rechaza llamadas de producción desde cualquier otra dirección (openapi00002). En AnythingMCP Cloud, la página de configuración muestra la dirección.
4. Copia el App ID en SHEIN_APP_ID y el App Secret en SHEIN_APP_SECRET, y elige la dirección API para SHEIN_API_HOST: https://openapi.sheincorp.com para aplicaciones autogestionadas y semi-gestionadas, https://openapi.sheincorp.cn para aplicaciones totalmente gestionadas, operadas por SHEIN y otras.
5. Instala el conector y haz clic en Authorize with Provider (el último paso de la guía de configuración lo hace). Se abre la página de SHEIN: inicia sesión en el backend del vendedor con la cuenta principal de la tienda y haz clic en el botón de autorizar. SHEIN envía el navegador de vuelta a <SERVER_URL>/api/shein-auth/callback (en AnythingMCP Cloud: https://cloud.anythingmcp.com/api/shein-auth/callback) y el conector obtiene la clave de la tienda dentro de los 10 minutos que SHEIN permite.

La clave de la tienda: SHEIN entrega el openKeyId y el secretKey de la tienda (el secretKey encriptado con el App Secret, que AnythingMCP desencripta una vez); ambos se almacenan encriptados en el conector. SHEIN no documenta una duración ni renovación para ellos. Una autorización termina cuando el vendedor desvincula la aplicación o restablece la clave, la tienda se cierra, SHEIN la restablece o desvincula, o expira: las llamadas fallan con openapi00004 ("El usuario ha expirado"), el conector muestra que necesita una nueva autorización, y alguien hace clic en Authorize with Provider nuevamente.

Cómo se firma: cada llamada lleva x-lt-openKeyId, x-lt-timestamp (milisegundos Unix) y x-lt-signature: cinco caracteres aleatorios seguidos del Base64 del HMAC-SHA256 en minúsculas de openKeyId&timestamp&path, con la clave del secretKey más esos cinco caracteres. La consulta no está firmada. Un timestamp es válido por 5 minutos, así que el reloj del servidor debe estar correcto.

Por dónde empezar: shein_get_store_info verifica la autorización y nombra la tienda; shein_list_sites proporciona los códigos de sitio y las monedas.

• Pedidos: shein_list_orders (una ventana de máximo 48 horas es obligatoria), luego shein_get_orders para hasta 30 a la vez. Solo los pedidos con stockMode 3 son enviados por el vendedor; printOrderStatus 1 significa que el pedido puede ser manejado ahora.
• Envío tú mismo: shein_get_order_address (handle_type 2 también mueve el pedido a ser enviado), shein_list_warehouse_addresses, shein_list_shipping_channels, luego shein_upload_tracking_numbers por pieza (goodsId). shein_get_logistics_track sigue el paquete. SHEIN marca el pedido como enviado cuando el transportista lo escanea. shein_confirm_out_of_stock está desactivado en la instalación.
• Productos: shein_search_products (códigos, estado en estante, precios, stock y bloqueos de campaña), shein_list_products (todos los códigos), shein_get_product (un SPU completo). Para nuevos listados: shein_get_category_tree, shein_get_attribute_templates, shein_list_brands. shein_set_skc_shelf_status está desactivado en la instalación.
• Stock y precios: shein_list_warehouses, shein_get_stock, shein_update_stock (con una clave de idempotencia por línea), shein_update_prices (los aumentos pueden esperar la revisión de precios de SHEIN). shein_get_sku_sales proporciona unidades vendidas para tiendas gestionadas.
• Postventa: shein_list_after_sales_orders y shein_get_after_sales_orders, shein_list_return_orders y shein_get_return_orders solo lectura; shein_sign_return_order está desactivado en la instalación.

Códigos, tiempos y cantidades: los códigos SPU, SKC y SKU (spuName, skcName, skuCode) son de SHEIN; supplierCode y supplierSku son propios del vendedor. Un SKU vendido varias veces tiene un goodsId por pieza, y los números de seguimiento, cancelaciones y recibos de devolución funcionan por goodsId. Los valores de goodsId son números de 64 bits: el conector lee cada id demasiado largo para un número de JavaScript como texto con sus dígitos exactos, y las herramientas toman ids como texto y los envían a SHEIN como números, así que cópialos exactamente como un pedido o devolución los muestra. Las ventanas de pedidos, postventa y devoluciones son hora de Pekín (UTC+8) como yyyy-MM-dd HH:mm:ss; los detalles del pedido responden con yyyy-MM-dd'T'HH:mm:ss.SSSZ, los eventos de seguimiento con milisegundos Unix. Las cantidades son decimales en la moneda nombrada junto a ellas (orderCurrency, currency, currencyCode).

Límites: cada API tiene su propio límite de llamadas por segundo por aplicación (20 para búsqueda de productos, 30 a 300 para las demás), respondido con openapi00006 o 832213 cuando se excede. Las listas de pedidos y devoluciones se paginan de 30, la búsqueda de productos de 10; una ventana de pedidos devuelve como máximo 10,000 pedidos, la lista de productos como máximo 50,000 códigos. El mismo SKC y sitio pueden cambiar el estado del estante una vez cada 20 minutos.

Respuestas y errores: SHEIN responde con code "0" y el resultado en info; cualquier otro code es un error con msg y un traceId para citar al soporte de SHEIN dentro de tres días. El conector solicita mensajes en inglés (language: en). openapi00001: la firma fue rechazada; con un reloj de servidor correcto esto significa que la clave de la tienda cambió (re-autorizada o restablecida en otro lugar), así que autoriza nuevamente. openapi00002: la dirección IP de este servidor no está en la lista blanca de la aplicación. openapi00003: la aplicación no tiene permiso para esta API, la API no es para el modo de la tienda, o la cuenta de desarrollador está deshabilitada. openapi00004: la autorización ha terminado; autoriza nuevamente. Las llamadas de escritura que toman una lista responden con code 0 y nombran las líneas rechazadas (failedList, failure_results o info).

Paso 2 — Instala 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 — Agrega el conector en Muse

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.

Muse añade los servidores MCP remotos como conectores personalizados e inicia sesión en ellos con OAuth.

1. En Muse, abre Settings → Connectors y elige Add custom connector.
2. Pega la URL del servidor MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse abre la página de inicio de sesión de AnythingMCP: inicia sesión y aprueba el acceso.
4. En un chat, pídele a Muse algo que necesite las herramientas de Vendedor SHEIN.

También puedes configurarlo desde un chat, en la web, en las apps de iOS y Android o en WhatsApp. Envía a Muse este mensaje:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Muse se conecta desde la nube de Meta, así que localhost no funciona.

Herramientas disponibles

Ejemplos de indicaciones

• "¿Qué pedidos de SHEIN de las últimas 24 horas puedo manejar ahora?"
• "Carga el número de seguimiento de UPS 1Z999AA10123456784 para ambas piezas del pedido GSH12345678901."
• "¿Cuáles de mis SKUs tienen menos de 10 unidades en stock?"
• "Establece el stock del código SKU I8xk2m4p0q en mi almacén principal a 60."
• "¿Qué pedidos de devolución y casos de postventa llegaron esta semana, y qué dicen los compradores?"

Preguntas frecuentes

¿Debo pegar una clave de tienda o token? No. Debes pegar el App ID y el App Secret de tu aplicación SHEIN aprobada y hacer clic en Authorize with Provider. La página de SHEIN solicita la aprobación de la cuenta principal de la tienda, y el conector obtiene y almacena la clave de la tienda por sí mismo. Cuando la autorización termina, haz clic en Authorize with Provider nuevamente.

¿Para qué tiendas funciona? Los pedidos, seguimiento, actualizaciones de stock y devoluciones son para tiendas autogestionadas y semi-gestionadas; los precios solo pueden ser establecidos por tiendas autogestionadas. Los productos, categorías, marcas, sitios y lecturas de stock también funcionan para tiendas totalmente gestionadas. Elige la dirección API de tu tipo de aplicación: openapi.sheincorp.com para autogestionadas y semi-gestionadas, openapi.sheincorp.cn para totalmente gestionadas. SHEIN solo acepta llamadas de direcciones en la lista blanca de la aplicación; en AnythingMCP Cloud, la página de configuración muestra la dirección a agregar.

¿Qué herramientas se instalan desactivadas? shein_confirm_out_of_stock, que cancela una línea de pedido, shein_set_skc_shelf_status, que quita productos del estante, y shein_sign_return_order, que confirma una devolución. Nada en el conector mueve dinero, reserva logística pagada o decide un caso de postventa.

¿Dónde está disponible Muse? Por ahora Meta ofrece Muse en Estados Unidos y Canadá, en la web, en las apps de iOS y Android y en WhatsApp.

¿Meta revisa este conector? No. Meta no revisa los conectores personalizados. Muse solo ve las herramientas que activaste para este servidor MCP en AnythingMCP, y puedes desconectarlo cuando quieras en Settings → Connectors.

Próximos pasos

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