跳到主要内容

让你的 AI Agent 连接 Etsy

找到自己的店铺,检查商品和库存,整理已付款但尚未发货的订单。

每月 20,000 次免费应用调用(付费服务另计)

试试这些 Etsy 任务

将提示词复制到已安装 oo Skill 的 Agent,补充页面链接和原始笔记后执行。

oo SkillEtsy

检查店铺库存

列出店铺商品并检查某件商品的变体库存。

/oo Etsy: 找到我的 Etsy 店铺,列出在售商品,再检查 [商品 ID] 的库存,汇总返回的数量和 SKU。

准备已付款订单发货

查找已付款但尚未发货的订单,查看购买明细。

/oo Etsy: 查找我的 Etsy 店铺已付款但尚未发货的订单,查看每张收据的购买明细,汇总需要打包的商品。

登记包裹发货

登记承运商和运单号,并向买家发送发货通知。

/oo Etsy: 为 Etsy 店铺 [店铺 ID] 的收据 [收据 ID] 登记发货,承运商为 [承运商]、运单号为 [运单号],并通知买家。

开始使用 Etsy

  1. 安装 OOMOL

    在 Agent 中配置 oo CLI 和 oo Skill。

    安装 OOMOL →
  2. 连接 Etsy

    使用自己的 Etsy OAuth 应用连接。

    连接 Etsy→
  3. 向 Agent 交代任务

    使用 /oo,说明要读取的页面、修改的内容和保存位置。

    连接指南 →
  • Etsy 账号及已获批准的应用:https://www.etsy.com/developers/your-apps。
  • 将应用 keystring 填入 Client ID,同一应用的 shared secret 填入 Shared Secret。
  • 在同一 Etsy 应用中登记 Connector 显示的完整 HTTPS 回调地址。
  • 默认权限包含账号识别、商品读取、订单读取和发货更新。缩小申请范围时保留 shops_r。
  • 登记发货和读取部分地址字段可能需要所在地区的合作伙伴权限,token 有效并不代表有权访问。

Etsy 工具

使用自己的应用连接 Etsy 账号,查询店铺商品、库存和订单收据,登记物流信息并通知买家。

找到自己的店铺

查询账号标识、店铺详情和分区。

检查商品和库存

查询商品、关联资源、翻译和变体库存。

查看订单并登记发货

筛选订单收据,检查购买条目并登记发货详情。

11 个工具

Get Me

获取已连接 Etsy 账号的用户 ID 和店铺 ID。

etsy.get_me

Get Shop

获取 Etsy 店铺的公开详情。

etsy.get_shop

Get Shop By Owner

通过店主用户 ID 获取 Etsy 店铺。

etsy.get_shop_by_owner

List Shop Sections

列出 Etsy 店铺的分区。

etsy.list_shop_sections

List Shop Listings

按状态列出 Etsy 店铺商品,使用 limit/offset 分页。

etsy.list_shop_listings

Get Listing

获取 Etsy 商品,可包含关联资源和翻译。

etsy.get_listing

Get Listing Inventory

读取自己商品的库存;未使用 Etsy 库存工具的商品可能没有库存记录。

etsy.get_listing_inventory

List Receipts

按日期、付款、发货、送达及取消状态查询 Etsy 订单收据。地址可见性取决于所在地区的 Etsy 合作伙伴权限。

etsy.list_receipts

Get Receipt

获取 Etsy 订单收据及可用的物流和付款详情。地址可见性取决于所在地区的 Etsy 合作伙伴权限。

etsy.get_receipt

List Receipt Transactions

列出 Etsy 订单收据中的购买条目。

etsy.list_receipt_transactions

Create Receipt Shipment

登记 Etsy 发货,每次成功调用都会向买家发送邮件。省略运单号和承运商可仅标记发货;美国境内超过 10 美元及寄往印度的订单必须提供两者。不支持的承运商使用 other。即使凭据和权限有效,仍可能受地区合作伙伴资格限制。

etsy.create_receipt_shipment

常见问题

登记发货会通知买家吗?

会,每次成功提交发货信息都会发送买家邮件。将 send_bcc 设为 true 可同时通知卖家。此操作登记发货,不购买物流面单。

为什么能查看订单,却不能登记发货?

Etsy 在部分地区实施合作伙伴限制,即使已有 transactions_w,应用仍可能需要履约合作伙伴资格。部分地址字段也受限制。

如何获取更多商品或收据?

使用 limit 和 offset。Etsy 默认每页返回 25 条,每次最多 100 条;增加 offset 可获取下一页。