Gumroad 자동화
자연어 명령을 통해 Gumroad 스토어를 자동화하세요 — 제품 목록, 판매 추적, 라이선스 확인, 실시간 웹훅 관리까지.
툴킷 문서: 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월부터 prod_ABC123 제품의 모든 Gumroad 판매를 보여줘"
주요 매개변수:
after— ISO8601 형식의 날짜/시간으로, 이후 판매를 필터링 (예:2025-01-01T00:00:00Z)before— ISO8601 형식의 날짜/시간으로, 이전 판매를 필터링email— 고객 이메일 주소로 필터링product_id— 특정 제품 ID로 필터링page— 페이지네이션 결과의 페이지 번호 (최소 1)
3. 라이선스 키 확인
라이선스 키가 특정 제품에 대해 유효한지 확인하고, 사용 횟수를 검사하거나 멤버십 자격을 검증합니다.
도구: GUMROAD_VERIFY_LICENSE
예시 프롬프트:
"prod_ABC123 제품의 라이선스 키 ABCD-EFGH-IJKL-MNOP를 확인해 줘"
주요 매개변수 (모두 필수):
product_id— 확인할 제품 ID (2023년 1월 9일 이후 생성된 제품 필수)license_key— 라이선스 키 문자열 (예:ABCD-EFGH-IJKL-MNOP)increment_uses_count— 사용 횟수를 증가시킬지 여부 (기본값: true)
4. 웹훅 이벤트 구독
엔드포인트 URL을 특정 Gumroad 리소스 이벤트에 구독하여 실시간 이벤트 알림을 설정합니다.
도구: GUMROAD_SUBSCRIBE_TO_RESOURCE
예시 프롬프트:
"내 웹훅 https://example.com/hook 을 Gumroad 판매 이벤트에 구독해 줘"
주요 매개변수 (모두 필수):
resource_name— 다음 중 하나:sale,refund,dispute,dispute_won,cancellation,subscription_updated,subscription_ended,subscription_restartedpost_url— HTTP POST 알림을 수신할 엔드포인트 URL
5. 활성 웹훅 구독 목록 조회
중복을 피하기 위해 새 웹훅을 추가하기 전에 특정 리소스 유형에 대한 기존 웹훅 구독을 검토합니다.
도구: GUMROAD_GET_RESOURCE_SUBSCRIPTIONS
예시 프롬프트:
"내 모든 활성 Gumroad 웹훅 구독을 판매 이벤트 기준으로 보여줘"
주요 매개변수 (필수):
resource_name— 8가지 지원 이벤트 유형 중 하나 (예:sale,refund)
알려진 주의사항
- 라이선스 확인 시 제품 ID 필요: 2023년 1월 9일 이후 생성된 제품은
product_id매개변수가 필수입니다. 이전 제품은 없어도 동작할 수 있지만 제공하는 것이 좋습니다. - 판매 결과 페이지네이션: 판매 결과는 페이지로 나뉩니다.
page매개변수를 증가시켜 더 많은 페이지가 있는지 항상 확인하세요. - 웹훅 중복 방지: 리소스에 구독하기 전에
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 |
| 웹훅 구독 목록 | GUMROAD_GET_RESOURCE_SUBSCRIPTIONS | resource_name |
Powered by Composio