linkfox-temu-promotion-us
管理 Temu 美国站促销活动,支持活动与候选商品查询、报名商品、查询异步操作结果、查看已报名商品、调整活动价和数量、停用活动商品、增加活动 SKU 及加签资源下载。适用于美国站已授权店铺的秒杀、大促和清仓活动运营;不适用于广告投放、普通商品维护、日常定价、订单或售后管理,未定义的独立优惠券操作也不在范围内。
SKILL.mdskills/linkfox-temu-promotion-us/SKILL.md
GitHubTemu 美国站电商促销
适用范围
适用
管理已授权 Temu 美国站店铺的促销活动,从查询活动和候选商品,到报名、核验异步结果及维护活动商品。Partner 后台可能将该菜单显示为 Promotion 或 Marketing。
场景速查
| 用户表达 | 查询场景 |
|---|---|
| 查一下美国站有哪些可参加的大促或秒杀 | 查询活动及报名状态。 |
| 哪些商品能报名,推荐活动价是多少 | 查询候选商品、推荐价与推荐数量。 |
| 把这些商品报入指定活动 | 核对目标活动、商品、SKU、价格与数量后报名。 |
| 上次提交的报名或更新处理完了吗 | 用草稿线索查询异步操作结果。 |
| 看已报名商品的活动价与剩余名额 | 查询已报名商品。 |
| 调整活动价、增加活动名额、停用商品或加 SKU | 按用户指定的变更维护活动商品。 |
| 下载 Temu 的加签资源 | 使用已授权店铺下载指定资源。 |
边界
广告投放转交 linkfox-temu-ads-us,普通商品维护转交 linkfox-temu-manage-product-us,发品转交 linkfox-temu-add-product-us,日常价格转交 linkfox-temu-price-us,订单与售后分别转交 linkfox-temu-order-us、linkfox-temu-returns-refunds-us。欧洲站、全球站促销使用对应站点技能。
接口清单
| 接口 | 端点 | 接口文档 | 对应脚本 | 说明 |
|---|---|---|---|---|
活动候选商品查询(bg.promotion.activity.candidate.goods.query) |
POST /temu/proxy → US path:/openapi/router;Body type:bg.promotion.activity.candidate.goods.query |
references/apis/bg-promotion-activity-candidate-goods-query.md |
scripts/us_promotion_activity_candidate_goods_query.py |
活动候选商品查询。 |
活动商品报名(bg.promotion.activity.goods.enroll) |
POST /temu/proxy → US path:/openapi/router;Body type:bg.promotion.activity.goods.enroll |
references/apis/bg-promotion-activity-goods-enroll.md |
scripts/us_promotion_activity_goods_enroll.py |
活动商品报名。 |
活动商品操作结果查询(bg.promotion.activity.goods.operation.query) |
POST /temu/proxy → US path:/openapi/router;Body type:bg.promotion.activity.goods.operation.query |
references/apis/bg-promotion-activity-goods-operation-query.md |
scripts/us_promotion_activity_goods_operation_query.py |
活动商品操作结果查询。 |
活动已报名商品查询(bg.promotion.activity.goods.query) |
POST /temu/proxy → US path:/openapi/router;Body type:bg.promotion.activity.goods.query |
references/apis/bg-promotion-activity-goods-query.md |
scripts/us_promotion_activity_goods_query.py |
活动已报名商品查询。 |
活动商品更新(bg.promotion.activity.goods.update) |
POST /temu/proxy → US path:/openapi/router;Body type:bg.promotion.activity.goods.update |
references/apis/bg-promotion-activity-goods-update.md |
scripts/us_promotion_activity_goods_update.py |
活动商品更新。 |
促销活动查询(bg.promotion.activity.query) |
POST /temu/proxy → US path:/openapi/router;Body type:bg.promotion.activity.query |
references/apis/bg-promotion-activity-query.md |
scripts/us_promotion_activity_query.py |
促销活动查询。 |
| 加签文件下载 | POST /temu/fileDownload |
references/api.md |
scripts/temu_us_file_download.py、scripts/temu_file_download.py |
下载指定加签资源。 |
通用入口 scripts/temu_us_proxy.py 与 scripts/temu_proxy.py 复用代理端点;前者使用美国站默认值,后者支持多站点参数。Partner 菜单和接口文档索引见 references/partner-us-catalog.md。
前置条件
准备 LinkFox 密钥与目标 Temu 店铺的授权令牌,明确店铺、站点和本次活动运营范围。Temu 令牌由用户在卖家后台手动授权并复制;本技能保留本地保存、列出、读取及授权步骤脚本,见 references/access-token.md 与 references/authorization-flow.md。参数默认值、认证兼容及 CLI 约定见 references/api.md。
促销操作流程
- 明确目标店铺与用户范围,查询可参加或已参加的活动。
- 取得目标活动后,查询候选商品、是否可报名以及推荐活动价和数量。
- 按用户指定范围准备报名;提交后保存草稿线索。
- 查询草稿对应的异步报名或更新结果;按任务需要继续核验,避免无限轮询。
- 查询已报名商品,展示实际活动价、活动数量及剩余名额。
- 需要改价、改量、停用或加 SKU 时,按用户指定的变更提交更新,再查询异步结果。
只执行任务需要的步骤;单项查询不要求先跑完整流程。上述操作的完整入参、条件限制和结果解释见各接口文档。
执行方式
- 直接调用接口:接口端点、完整参数、响应和错误码见
references/api.md。 - 脚本调用(推荐):
python <脚本路径> '<JSON 参数>' [--inline] [--no-cache]。 - 成本约束:本工具不消耗算力 (限时)。同一会话、同一参数组合默认只调用一次,优先复用已保存的响应;业务封装不读取或写入 API 响应缓存。失败或空结果时,不得自动扩大查询范围或连续试探;后续查询与异步轮询按用户任务需要进行。
输出策略
- 始终保存完整响应,目标路径为
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-temu-promotion-us-<timestamp>.json。<cwd>为脚本运行时的工作目录,<session>优先取环境变量SESSION_ID,用于聚合同一任务的数据。禁止写入/tmp,当前目录不可写时应报错。 - 序列化响应的 UTF-8 字节数不超过 8000:保存后,将完整 JSON 打印到标准输出。
- 序列化响应的 UTF-8 字节数超过 8000:保存后,标准输出仅展示摘要,包括顶层字段、顶层实际返回的常见指标(如
total、costToken),以及最大非空列表字段的长度和前 3 条样本。 - 添加
--inline可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
执行规则
算力消耗预估
不消耗算力 (限时)。
声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
解决认证和算力问题
出现以下情况时,按 references/onboarding.md 的指引处理:
- 未配置接口密钥:
LINKFOX_AGENT_API_KEY和LINKFOXAGENT_API_KEY均为空。 - HTTP 状态码为
401或402。 - 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
约束与建议
- 响应缓存:本技能业务封装不缓存 API 响应;调用器选项与输出规则见 references/api.md。
- 区分两套认证:LinkFox 密钥用于网关,Temu 店铺令牌用于店铺业务;不得相互替代。授权应用、子账号、过期、多站点与 IP 白名单要求见授权参考。
- 清晰展示结果:先注明店铺和活动,再用表格列出候选、已报名商品、SKU 活动价和数量,标明本次返回范围及后续页是否可查。
- 区分提交与完成:保留草稿线索、操作状态和失败原因;异步请求已提交不能视为报名或更新完成。
- 按实际数据说明金额与时间:保留响应原始金额单位、币种和时间含义;金额缩放、时区及状态枚举须有明确信息才能解释,不得自行推定,时间展示转换时标注时区。
- 核对变更影响:报名、更新活动价或数量、停用商品及新增 SKU 都会改变店铺活动数据;按用户已明确的目标与范围执行,避免扩大变更或因结果不确定而重复提交。
- 解释空结果与错误:保留已获得的数据,依据接口参考说明原因;额外查询与轮询遵守成本约束。
使用示例
查询候选商品
用户:看看这场美国站大促可以报哪些商品,推荐什么活动价。
确认目标店铺与活动,查询候选商品,用表格展示是否可报名、推荐价格及数量。
报名并核验结果
用户:按这些价格和数量报名指定活动。
核对活动、商品和 SKU,按指定范围提交报名,保存草稿线索,查询异步结果并说明处理状态。
更新活动商品
用户:增加这个商品的活动名额,并确认更新结果。
读取已有活动商品,按接口参考核对可更新条件后提交,查询草稿处理状态及已报名商品数据。
使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。
更多优质、专业的跨境电商技能,请访问 LinkFox Skill。