编程

Temu全球站-促销

试用

Temu 全球站电商促销 API,经 LinkFox 网关转发 Partner Global Promotion / 促销活动 相关 bg/temu 接口(活动创建、报名、查询、优惠券/秒杀等,接口将按 Partner 文档逐条接入)。当用户提到 Temu Global 促销、促销活动、优惠券、秒杀、活动报名、promotion campaign、product-inventory 促销 时触发。商品管理用 linkfox-temu-manage-product-global;价格用 linkfox-temu-price-global;订单用 linkfox-temu-order-global。

它能做什么

Temu 全球站电商促销 API,经 LinkFox 网关转发 Partner Global Promotion / 促销活动 相关 bg/temu 接口(活动创建、报名、查询、优惠券/秒杀等,接口将按 Partner 文档逐条接入)。当用户提到 Temu Global 促销、促销活动、优惠券、秒杀、活动报名、promotion campaign、product-inventory 促销 时触发。商品管理用 linkfox-temu-manage-product-global;价格用 linkfox-temu-price-global;订单用 linkfox-temu-order-global。

技能文档

Temu 全球站 — 电商促销(Promotion)

本 skill(linkfox-temu-promotion-global)覆盖 Partner Platform for Global Promotion / 电商促销(促销活动、优惠券、活动报名等;Partner 后台菜单可能显示为 Marketing/Promotion)相关 bg.* / temu.* 接口(menu_code 与各 sub_menu_code 以 Partner 后台为准,见 partner-global-catalog.md)。

已接入 6 条 Partner Promotion 接口,清单见 partner-global-catalog.md

网关(本 skill 内置)

能力方法路径
促销 OpenAPI(global_promotion_*temu_global_proxyPOSThttps://tool-gateway.linkfox.com/temu/proxy
加签文件下载POSThttps://tool-gateway.linkfox.com/temu/fileDownload

相关 skill

场景skill
促销/营销活动(本 skill)linkfox-temu-promotion-global
广告 Adslinkfox-temu-ads-us
商品列表/详情/编辑/库存/上下架linkfox-temu-manage-product-global
发品linkfox-temu-add-product-us
价格/供货价、定价单linkfox-temu-price-global
订单列表/详情linkfox-temu-order-global
退货与退款linkfox-temu-returns-refunds-global
网关与 Temu token本 skill scripts/

调用方式

  • API 端点POST /temu/proxy(不同操作通过请求体区分;完整参数/响应/错误码见 references/api.md
  • Python 脚本python scripts/<脚本名>.py '' [--inline](可用脚本见上文脚本一览)
  • 成本约束:本工具会消耗积分;失败/空结果不得自动换关键词、翻页或连续试探;需要继续检索时先向用户说明会产生额外消耗。

输出策略(脚本默认行为)

  • 始终将完整响应写入 /linkfox///data/-.json 为脚本执行时的工作目录,在 Claude Code 里即当前项目目录; 取自环境变量 SESSION_ID,按用户任务自动聚合;禁止写入 /tmp,当前目录不可写则报错)
  • 响应体 ≤ 8 KB:落盘后把完整 JSON 打印到 stdout
  • 响应体 > 8 KB:落盘后 stdout 只输出摘要(顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本)
  • --inline 强制全量打印到 stdout(同样落盘)

读数据建议:先看摘要判断是否足够;需要具体字段时优先用 jqConvertFrom-Json 从保存的 json 文件按需抽取,避免整份 JSON 进入上下文。

解决认证和积分问题

发生以下异常情况时,采用 references/onboarding.md 引导解决问题:

异常情况

  • 未配置API Key:环境变量未配置 LINKFOX_AGENT_API_KEY,也未配置 LINKFOXAGENT_API_KEY
  • 响应401或402状态码
  • 响应提示积分或余额不足:消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值",或类似含义的内容。

默认参数

字段默认说明
siteglobalPartner Global
managementTypesemi-managed半托管(具体接口以 Partner 文档为准)
tokenPurposeproduct-inventory与商品/促销场景一致(见 access-token.md

鉴权

  1. LinkFoxLINKFOXAGENT_API_KEY → Header Authorization + Token
  2. TemuaccessTokenstoreKeystoreKey 时建议带 tokenPurpose=product-inventory

Scripts

脚本说明
temu_global_proxy.py任意 type
temu_global_file_download.py加签下载
global_promotion_activity_query.pybg.promotion.activity.query
global_promotion_activity_candidate_goods_query.pybg.promotion.activity.candidate.goods.query
global_promotion_activity_goods_query.pybg.promotion.activity.goods.query
global_promotion_activity_goods_enroll.pybg.promotion.activity.goods.enroll
global_promotion_activity_goods_operation_query.pybg.promotion.activity.goods.operation.query
global_promotion_activity_goods_update.pybg.promotion.activity.goods.update

接入新接口(约定)

你每提供一条 Partner 文档(type + sub_menu_code + URL + Request/Response 参数表),将:

  1. 新增 references/apis/.md(完整入参/出参层级)
  2. 新增 scripts/global_promotion_.py(调用 _global_promotion_script.run_cli
  3. 更新 partner-global-catalog.mdapis/README.md 与本表

示例(通用代理)

export LINKFOXAGENT_API_KEY=""

python scripts/temu_global_proxy.py '{
  "accessToken": "TOKEN",
  "tokenPurpose": "product-inventory",
  "type": "",
  "params": {
    "request": {}
  }
}'

Feedback: skillNamelinkfox-temu-promotion-global

网关与授权脚本

脚本说明
check_linkfox_token.py校验 LinkFox 用户 Token
temu_token_guide.pyTemu accessToken 后台授权步骤
save_temu_access_token.py保存 accessToken 到本地
list_temu_access_tokens.py列出已保存 token
get_temu_access_token.py读取已保存 token
temu_proxy.py通用网关转发(多 site)
temu_file_download.py加签文件下载(多 site)

授权说明:references/access-token.md

积分消耗规则

不消耗积分。

相关技能

Temu 美国站电商促销 API,经 LinkFox 网关转发 Partner US Promotion / 促销活动 相关 bg/temu 接口(活动创建、报名、查询、优惠券/秒杀等,接口将按 Partner 文档逐条接入)。当用户提到 Temu US 促销、促销活动、优惠券、秒杀、活动报名、promotion campaign、product-inventory 促销 时触发。商品管理用 linkfox-temu-manage-product-us;价格用 linkfox-temu-price-us;订单用 linkfox-temu-order-us。

13 次安装

Temu 欧洲站电商促销 API,经 LinkFox 网关转发 Partner EU Promotion / 促销活动 相关 bg/temu 接口(活动创建、报名、查询、优惠券/秒杀等,接口将按 Partner 文档逐条接入)。当用户提到 Temu EU 促销、促销活动、优惠券、秒杀、活动报名、promotion campaign、product-inventory 促销 时触发。商品管理用 linkfox-temu-manage-product-eu;价格用 linkfox-temu-price-eu;订单用 linkfox-temu-order-eu。

13 次安装

Temu 全球站电商广告 Ads API,经 LinkFox 网关转发 Partner Global Ads / 广告投放 相关 bg/temu 接口(广告计划、广告组、创意、报表、预算出价等,接口将按 Partner 文档逐条接入)。当用户提到 Temu Global 广告、Ads、广告投放、广告计划、广告组、创意、出价、预算、广告报表、ad campaign、product-inventory 广告 时触发。商品管理用 linkfox-temu-manage-product-global;促销用 linkfox-temu-promotion-global;订单用 linkfox-temu-order-global。

11 次安装

Temu 全球站(非 US/EU)价格/供货价 API,经 LinkFox 网关转发 5 个接口(定价单、推荐价、SKU 供货价列表、批量改价等),默认 site=global。当用户提到 Temu Global 价格、全球站定价单、priceorder query、sku list price、查 SKU 供货价、改供货价、recommendedprice、baseprice recommend 时触发。美国站用 linkfox-temu-price-us;欧洲站用 linkfox-temu-price-eu;商品管理用 linkfox-temu-manage-product-global。

12 次安装

Temu 全球站(非 US/EU)订单管理 API,经 LinkFox 网关转发 9 个 bg.order.* / temu.order.* / temu.local.order.* 接口,默认 site=global、tokenPurpose=order-shipping。当用户提到 Temu Global 订单、全球站订单列表、parentOrderSn、订单金额 V2、temu.order.amount.v2.query、合并发货、SN鉴真、verification upload 时触发。美国站用 linkfox-temu-order-us;欧洲站用 linkfox-temu-order-eu;商品用 linkfox-temu-manage-product-global;价格用 linkfox-temu-price-global。

12 次安装

Temu 全球站(非 US/EU)商品管理 Manage Product API,经 LinkFox 网关转发 24 个 bg.local/temu.local 接口,默认 site=global。当用户提到 Temu Global Manage Product、全球站商品、site=global 商品上下架、改库存、bg.local.goods 时触发。美国站用 linkfox-temu-manage-product-us;欧洲站用 linkfox-temu-manage-product-eu;发品/价格/促销/广告/订单等其它域用对应 skill 并设 site=global。

12 次安装