ComposioHQ/Lemon-Squeezy-Automation

Lemon Squeezy Automation

Verwalten Sie Ihr Lemon Squeezy Digitalprodukte-Geschäft – verfolgen Sie Bestellungen, überwachen Sie Abonnements, analysieren Sie Kunden, prüfen Sie Rabatte und auditieren Sie Checkouts – alles über natürlichsprachliche Befehle.

Toolkit-Dokumentation: composio.dev/toolkits/lemon_squeezy

---

Einrichtung

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

   https://rube.app/mcp
   

2. Verbinden Sie Ihr Lemon Squeezy-Konto, wenn Sie dazu aufgefordert werden (API-Schlüssel-Authentifizierung).
3. Beginnen Sie, natürlichsprachliche Befehle zur Verwaltung Ihres Stores zu geben.

---

Kern-Workflows

1. Stores und Produkte entdecken

Listen Sie alle Stores auf, um Store-IDs zu erhalten, und rufen Sie dann Produkte und Varianten für einen bestimmten Store ab.

Tools: LEMON_SQUEEZY_LIST_ALL_STORES, LEMON_SQUEEZY_LIST_ALL_PRODUCTS, LEMON_SQUEEZY_LIST_ALL_VARIANTS

Beispielaufforderung:

„Liste alle meine Lemon Squeezy Stores und deren Produkte auf“

Wichtige Parameter:

• LEMON_SQUEEZY_LIST_ALL_STORES – Keine Parameter erforderlich
• LEMON_SQUEEZY_LIST_ALL_PRODUCTS – Filtern nach filter[store_id]
• LEMON_SQUEEZY_LIST_ALL_VARIANTS – Filtern nach filter[product_id], filter[status] (pending/draft/published)

---

2. Bestellungen und Bestellpositionen verfolgen

Rufen Sie alle Bestellungen mit optionaler Filterung nach Store, Benutzer-E-Mail oder Bestellnummer ab und bohren Sie in einzelne Bestellpositionen.

Tools: LEMON_SQUEEZY_LIST_ALL_ORDERS, LEMON_SQUEEZY_LIST_ALL_ORDER_ITEMS

Beispielaufforderung:

„Zeige alle Bestellungen von [email protected] in meinem Lemon Squeezy Store“

Wichtige Parameter für Bestellungen:

• filter[store_id] – Filtern nach Store-ID
• filter[user_email] – Filtern nach Kunden-E-Mail
• filter[order_number] – Filtern nach bestimmter Bestellnummer
• page[number] / page[size] – Paginierung (max. 100 pro Seite)

Wichtige Parameter für Bestellpositionen:

• filter[order_id], filter[product_id], filter[variant_id] – Filtern nach zugehöriger Entität

---

3. Abonnements überwachen

Listen Sie alle Abonnements mit umfangreichen Filteroptionen auf, um wiederkehrende Einnahmen zu verfolgen.

Tool: LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTIONS

Beispielaufforderung:

„Zeige alle aktiven Abonnements in meinem Lemon Squeezy Store“

Wichtige Parameter:

• filter[status] – Filtern nach Status (z. B. active, cancelled)
• filter[store_id] – Filtern nach Store
• filter[product_id] – Filtern nach Produkt
• filter[user_email] – Filtern nach Abonnenten-E-Mail
• filter[variant_id] – Filtern nach Variante
• page[number] / page[size] – Paginierung (max. 100 pro Seite)

---

4. Kunden verwalten

Rufen Sie Kundendatensätze mit Details wie E-Mail, MRR, Gesamtumsatz und Kundenportal-URLs ab.

Tool: LEMON_SQUEEZY_LIST_ALL_CUSTOMERS

Beispielaufforderung:

„Finde den Lemon Squeezy-Kunden mit der E-Mail [email protected]“

Wichtige Parameter:

• filter[email] – Filtern nach exakter E-Mail-Adresse
• filter[store_id] – Filtern nach Store-ID
• page[number] / page[size] – Paginierung (max. 100 pro Seite)

---

5. Rabatte und Einlösungen auditieren

Listen Sie alle Rabattcodes auf und verfolgen Sie, wie sie über Bestellungen hinweg eingelöst wurden.

Tools: LEMON_SQUEEZY_LIST_ALL_DISCOUNTS, LEMON_SQUEEZY_LIST_ALL_DISCOUNT_REDEMPTIONS

Beispielaufforderung:

„Zeige alle Rabatte für Store 12345 und deren Einlösungshistorie“

Wichtige Parameter für Rabatte:

• filter[store_id] – Filtern nach Store
• page[number] / page[size] – Paginierung

Wichtige Parameter für Einlösungen:

• filter[discount_id] – Filtern nach Rabatt
• filter[order_id] – Filtern nach Bestellung

---

6. Checkouts prüfen

Listen Sie alle Checkout-Sitzungen mit optionaler Filterung nach Store oder Variante auf.

Tool: LEMON_SQUEEZY_LIST_ALL_CHECKOUTS

Beispielaufforderung:

„Zeige alle Checkouts für Variante 42 in meinem Lemon Squeezy Store“

Wichtige Parameter:

• filter[store_id] – Filtern nach Store-ID
• filter[variant_id] – Filtern nach Varianten-ID

---

Bekannte Fallstricke

• Store-ID ist grundlegend: Die meisten Filter benötigen eine store_id. Rufen Sie immer zuerst LEMON_SQUEEZY_LIST_ALL_STORES auf, um gültige Store-IDs zu ermitteln, bevor Sie andere Ressourcen filtern.
• Paginierung ist bei großen Datensätzen obligatorisch: Alle Listen-Endpunkte verwenden die page[number]/page[size]-Paginierung (max. 100 pro Seite). Gehen Sie nicht davon aus, dass die erste Seite vollständig ist.
• Benennung der Filterparameter: Lemon Squeezy verwendet Klammernotation für Filter (z. B. filter[store_id], page[number]). Stellen Sie sicher, dass die exakten Parameternamen verwendet werden.
• Abrechnungsrechnungen vs. Bestellungen: Abonnementrechnungen (LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTION_INVOICES) sind getrennt von einmaligen Bestellungen. Verwenden Sie den für Ihren Anwendungsfall geeigneten Endpunkt.

---

Kurzreferenz

Aktion	Tool-Slug	Erforderliche Parameter
Stores auflisten	LEMON_SQUEEZY_LIST_ALL_STORES	Keine
Produkte auflisten	LEMON_SQUEEZY_LIST_ALL_PRODUCTS	Keine (optionale Filter)
Varianten auflisten	LEMON_SQUEEZY_LIST_ALL_VARIANTS	Keine (optionale Filter)
Bestellungen auflisten	LEMON_SQUEEZY_LIST_ALL_ORDERS	Keine (optionale Filter)
Bestellpositionen auflisten	LEMON_SQUEEZY_LIST_ALL_ORDER_ITEMS	Keine (optionale Filter)
Abonnements auflisten	LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTIONS	Keine (optionale Filter)
Kunden auflisten	LEMON_SQUEEZY_LIST_ALL_CUSTOMERS	Keine (optionale Filter)
Rabatte auflisten	LEMON_SQUEEZY_LIST_ALL_DISCOUNTS	Keine (optionale Filter)
Rabatteinlösungen auflisten	LEMON_SQUEEZY_LIST_ALL_DISCOUNT_REDEMPTIONS	Keine (optionale Filter)
Checkouts auflisten	LEMON_SQUEEZY_LIST_ALL_CHECKOUTS	Keine (optionale Filter)

---

Bereitgestellt von Composio