ComposioHQ/Gumroad-Automation

Gumroad-Automatisierung

Automatisieren Sie Ihren Gumroad-Storefront – listen Sie Produkte auf, verfolgen Sie Verkäufe, überprüfen Sie Lizenzen und verwalten Sie Echtzeit-Webhooks – alles über natürliche Sprachbefehle.

Toolkit-Dokumentation: composio.dev/toolkits/gumroad

---

Einrichtung

1. Fügen Sie den Composio MCP-Server zu Ihrer Client-Konfiguration hinzu:

   https://rube.app/mcp
   

2. Verbinden Sie Ihr Gumroad-Konto, wenn Sie dazu aufgefordert werden (API-Schlüssel-Authentifizierung).
3. Beginnen Sie damit, natürliche Sprachbefehle zur Verwaltung Ihres Gumroad-Stores zu geben.

---

Kern-Workflows

1. Alle Produkte auflisten

Rufen Sie jedes Produkt in Ihrem authentifizierten Gumroad-Konto ab, um Produkt-IDs für nachgelagerte Operationen zu erhalten.

Tool: GUMROAD_LIST_PRODUCTS

Beispielaufforderung:

„Liste alle meine Gumroad-Produkte auf“

Parameter: Keine erforderlich – gibt alle Produkte für das authentifizierte Konto zurück.

---

2. Verkäufe mit Filtern verfolgen

Rufen Sie erfolgreiche Verkäufe mit optionaler Filterung nach E-Mail, Datumsbereich, Produkt oder Paginierung ab.

Tool: GUMROAD_GET_SALES

Beispielaufforderung:

„Zeige mir alle Gumroad-Verkäufe ab Januar 2025 für Produkt prod_ABC123“

Wichtige Parameter:

• after – ISO8601-Datum/-Uhrzeit, um Verkäufe danach zu filtern (z. B. 2025-01-01T00:00:00Z)
• before – ISO8601-Datum/-Uhrzeit, um Verkäufe davor zu filtern
• email – Filtern nach Kunden-E-Mail-Adresse
• product_id – Filtern nach einer bestimmten Produkt-ID
• page – Seitenzahl für paginierte Ergebnisse (mindestens 1)

---

3. Lizenzschlüssel überprüfen

Prüfen Sie, ob ein Lizenzschlüssel für ein bestimmtes Produkt gültig ist, sehen Sie sich die Nutzungsanzahl an oder überprüfen Sie die Mitgliedschaftsberechtigung.

Tool: GUMROAD_VERIFY_LICENSE

Beispielaufforderung:

„Überprüfe den Lizenzschlüssel ABCD-EFGH-IJKL-MNOP für Produkt prod_ABC123“

Wichtige Parameter (alle erforderlich):

• product_id – Die Produkt-ID, gegen die überprüft werden soll (erforderlich für Produkte, die am oder nach dem 9. Januar 2023 erstellt wurden)
• license_key – Der Lizenzschlüssel-String (z. B. ABCD-EFGH-IJKL-MNOP)
• increment_uses_count – Ob die Nutzungsanzahl erhöht werden soll (standardmäßig true)

---

4. Webhook-Ereignisse abonnieren

Richten Sie Echtzeit-Benachrichtigungen ein, indem Sie Ihre Endpunkt-URL für bestimmte Gumroad-Ressourcenereignisse abonnieren.

Tool: GUMROAD_SUBSCRIBE_TO_RESOURCE

Beispielaufforderung:

„Abonniere meinen Webhook https://example.com/hook für Gumroad-Verkaufsereignisse“

Wichtige Parameter (alle erforderlich):

• resource_name – Einer von: sale, refund, dispute, dispute_won, cancellation, subscription_updated, subscription_ended, subscription_restarted
• post_url – Ihre Endpunkt-URL, die HTTP-POST-Benachrichtigungen empfängt

---

5. Aktive Webhook-Abonnements auflisten

Überprüfen Sie vorhandene Webhook-Abonnements für einen bestimmten Ressourcentyp, bevor Sie neue hinzufügen, um Duplikate zu vermeiden.

Tool: GUMROAD_GET_RESOURCE_SUBSCRIPTIONS

Beispielaufforderung:

„Zeige alle meine aktiven Gumroad-Webhook-Abonnements für Verkaufsereignisse an“

Wichtige Parameter (erforderlich):

• resource_name – Einer der acht unterstützten Ereignistypen (z. B. sale, refund)

---

Bekannte Fallstricke

• Produkt-ID für Lizenzprüfung erforderlich: Für Produkte, die am oder nach dem 9. Januar 2023 erstellt wurden, ist der Parameter product_id erforderlich. Ältere Produkte funktionieren möglicherweise auch ohne, aber es wird empfohlen, ihn anzugeben.
• Paginierung bei Verkäufen: Verkaufsergebnisse sind paginiert. Überprüfen Sie immer, ob weitere Seiten existieren, indem Sie den Parameter page erhöhen.
• Webhook-Deduplizierung: Verwenden Sie vor dem Abonnieren einer Ressource GUMROAD_GET_RESOURCE_SUBSCRIPTIONS, um vorhandene Abonnements zu prüfen und doppelte Webhooks zu vermeiden.
• ISO8601-Datumsformat: Datumsfilter für Verkäufe müssen das ISO8601-Format verwenden (z. B. 2025-01-01T00:00:00Z), nicht einfache Daten.

---

Kurzreferenz

Aktion	Tool-Slug	Erforderliche Parameter
Produkte auflisten	GUMROAD_LIST_PRODUCTS	Keine
Verkäufe abrufen	GUMROAD_GET_SALES	Keine (alle optionalen Filter)
Lizenz überprüfen	GUMROAD_VERIFY_LICENSE	product_id, license_key
Ereignisse abonnieren	GUMROAD_SUBSCRIBE_TO_RESOURCE	resource_name, post_url
Webhook-Abonnements auflisten	GUMROAD_GET_RESOURCE_SUBSCRIPTIONS	resource_name

---

Betrieben von Composio