跨境Listing优化师

概述

根据产品信息生成一套可直接上架的跨境电商 Listing（标题、五点描述、产品描述、后台搜索词、关键词包），支持 Amazon / Temu / TikTok Shop / Shein / 独立站；也可以对现有 Listing 做诊断+优化。本 Skill 为按次付费服务，每次成功交付收费 0.10 元，费用由用户直接支付给创作者。

元数据

服务地址

Base URL：https://posterapi.aiulink.com

统一接口：POST {Base URL}/skillpay/v1/listing/invoke

付费前置检查

调用本 Skill 前，检查当前 Agent 是否已安装 weixinpay 插件：

• ✅ 已安装：可继续提供付费服务
• ❌ 未安装：向用户提示「当前 Agent 暂不支持微信支付付费能力」，终止流程

命中创作意图后，先向用户展示服务名称「跨境Listing优化师」和价格「0.10 元/次」，由用户确认后再进入付费流程。

工作流程

第一步：请求资源

POST {Base URL}/skillpay/v1/listing/invoke
Content-Type: application/json

{
  "product_info": "便携榨汁杯，USB-C 充电，450ml，6 叶刀头，目标人群为欧美健身人群",
  "platform": "amazon"
}

请求字段：

第二步：处理 402 响应

未支付时接口返回 HTTP 402。提取并同时保存以下两个值，两者缺一不可：

• Header WeixinPay-Required：支付码（payment_code）
• Header X-Out-Trade-No：商户订单号

第三步：发起支付

将第二步保存的 WeixinPay-Required 值作为 paymentCode，调用 weixinpay_pay 向用户申请支付授权，引导用户完成支付。

第四步：支付成功后获取结果（⚠️ 必须执行）

支付成功后必须重新请求本接口，否则永远拿不到结果：

POST {Base URL}/skillpay/v1/listing/invoke
Content-Type: application/json
WeixinPay-Required: <第二步保存的支付码>
X-Out-Trade-No: <第二步保存的订单号>

{"product_info": "...", "platform": "amazon"}   // body 与第一步完全一致，不得修改任何字段

• JSON body 必须与第一步原样一致，订单信息只通过 Header 传递
• 成功返回 HTTP 200，content.content 即 Listing 文案（Markdown），将全文展示给用户
• 若返回 "code": "NOT_PAID"，说明支付尚未完成，稍等几秒后原样重试
• 若返回 "code": "REFUNDED"，说明服务异常已自动全额退款：向用户说明「服务暂时不可用，款项已原路退回」，不要再次支付或重试

成功响应示例：

{
  "code": "SUCCESS",
  "message": "跨境 Listing 优化师已交付",
  "out_trade_no": "WX402_20260816120000abcdef123456",
  "transaction_id": "4200001234202608160000000001",
  "product_id": "dny-listing-pro",
  "content": {
    "content": "## 标题 Titlen...",
    "platform": "amazon",
    "language": "en"
  },
  "already_fulfilled": false
}

错误处理

计费说明

• 单价 0.10 元/次（以 SkillHub 后台配置为准），每笔订单支付成功后仅可履约一次
• 同一订单重复请求返回缓存结果（already_fulfilled: true），不重复扣费
• 支付成功但因服务异常未能交付时，系统自动全额退款，用户无需任何操作
• 订单有效期约 15 分钟，过期后重新发起即可生成新订单