gumroad-analytics_skill

Overview

This skill pulls analytics from the Gumroad API to track products, sales, revenue, and conversion rates. It provides daily snapshots, exports sales, and helps correlate marketing activity with sales performance. Designed for routine reporting and lightweight trend detection.

How this skill works

The skill reads a Gumroad access token from a credentials file and calls the Gumroad v2 API endpoints for products and sales. It aggregates product counts, sales totals, and revenue in daily JSON snapshots and can export paginated sales lists. Built-in checks flag new sales, large revenue spikes, and first-time product sales.

When to use it

• Daily reporting of sales, revenue, and top products
• Exporting historical sales for bookkeeping or analysis
• Detecting sudden revenue spikes or first-sale events
• Correlating marketing posts or campaigns with sales timing
• Feeding lightweight trend data into dashboards or alerts

Best practices

• Store the access token in ~/.config/gumroad/credentials.json and rotate it when needed
• Run daily snapshots to memory/metrics/gumroad/YYYY-MM-DD.json for consistent trend analysis
• Respect API rate limits (~500 requests/hour) by using pagination and caching
• Log engagement events with timestamps to enable simple correlation analysis
• Aggregate revenue in cents to avoid floating-point rounding issues

Example use cases

• Automate a morning script that writes daily sales totals and top products to a metrics folder
• Export sales since a campaign start date to measure conversion from a specific promotion
• Detect a >2x revenue spike and trigger a Slack alert for the growth team
• Generate a weekly report showing conversion rate and average sale value per product
• Archive all historical sales data for accounting or backup purposes