摘要
适用于本地商店卖家的 Temu 合作伙伴 API:包含买家地址和金额的订单,使用您自己的承运人和追踪号码确认发货,追踪、产品和 SKU、库存、基础价格、类别,以及退款、退货和取消请求。自开发的应用程序,带有 App Key、App Secret 和商店的访问令牌;调用经过签名。
引导式设置
2 分钟将 Temu 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Temu,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Temu 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 不需要安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Temu,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Temu
适用于本地商店卖家的 Temu 合作伙伴 API:包含买家地址和金额的订单,使用您自己的承运人和追踪号码确认发货,追踪、产品和 SKU、库存、基础价格、类别,以及退款、退货和取消请求。自开发的应用程序,带有 App Key、App Secret 和商店的访问令牌;调用经过签名。
设置
设置大约需要 20 分钟。你需要 Temu 对你应用的审核。
- 在 Temu 合作伙伴平台 (https://partner-us.temu.com 针对美国,https://partner-eu.temu.com 针对欧洲,https://partner.temu.com 针对其他国家) 创建一个账户,选择合作伙伴类型 自开发应用卖家 并链接你的卖家中心 主账户。一个卖家中心账户可以有一个自开发的应用。
- 填写应用信息和合规与安全问卷。合规部分的第 5 问询问你的调用来源的 IP 地址:输入此 AnythingMCP 服务器的出站 IP 地址。只有这些地址可以调用 API,中国的云服务提供商不被接受,服务器必须位于商店所在地区(美国商店使用美国地址,欧洲商店使用欧洲地址)。后续更改通过 编辑应用信息、仅 IP 地址列表和支持网站 进行,并再次审核。
- 审核通过后,将 App Key 复制到
TEMU_APP_KEY,将 App Secret 复制到TEMU_APP_SECRET,并在TEMU_REGION中选择商店的地区。 - 在卖家中心打开 系统管理,授权管理 (https://seller.temu.com/open-platform/client-manage,欧洲为 https://seller-eu.temu.com/open-platform/client-manage),点击 授权新应用,选择你的应用和权限,提交,并将 访问令牌 复制到
TEMU_ACCESS_TOKEN。
访问令牌会过期:卖家中心的授权列表显示日期,temu_get_token_info 返回 expiredTime。再次授权并粘贴新令牌;AnythingMCP 不会自动续期。
从哪里开始:temu_get_token_info 显示商店 (mallId, regionId)、过期时间和令牌可以调用的操作。然后是 temu_list_orders。
订单:temu_list_orders、temu_get_order、temu_get_order_shipping_address(买家地址,个人数据)、temu_get_order_amount。一个购买是一个父订单 (parentOrderSn,以 PO- 开头),每个产品行有一个子订单 (orderSn)。状态:1 待处理(尚未发货),2 待发货,3 已取消,4 已发货,41 部分发货,5 已交付,51 部分交付。
发货:使用 temu_list_carriers(传递区域 ID)读取承运人,使用 temu_list_warehouses 读取仓库,然后使用 temu_confirm_shipment 进行发货,包含承运人 ID、追踪号码、仓库 ID 和订单行。temu_list_combinable_orders 列出可以共享包裹的父订单。使用 temu_get_shipment 检查结果,并使用 temu_get_tracking 跟踪包裹。在发货前查看 temu_list_cancel_requests:temu_agree_cancel_request 默认关闭,因为它会取消订单并退款给买家。
产品、库存和价格:temu_list_products、temu_get_product、temu_list_skus、temu_list_categories。temu_get_stock 和 temu_update_stock 读取和更改每个 SKU 的库存。temu_list_sku_prices 读取基础价格,temu_change_sku_price 向 Temu 请求新的价格,temu_list_price_offers 跟踪请求;这两个价格订单工具仅适用于 Temu 已启用的商店。temu_set_sale_status(下架产品)默认关闭。
退款和退货:temu_list_after_sales 列出它们。退款、退货标签和退货决定不属于此连接器。
字段说明
- Ids:
goodsId是产品,skuId是变体,均为数字;outGoodsSn和outSkuSn是你自己的代码。订单号为文本。 - 订单和售后中的时间为 Unix 秒;产品列表的创建过滤器为 Unix 毫秒。
- 金钱是一个对象,包含
amount和currency。以整数形式给出的订单金额为货币的最小单位(分)。 - 答复包含
success、errorCode、errorMsg和result。连接器将success: false视为调用失败。 - 速率限制:每个应用开始时每秒 20 次调用;某些操作有自己的限制(产品列表 20 次,价格报价每秒 10 次)。错误 4000004 表示调用次数过多。
错误:3000001 签名错误(App Secret 不属于 App Key)。3000026 未知的 App Key。3000031 未知的访问令牌,3000033 令牌和 App Key 不匹配,3000034 令牌过期或被替换。3000032 卖家未授权此操作:再次授权并勾选权限。5000003 调用的 IP 地址不在应用的允许列表中。3000011 和 3000012:服务器时钟偏差超过 300 秒。
未涵盖:Temu 发货标签(Buy-Shipping)、取件、广告、促销、创建和编辑产品、退款。
前提条件:TEMU_REGION、TEMU_APP_KEY、TEMU_APP_SECRET、TEMU_ACCESS_TOKEN
本地安装连接器
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
打开 http://localhost:3000/connectors/store,选择 Temu 并粘贴前提条件下列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
temu_get_token_info | 读取访问令牌的含义:mallId、mallType(1 半托管,100 本地)、商店的 regionId(211 是美国)… |
temu_list_orders | 列出订单,最新的在前。返回 totalItemNum 和 pageItems,每个包含 parentOrderMap(parentOrderSn、parentOrderStatus、parentOrderTime… |
temu_get_order | 读取一个父订单及其子订单:parentOrderMap(状态、订单、确认和最新发货时间、区域名称、支付… |
temu_get_order_shipping_address | 读取一个父订单的送货地址:receiptName、mobile、虚拟邮件地址、regionName1 到 regionName4(国家、州、市… |
temu_get_order_amount | 读取一个父订单的金额:销售收入(基础价格总额、卖家折扣、运费、产品和运费税、估计… |
temu_list_combinable_orders | 列出可以一起发货的父订单组(相同买家和地址):combinedShippingGroups,每个为一个列表… |
temu_list_warehouses | 列出商店的发货仓库:warehouseId、warehouseName、regionId1、defaultWarehouse、warehouseManagementType(0 合作,1… |
temu_list_carriers | 列出 Temu 接受的区域承运人:logisticsServiceProviderId(temu_confirm_shipment 的 carrierId)… |
temu_confirm_shipment | 使用你自己的承运人和追踪号码标记订单为已发货:订单从待发货变为已发货,买家看到… |
temu_get_shipment | 读取一个订单的发货信息:shipmentInfoDTO 包含 carrierId、carrierName、trackingNumber、skuId、数量、packageSn… |
temu_get_tracking | 读取一个包裹的追踪事件:trackingNum(最后一公里号码)和 trackingInfo,每个包含 logisticsUpdatedAt(Unix 秒)… |
temu_list_products | 列出商店的产品。返回总数和 goodsList,包含 goodsId、goodsName、specName、outGoodsSn(你的产品代码)、状态和… |
temu_get_product | 读取一个完整的产品:goodsName、goodsDesc、bulletPoints、catId 和 catName、outGoodsSn、产品类型、画廊(轮播和详细… |
temu_list_skus | 列出产品的 SKU(变体)。返回总数和 skuList,包含 skuId、skuSn(你的 SKU 代码)、goodsId、goodsName、specName 和… |
temu_get_stock | 读取 SKU 的库存:每个 goodsId 的 stockList,包含 skuStockInfoList(skuId、outSkuSn、selfOrdinaryStock、selfPreSaleStock 和… |
temu_update_stock | 更改一个产品的 SKU 库存:设置为目标数量(targets)或增加和减少(changes)。返回… |
temu_list_sku_prices | 读取一个产品的 SKU 当前基础价格(Temu 支付给卖家的价格):每个 SKU skuId 和 supplierPrice,包含金额和… |
temu_list_price_offers | 列出价格报价(价格订单):Temu 的定价评估和价格变更请求,包含 priceOrderId、goodsId、skuIdList、pricingType… |
temu_change_sku_price | 请求 Temu 更改一个产品的 SKU 基础价格。返回 successSkuList、failedSkuList 和 failedSkuReasonMap,以及… |
temu_list_categories | 列出父类别下的类别:catId、catName、level、parentId、leaf(产品仅进入叶子类别)、catType 和… |
temu_set_sale_status | 将产品或其某些 SKU 下架,或重新上架。下架后,买家无法再订购。返回成功… |
temu_list_after_sales | 列出退款和退货请求。返回总数和数据,包含 parentAfterSalesSn、parentOrderSn、afterSalesType(1 仅退款,2 退货和… |
temu_list_cancel_requests | 列出买家在发货前请求取消订单的请求:总数和数据,包含 parentAfterSalesSn、parentAfterSalesStatus 和… |
temu_agree_cancel_request | 同意买家的请求取消订单:订单被取消,买家由 Temu 退款。此操作无法撤销。默认… |
示例提示
- “哪些 Temu 订单等待发货,是否有可组合的?”
- “确认订单 PO-211-12345678901234 的发货,使用 UPS 追踪 1Z999AA10123456784。”
- “哪些 SKU 库存少于 10 个?”
- “在今天发货之前,有没有我应该查看的取消请求?”
- “我的 Temu 访问令牌何时过期?”
下一步
这份指南对你有帮助吗?