Lemon Squeezy 자동화
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
예시 프롬프트:
"내 Lemon Squeezy 스토어에서 [email protected]의 모든 주문을 보여줘"
주문 주요 파라미터:
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 | 없음 (선택적 필터) |
Composio 제공