Agent Skills
返回列表
Coupang 卖家助手

Coupang 卖家助手

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_703b13ae/coupang-seller。

技能介绍

要解决的问题

Coupang Open API 的接入并不轻松:开发者要自己拼装 CEA 签名、管理多店铺凭证、维护分页与限流重试逻辑,108 个接口分布在 12 个业务领域,逐个对接成本很高。排错更麻烦:调用方 IP 没加进 WING 后台白名单时,网关返回的是 HTTP 200 + text/html 的 "Access denied" 页面而非标准错误码,很容易被误判成接口本身有问题。

技能的工作方式

技能内置一个 Python 客户端(scripts/coupang_client.py),把签名、鉴权、请求、重试、分页全部封装成业务模块函数,只依赖标准库,不用 pip 装第三方包。执行流程分四步:

  1. 店铺选择决策:每次任务先检查已配置店铺状态,按 create、use_single、ask_select、invalid_profile 四种情形差异化处理;多店铺意图自动识别并批量分发,单店失败不影响其他店。
  2. 凭证管理:YAML 配置文件(~/.coupang/credentials.yaml)管理多店铺凭证,自动设 600 权限并脱敏;解析优先级为构造参数 → profile 指定店铺 → default → 环境变量。
  3. 模块调用:12 个业务模块对应 12 个函数前缀(products_*、shipments_*、cgf_* 等);各模块端点与字段说明放在 references/ 目录,大文件用 Grep 检索。
  4. 结果解析:统一检查 code 与 data / message 字段;分页接口递归拉取直到 nextToken 为空;失败时区分签名错误、时间戳过期等常见原因。

边界与注意点

  • IP 白名单是硬门槛:调用方公网 IP 必须先加入 WING 后台,否则所有请求被 WAF 拦截。
  • 限流与时钟:默认约 10 QPS,收到 429 按指数退避重试;CEA 时间戳有效期约 5 分钟,服务器需校准 UTC 时钟。
  • 时区约定:业务时间参数一律使用 Asia/Seoul(UTC+9),日期格式 YYYYMMDD。
  • 多站点隔离:韩国本地店与跨境店使用不同的 base URL,每店独立配置 base_url 与 market。
  • 密钥安全:SECRET_KEY 不得进入对话、日志或 Git 仓库;用户在对话中直接提供凭证时,技能会提醒事后轮换。

使用场景

  • 店铺运营专员需要批量修改商品价格,不用逐个打开编辑页面操作
  • 客服人员需要查询并回复顾客咨询,同时跟进退货换货的申请状态
  • 跨境卖家需要同时管理韩国主店和跨境店,汇总所有店铺的销售数据
  • 运营工程师需要在发货后上传运单号,及时更新订单的配送状态

适合人员

  • 电商店铺运营专员,日常需要批量改价、上下架商品、处理订单
  • 客服专员,需要在平台聊天中回复顾客咨询并处理退换货
  • 跨境卖家,需要同时运营多个Coupang店铺并汇总经营数据
  • 运营工程师,需要通过脚本自动化日常运营工作流减少手动操作