Resumen
API de Socios de Temu para vendedores con una tienda local: pedidos con dirección y montos del comprador, confirmación de envíos con tu propio transportista y número de seguimiento, seguimiento, productos y SKUs, stock, precios base, categorías, y solicitudes de reembolso, devolución y cancelación. Aplicación autodesarrollada con App Key, App Secret y el token de acceso de la tienda; las llamadas están firmadas.
Configuración guiada
Conecta Temu a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Temu 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 Temu
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.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Temu, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Temu
API de Socios de Temu para vendedores con una tienda local: pedidos con dirección y montos del comprador, confirmación de envíos con tu propio transportista y número de seguimiento, seguimiento, productos y SKUs, stock, precios base, categorías, y solicitudes de reembolso, devolución y cancelación. Aplicación autodesarrollada con App Key, App Secret y el token de acceso de la tienda; las llamadas están firmadas.
Configuración
Configurar toma aproximadamente 20 minutos. Necesitas la revisión de la aplicación por parte de Temu.
- En la Plataforma de Socios de Temu (https://partner-us.temu.com para Estados Unidos, https://partner-eu.temu.com para Europa, https://partner.temu.com para otros países) crea una cuenta, elige el tipo de socio Vendedor de aplicaciones autodesarrolladas y vincula tu cuenta principal del Centro de Vendedores. Una cuenta del Centro de Vendedores puede tener una aplicación autodesarrollada.
- Completa la información de la aplicación y los cuestionarios de cumplimiento y seguridad. La pregunta 5 de la parte de cumplimiento pregunta por las direcciones IP desde las que provienen tus llamadas: ingresa la dirección IP saliente de este servidor AnythingMCP. Solo estas direcciones pueden llamar a la API, no se aceptan proveedores de nube en China, y el servidor debe estar en la región de la tienda (una dirección de Estados Unidos para una tienda de Estados Unidos, una dirección europea para una tienda europea). Los cambios posteriores se realizan a través de Editar información de la aplicación, Solo lista de direcciones IP y sitio de soporte, y se revisan nuevamente.
- Después de la aprobación, copia la App Key en
TEMU_APP_KEYy el App Secret enTEMU_APP_SECRET, y selecciona la región de la tienda enTEMU_REGION. - En el Centro de Vendedores abre Gestión del Sistema, Gestión de Autorizaciones (https://seller.temu.com/open-platform/client-manage, en Europa https://seller-eu.temu.com/open-platform/client-manage), haz clic en Autorizar una nueva aplicación, selecciona tu aplicación y los permisos, envía y copia el Token de Acceso en
TEMU_ACCESS_TOKEN.
El token de acceso caduca: la lista de autorizaciones en el Centro de Vendedores muestra la fecha, y temu_get_token_info la devuelve como expiredTime. Autoriza nuevamente y pega el nuevo token entonces; AnythingMCP no lo renueva.
Por dónde empezar: temu_get_token_info muestra la tienda (mallId, regionId), la caducidad y las operaciones que el token puede llamar. Luego temu_list_orders.
Pedidos: temu_list_orders, temu_get_order, temu_get_order_shipping_address (la dirección del comprador, datos personales), temu_get_order_amount. Una compra es un pedido principal (parentOrderSn, comienza con PO-) con un subpedido (orderSn) por línea de producto. Estados: 1 pendiente (no enviar aún), 2 esperando envío, 3 cancelado, 4 enviado, 41 parcialmente enviado, 5 entregado, 51 parcialmente entregado.
Envío: lee los transportistas con temu_list_carriers (pasa el id de la región) y los almacenes con temu_list_warehouses, luego temu_confirm_shipment con el id del transportista, el número de seguimiento, el id del almacén y las líneas del pedido. temu_list_combinable_orders lista los pedidos principales que pueden compartir un paquete. Verifica el resultado con temu_get_shipment y sigue el paquete con temu_get_tracking. Antes de enviar, mira temu_list_cancel_requests: temu_agree_cancel_request está instalado apagado porque cancela el pedido y reembolsa al comprador.
Productos, stock y precios: temu_list_products, temu_get_product, temu_list_skus, temu_list_categories. temu_get_stock y temu_update_stock leen y cambian el stock por SKU. temu_list_sku_prices lee el precio base, temu_change_sku_price solicita a Temu uno nuevo y temu_list_price_offers sigue la solicitud; las dos herramientas de pedido de precios solo funcionan para tiendas que Temu ha habilitado. temu_set_sale_status (retirar un producto de la venta) está instalado apagado.
Reembolsos y devoluciones: temu_list_after_sales los lista. Los reembolsos, etiquetas de devolución y decisiones de devolución no son parte de este conector.
Notas de campo
- Ids:
goodsIdes un producto,skuIduna variante, ambos números;outGoodsSnyoutSkuSnson tus propios códigos. Los números de pedido son texto. - Los tiempos en pedidos y post-venta son segundos Unix; los filtros de creación de las listas de productos son milisegundos Unix.
- El dinero es un objeto con
amountycurrency. Los montos de los pedidos dados como números enteros están en la unidad más pequeña de la moneda (centavos). - Una respuesta tiene
success,errorCode,errorMsgyresult. El conector informasuccess: falsecomo una llamada fallida. - Límite de tasa: 20 llamadas por segundo por aplicación al inicio; algunas operaciones tienen su propio límite (la lista de productos 20, las ofertas de precios 10 por segundo). El error 4000004 significa demasiadas llamadas.
Errores: 3000001 la firma es incorrecta (App Secret no pertenece a la App Key). 3000026 App Key desconocida. 3000031 token de acceso desconocido, 3000033 token y App Key no pertenecen juntos, 3000034 token caducado o reemplazado. 3000032 el vendedor no autorizó esta operación: autoriza nuevamente con el permiso marcado. 5000003 la dirección IP que llama no está en la lista de permitidos de la aplicación. 3000011 y 3000012: el reloj del servidor está desfasado más de 300 segundos.
No cubierto: etiquetas de envío de Temu (Buy-Shipping), recogidas, anuncios, promociones, creación y edición de productos, reembolsos.
Requisitos previos: TEMU_REGION, TEMU_APP_KEY, TEMU_APP_SECRET, TEMU_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 Temu y pega las variables de entorno listadas bajo Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
temu_get_token_info | Lee lo que representa el token de acceso: mallId, mallType (1 semi-gestionado, 100 local), regionId de la tienda (211 es Estados Unidos)… |
temu_list_orders | Lista los pedidos, los más nuevos primero. Devuelve totalItemNum y pageItems, cada uno con parentOrderMap (parentOrderSn, parentOrderStatus, parentOrderTime… |
temu_get_order | Lee un pedido principal con sus subpedidos: parentOrderMap (estado, pedido, tiempos de confirmación y envío más recientes, nombres de región, pago… |
temu_get_order_shipping_address | Lee la dirección de entrega de un pedido principal: receiptName, mobile, dirección de correo virtual, regionName1 a regionName4 (país, estado, ciudad… |
temu_get_order_amount | Lee los montos de un pedido principal: ingresos por ventas (precio base total, descuento del vendedor, envío, impuesto sobre productos y envío, estimado… |
temu_list_combinable_orders | Lista los grupos de pedidos principales que pueden enviarse juntos en un paquete (mismo comprador y dirección): combinedShippingGroups, cada uno una lista… |
temu_list_warehouses | Lista los almacenes de envío de la tienda: warehouseId, warehouseName, regionId1, defaultWarehouse, warehouseManagementType (0 cooperativo, 1… |
temu_list_carriers | Lista los transportistas que Temu acepta para una región: logisticsServiceProviderId (el carrierId de temu_confirm_shipment)… |
temu_confirm_shipment | Marca los pedidos como enviados con tu propio transportista y número de seguimiento: el pedido pasa de esperando envío a enviado y el comprador ve el… |
temu_get_shipment | Lee cómo se envió un pedido: shipmentInfoDTO con carrierId, carrierName, trackingNumber, skuId, quantity, packageSn… |
temu_get_tracking | Lee los eventos de seguimiento de un paquete: trackingNum (el número de última milla) y trackingInfo, cada uno con logisticsUpdatedAt (segundos Unix)… |
temu_list_products | Lista los productos de la tienda. Devuelve total y goodsList con goodsId, goodsName, specName, outGoodsSn (tu código de producto), estado y… |
temu_get_product | Lee un producto completo: goodsName, goodsDesc, bulletPoints, catId y catName, outGoodsSn, tipo de producto, galería (carrusel y detalle… |
temu_list_skus | Lista SKUs (variantes) a través de productos. Devuelve total y skuList con skuId, skuSn (tu código SKU), goodsId, goodsName, specName y… |
temu_get_stock | Lee el stock de SKUs: stockList por goodsId con skuStockInfoList (skuId, outSkuSn, selfOrdinaryStock, selfPreSaleStock y… |
temu_update_stock | Cambia el stock de SKUs de un producto: establece una cantidad objetivo (targets) o suma y resta (changes). Devuelve… |
temu_list_sku_prices | Lee el precio base actual (el precio que Temu paga al vendedor) de SKUs de un producto: por SKU skuId y supplierPrice con amount y… |
temu_list_price_offers | Lista ofertas de precios (pedidos de precios): evaluaciones de precios de Temu y solicitudes de cambio de precio con priceOrderId, goodsId, skuIdList, pricingType… |
temu_change_sku_price | Pide a Temu que cambie el precio base de SKUs de un producto. Devuelve successSkuList, failedSkuList con failedSkuReasonMap, y… |
temu_list_categories | Lista las categorías bajo una categoría principal: catId, catName, level, parentId, leaf (los productos solo van a categorías hoja), catType y… |
temu_set_sale_status | Retira un producto o algunos de sus SKUs de la venta, o los vuelve a poner a la venta. Fuera de la venta, los compradores ya no pueden pedirlo. Devuelve éxito.… |
temu_list_after_sales | Lista solicitudes de reembolso y devolución. Devuelve total y data con parentAfterSalesSn, parentOrderSn, afterSalesType (1 solo reembolso, 2 devolución y… |
temu_list_cancel_requests | Lista las solicitudes de los compradores para cancelar un pedido antes de que se envíe: total y data con parentAfterSalesSn, parentAfterSalesStatus y… |
temu_agree_cancel_request | Acepta la solicitud de un comprador para cancelar un pedido: el pedido se cancela y el comprador es reembolsado por Temu. No se puede deshacer. Instalado… |
Ejemplos de solicitudes
- "¿Qué pedidos de Temu están esperando ser enviados, y hay alguno que se pueda combinar?"
- "Confirma el envío del pedido PO-211-12345678901234 con seguimiento de UPS 1Z999AA10123456784."
- "¿Qué SKUs tienen menos de 10 unidades en stock?"
- "¿Hay solicitudes de cancelación que debería revisar antes de enviar hoy?"
- "¿Cuándo caduca mi token de acceso de Temu?"
Próximos pasos
¿Te ha sido útil esta guía?