Gumroad Automation
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
プロンプト例:
"2025年1月のGumroad売上を表示して。商品IDはprod_ABC123"
主なパラメータ:
after— このISO8601日時より後の売上をフィルタ（例：2025-01-01T00:00:00Z）before— このISO8601日時より前の売上をフィルタemail— 顧客メールアドレスでフィルタproduct_id— 特定の商品IDでフィルタpage— ページネーションのページ番号（最小1）
3. ライセンスキー検証
特定の商品に対してライセンスキーが有効かどうか、使用回数、メンバーシップ権限を確認します。
ツール: GUMROAD_VERIFY_LICENSE
プロンプト例:
"ライセンスキーABCD-EFGH-IJKL-MNOPを商品prod_ABC123に対して検証して"
主なパラメータ（すべて必須）:
product_id— 検証対象の商品ID（2023年1月9日以降に作成された商品では必須）license_key— ライセンスキー文字列（例：ABCD-EFGH-IJKL-MNOP）increment_uses_count— 使用回数を増やすかどうか（デフォルトはtrue）
4. Webhookイベント購読
特定のGumroadリソースイベントに対してエンドポイントURLを購読し、リアルタイム通知を受け取ります。
ツール: 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— 8つのサポートされているイベントタイプのいずれか（例：sale,refund）
既知の注意点
- ライセンス検証には商品IDが必要: 2023年1月9日以降に作成された商品では
product_idパラメータが必須です。古い商品では省略できる場合もありますが、指定することを推奨します。 - 売上のページネーション: 売上結果はページネーションされます。
pageパラメータを増やして次のページが存在するか確認してください。 - Webhookの重複防止: リソースを購読する前に
GUMROAD_GET_RESOURCE_SUBSCRIPTIONSで既存の購読を確認し、重複を避けてください。 - ISO8601日付形式: 売上の日付フィルタはISO8601形式（例：
2025-01-01T00:00:00Z）を使用する必要があり、単純な日付では機能しません。
クイックリファレンス
| アクション | ツールスラッグ | 必須パラメータ |
|---|---|---|
| 商品一覧 | 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 |
Powered by Composio