Lemon Squeezy Automation
Lemon Squeezy のデジタルプロダクトビジネスを管理——注文の追跡、サブスクリプションの監視、顧客の分析、割引の確認、チェックアウトの監査——すべて自然言語コマンドで行えます。
ツールキットドキュメント: composio.dev/toolkits/lemon_squeezy
セットアップ
- Composio MCP サーバーをクライアント設定に追加します:
https://rube.app/mcp - プロンプトに従って Lemon Squeezy アカウントを接続します(API キー認証)。
- 自然言語コマンドを発行してストアを管理します。
コアワークフロー
1. ストアと製品の表示
すべてのストアを一覧表示してストア ID を取得し、特定のストアの製品とバリアントを取得します。
ツール: LEMON_SQUEEZY_LIST_ALL_STORES、LEMON_SQUEEZY_LIST_ALL_PRODUCTS、LEMON_SQUEEZY_LIST_ALL_VARIANTS
プロンプト例:
「すべての Lemon Squeezy ストアとその製品を一覧表示して」
主要パラメータ:
LEMON_SQUEEZY_LIST_ALL_STORES— パラメータ不要LEMON_SQUEEZY_LIST_ALL_PRODUCTS—filter[store_id]でフィルタリングLEMON_SQUEEZY_LIST_ALL_VARIANTS—filter[product_id]、filter[status](pending/draft/published)でフィルタリング
2. 注文と注文アイテムの追跡
ストア、ユーザーのメールアドレス、注文番号によるオプションのフィルタリングで全注文を取得し、個別の注文アイテムにドリルダウンします。
ツール: LEMON_SQUEEZY_LIST_ALL_ORDERS、LEMON_SQUEEZY_LIST_ALL_ORDER_ITEMS
プロンプト例:
「[email protected] からの全注文を Lemon Squeezy ストアで表示して」
注文の主要パラメータ:
filter[store_id]— ストア ID でフィルタリングfilter[user_email]— 顧客メールでフィルタリングfilter[order_number]— 特定の注文番号でフィルタリングpage[number]/page[size]— ページネーション(最大100件/ページ)
注文アイテムの主要パラメータ:
filter[order_id]、filter[product_id]、filter[variant_id]— 関連エンティティでフィルタリング
3. サブスクリプションの監視
豊富なフィルタリングオプションで全サブスクリプションを一覧表示し、定期収益を追跡します。
ツール: LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTIONS
プロンプト例:
「Lemon Squeezy ストアのアクティブなサブスクリプションをすべて表示して」
主要パラメータ:
filter[status]— ステータスでフィルタリング(例:active、cancelled)filter[store_id]— ストアでフィルタリングfilter[product_id]— 製品でフィルタリングfilter[user_email]— 購読者メールでフィルタリングfilter[variant_id]— バリアントでフィルタリングpage[number]/page[size]— ページネーション(最大100件/ページ)
4. 顧客の管理
メール、MRR、総収益、カスタマーポータル URL を含む顧客レコードを取得します。
ツール: LEMON_SQUEEZY_LIST_ALL_CUSTOMERS
プロンプト例:
「メールアドレス [email protected] の Lemon Squeezy 顧客を検索して」
主要パラメータ:
filter[email]— 正確なメールアドレスでフィルタリングfilter[store_id]— ストア ID でフィルタリングpage[number]/page[size]— ページネーション(最大100件/ページ)
5. 割引と利用状況の監査
すべての割引コードを一覧表示し、注文全体での利用履歴を追跡します。
ツール: LEMON_SQUEEZY_LIST_ALL_DISCOUNTS、LEMON_SQUEEZY_LIST_ALL_DISCOUNT_REDEMPTIONS
プロンプト例:
「ストア 12345 のすべての割引とその利用履歴を表示して」
割引の主要パラメータ:
filter[store_id]— ストアでフィルタリングpage[number]/page[size]— ページネーション
利用状況の主要パラメータ:
filter[discount_id]— 割引でフィルタリングfilter[order_id]— 注文でフィルタリング
6. チェックアウトのレビュー
ストアまたはバリアントによるオプションのフィルタリングで、すべてのチェックアウトセッションを一覧表示します。
ツール: LEMON_SQUEEZY_LIST_ALL_CHECKOUTS
プロンプト例:
「Lemon Squeezy ストアのバリアント 42 のチェックアウトをすべて表示して」
主要パラメータ:
filter[store_id]— ストア ID でフィルタリングfilter[variant_id]— バリアント ID でフィルタリング
既知の落とし穴
- ストア ID が基本: ほとんどのフィルターには
store_idが必要です。他のリソースをフィルタリングする前に、必ずLEMON_SQUEEZY_LIST_ALL_STORESを呼び出して有効なストア ID を確認してください。 - 大規模データセットにはページネーションが必須: すべての一覧エンドポイントで
page[number]/page[size]によるページネーション(最大100件/ページ)を使用します。最初のページで完結しているとは想定しないでください。 - フィルターパラメータの命名: Lemon Squeezy ではフィルターにブラケット記法(例:
filter[store_id]、page[number])を使用します。正確なパラメータ名を使用してください。 - サブスクリプション請求書と注文の違い: サブスクリプション請求書(
LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTION_INVOICES)は一回限りの注文とは別です。ユースケースに応じて適切なエンドポイントを使用してください。
クイックリファレンス
| アクション | ツールスラッグ | 必須パラメータ |
|---|---|---|
| ストア一覧 | LEMON_SQUEEZY_LIST_ALL_STORES | なし |
| 製品一覧 | LEMON_SQUEEZY_LIST_ALL_PRODUCTS | なし(オプションフィルターあり) |
| バリアント一覧 | LEMON_SQUEEZY_LIST_ALL_VARIANTS | なし(オプションフィルターあり) |
| 注文一覧 | LEMON_SQUEEZY_LIST_ALL_ORDERS | なし(オプションフィルターあり) |
| 注文アイテム一覧 | LEMON_SQUEEZY_LIST_ALL_ORDER_ITEMS | なし(オプションフィルターあり) |
| サブスクリプション一覧 | LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTIONS | なし(オプションフィルターあり) |
| 顧客一覧 | LEMON_SQUEEZY_LIST_ALL_CUSTOMERS | なし(オプションフィルターあり) |
| 割引一覧 | LEMON_SQUEEZY_LIST_ALL_DISCOUNTS | なし(オプションフィルターあり) |
| 割引利用履歴一覧 | LEMON_SQUEEZY_LIST_ALL_DISCOUNT_REDEMPTIONS | なし(オプションフィルターあり) |
| チェックアウト一覧 | LEMON_SQUEEZY_LIST_ALL_CHECKOUTS | なし(オプションフィルターあり) |
Powered by Composio