技能介绍

要解决什么问题

在 Gumroad 上卖数字产品时，日常操作往往分散在后台页面、导出表格和自写脚本之间：查某段时间的销售、核对买家许可证是否有效、给自建系统接 sale / refund 等事件，都要对着 API 文档反复查参数。若你已经在用支持 MCP 的 AI 客户端，更希望用自然语言完成这些动作，而不是每次手写 HTTP 请求。

技能如何工作

本技能通过 Composio 的 Gumroad 工具集，把常见店铺运维封装成可对话调用的能力。接入 MCP 并用 API Key 绑定 Gumroad 账号后，可按意图触发对应工具，例如：

GUMROAD_LIST_PRODUCTS：拉取账号下全部商品，拿到后续操作所需的 product_id。
GUMROAD_GET_SALES：按邮箱、商品、after / before（ISO8601）、page 等条件查成交记录；结果分页，需递增 page 翻页。
GUMROAD_VERIFY_LICENSE：对指定 product_id 与 license_key 做校验，并可选择是否递增使用次数（increment_uses_count）。
GUMROAD_SUBSCRIBE_TO_RESOURCE / GUMROAD_GET_RESOURCE_SUBSCRIPTIONS：向 post_url 订阅 sale、refund 等八种资源事件，或先列出已有订阅，避免重复注册。

典型说法如：「列出我所有 Gumroad 商品」「查 2025 年 1 月 prod_ABC123 的销售」「验证某 license 是否属于该商品」。

适用边界与注意点

2023 年 1 月 9 日及之后创建的商品，验 license 必须带 product_id；旧商品有时可省略，仍建议始终传入。
销售查询日期过滤必须用 ISO8601（如 2025-01-01T00:00:00Z），不要用纯日期字符串。
新增 Webhook 前先 GUMROAD_GET_RESOURCE_SUBSCRIPTIONS，避免同一 resource_name 重复订阅。
能力边界以 Composio Gumroad 工具为准（文档：composio.dev/toolkits/gumroad），不包含 Gumroad 后台 UI 未暴露或未接入的工具行为。