name: Gumroad自动化 description: “通过Composio MCP集成使用自然语言自动化Gumroad产品管理、销售跟踪、许可证验证和webhook订阅。” category: 电子商务 requires: mcp: - rube
Gumroad自动化
自动化您的Gumroad商店——列出产品、跟踪销售、验证许可证和管理实时webhook——全部通过自然语言命令实现。
工具包文档: composio.dev/toolkits/gumroad
设置
- 将Composio MCP服务器添加到您的客户端配置:
https://rube.app/mcp - 在提示时连接您的Gumroad账户(API密钥认证)。
- 开始发出自然语言命令来管理您的Gumroad商店。
核心工作流
1. 列出所有产品
检索您已验证Gumroad账户中的所有产品,以获取产品ID用于下游操作。
工具: GUMROAD_LIST_PRODUCTS
示例提示:
“列出我所有的Gumroad产品”
参数: 无需参数——返回已验证账户的所有产品。
2. 带过滤器的销售跟踪
检索成功的销售,可选的过滤器包括电子邮件、日期范围、产品或分页。
工具: GUMROAD_GET_SALES
示例提示:
“显示我所有Gumroad销售,来自2025年1月,产品prod_ABC123”
关键参数:
after– ISO8601日期/时间,过滤此时间之后的销售(例如,2025-01-01T00:00:00Z)before– ISO8601日期/时间,过滤此时间之前的销售email– 按客户电子邮件地址过滤product_id– 按特定产品ID过滤page– 分页结果的页码(最小1)
3. 验证许可证密钥
检查许可证密钥是否对特定产品有效,检查使用次数,或验证会员资格。
工具: GUMROAD_VERIFY_LICENSE
示例提示:
“验证产品prod_ABC123的许可证密钥ABCD-EFGH-IJKL-MNOP”
关键参数(全部必需):
product_id– 要验证的产品ID(2023年1月9日或之后创建的产品必需)license_key– 许可证密钥字符串(例如,ABCD-EFGH-IJKL-MNOP)increment_uses_count– 是否增加使用次数(默认为true)
4. 订阅Webhook事件
通过将您的端点URL订阅到特定Gumroad资源事件,设置实时事件通知。
工具: GUMROAD_SUBSCRIBE_TO_RESOURCE
示例提示:
“将我的webhook https://example.com/hook 订阅到Gumroad销售事件”
关键参数(全部必需):
resource_name– 其中之一:sale,refund,dispute,dispute_won,cancellation,subscription_updated,subscription_ended,subscription_restartedpost_url– 接收HTTP POST通知的端点URL
5. 列出活动Webhook订阅
在添加新订阅之前,查看给定资源类型的现有webhook订阅,以避免重复。
工具: GUMROAD_GET_RESOURCE_SUBSCRIPTIONS
示例提示:
“显示我所有活动的Gumroad webhook订阅,针对销售事件”
关键参数(必需):
resource_name– 八个支持的事件类型之一(例如,sale,refund)
已知陷阱
- 许可证验证需要产品ID: 2023年1月9日或之后创建的产品需要
product_id参数。较旧的产品可能不需要,但建议提供。 - 销售分页: 销售结果是分页的。始终通过增加
page参数检查是否有更多页面。 - Webhook去重: 在订阅资源之前,使用
GUMROAD_GET_RESOURCE_SUBSCRIPTIONS检查现有订阅,避免重复webhook。 - ISO8601日期格式: 销售日期过滤器必须使用ISO8601格式(例如,
2025-01-01T00:00:00Z),而不是普通日期。
快速参考
| 操作 | 工具Slug | 必需参数 |
|---|---|---|
| 列出产品 | GUMROAD_LIST_PRODUCTS |
无 |
| 获取销售 | GUMROAD_GET_SALES |
无(所有过滤器可选) |
| 验证许可证 | GUMROAD_VERIFY_LICENSE |
product_id, license_key |
| 订阅事件 | GUMROAD_SUBSCRIBE_TO_RESOURCE |
resource_name, post_url |
| 列出webhook订阅 | GUMROAD_GET_RESOURCE_SUBSCRIPTIONS |
resource_name |
由Composio提供支持