Etsy 数字商品自动上架

要解决什么问题

在 Etsy 上卖数字商品，每上新一条 listing 都要在后台重复填标题、价格、描述和交付方式。店铺 SKU 多、或需要按固定模板批量铺货时，纯手工既慢也容易抄错字段。Etsy 提供 Open API v3，但 OAuth、Shop ID 和 listing 草稿状态等细节，第一次接往往要翻文档试好几轮。

技能如何工作

本技能围绕 Etsy 官方 API 做草稿级自动刊登，而不是直接对外上架。

• 凭证与店铺：在开发者后台注册应用，将 ETSY_CLIENT_KEY、ETSY_CLIENT_SECRET 和 ETSY_SHOP_ID 配置为密钥；Shop ID 可从店铺 URL etsy.com/shop/{shop_id} 取得。
• OAuth 2.0：Etsy 个人访问令牌必须通过授权流获取；配合 scripts/oauth_helper.py 打开授权 URL、回填 code 完成绑定。
• 批量创建：scripts/create_listings.py 按预设商品信息调用 API，生成 listing 草稿（技能文档中的示例包括定价不同的 PDF / 指南类数字品）。

Agent 侧可按 SKILL 指引串联上述步骤，减少你在「配密钥 → 拿 token → 调创建接口」之间的上下文切换。

适用边界与注意点

• API 创建的是草稿，需在 Etsy 店铺后台手动发布；刻意不自动公开发布，是为降低触发平台审核或风控标记的风险。
• 文档中的示例商品名与标价仅作演示，实际店铺应替换为你自己的数字资产与合规文案。
• 令牌与密钥属于高敏感信息，应只放在受控的 Secrets 配置中，避免写进对话或仓库明文。