用途：在需要读取或修改 Etsy 店铺资源时使用 Etsy Open API v3，涵盖 listing（创建草稿、更新元数据、上传图片/文件、管理视频、更新库存）、店铺（设置、分区、运费/处理/退货政策）、收据与订单交易、买卖家分类节点与属性，以及 webhook（创建/轮换端点、订阅事件、验签）。
主要能力与用法：包内提供参考文档与脚本。所有请求须带头 x-api-key: <ETSY_KEYSTRING>:<ETSY_SHARED_SECRET>；受限端点还须加 Authorization: Bearer <ETSY_OAUTH_USER_ID>.<ETSY_OAUTH_ACCESS_TOKEN>。可用 CLI 发起请求：python skills/etsy-api/scripts/etsy_cli.py request GET /v3/application/listings?state=active，POST/PUT 可用 --data（JSON）或 --form。OAuth 辅助：python skills/etsy-api/scripts/oauth_pkce.py auth-url --scopes "listings_r listings_w shops_r shops_w"，exchange-code 与 refresh-token 同理。webhook 本地验签：python skills/etsy-api/scripts/webhook_verify.py verify --secret "$ETSY_WEBHOOK_SIGNING_SECRET" --headers-json headers.json --body-file body.json。
限制与合规：Etsy 按应用限制 QPS 与 QPD（滚动 24 小时窗口），收到 HTTP 429 须遵守 retry-after 并指数退避；应缓存响应以降低用量。测试须遵守 Etsy 政策（使用草稿 listing、测试价格等）。不得打印或记录密钥、访问令牌、刷新令牌；不确定端点参数时查阅 OpenAPI 参考或规范。具体接口清单、错误码与政策细节以官方文档为准，资料未提供的不在此展开。