Coupang 卖家助手
将以下提示词粘贴到你的 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 装第三方包。执行流程分四步:
- 店铺选择决策:每次任务先检查已配置店铺状态,按
create、use_single、ask_select、invalid_profile四种情形差异化处理;多店铺意图自动识别并批量分发,单店失败不影响其他店。 - 凭证管理:YAML 配置文件(
~/.coupang/credentials.yaml)管理多店铺凭证,自动设 600 权限并脱敏;解析优先级为构造参数 →profile指定店铺 →default→ 环境变量。 - 模块调用:12 个业务模块对应 12 个函数前缀(
products_*、shipments_*、cgf_*等);各模块端点与字段说明放在references/目录,大文件用 Grep 检索。 - 结果解析:统一检查
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店铺并汇总经营数据
- 运营工程师,需要通过脚本自动化日常运营工作流减少手动操作