How do I install the Gumroad skill?

Run npx skillmds@latest add johnalbertini14-glitch/gumroad in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Gumroad safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gumroad?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gumroad free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gumroad?

johnalbertini14-glitch (@johnalbertini14-glitch) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gumroad by johnalbertini14-glitch — Agent Skill

Name: Gumroad
Rating: 4.2 (5 reviews)
Author: johnalbertini14-glitch

File contents

Gumroad Analytics

Pull product and sales data from Gumroad's API for tracking and analysis.

Setup

Credentials: ~/.config/gumroad/credentials.json

{
  "access_token": "YOUR_GUMROAD_ACCESS_TOKEN",
  "created_at": "YYYY-MM-DD"
}

Get token: Gumroad → Settings → Advanced → Applications → Create Application

Quick Commands

Pull current stats

./scripts/gumroad-stats.sh

Pull and log daily metrics

./scripts/gumroad-daily.sh

Export sales data

./scripts/gumroad-sales.sh [--after YYYY-MM-DD] [--product PRODUCT_ID]

API Reference

Base URL: https://api.gumroad.com/v2

Auth: Authorization: Bearer ACCESS_TOKEN

Key Endpoints

Endpoint	Purpose
`GET /products`	All products with sales counts
`GET /sales`	Sales list with pagination
`GET /sales/:id`	Single sale details

Product Response Fields

name, id, short_url
sales_count, sales_usd_cents
price, formatted_price
published, deleted

Sales Response Fields

id, email, product_name
price, gumroad_fee
created_at, country
variants, custom_fields

Metrics Logging

Daily snapshots: memory/metrics/gumroad/YYYY-MM-DD.json

{
  "date": "2026-02-17",
  "products_count": 31,
  "published_count": 19,
  "top_products": [
    {"name": "Product", "sales": 9, "revenue_cents": 3300}
  ],
  "totals": {
    "sales": 100,
    "revenue_cents": 8100
  }
}

Analysis Patterns

Conversion Rate

conversion_rate = paid_sales / total_downloads
avg_sale_value = revenue_cents / sales_count

Trend Detection

Compare revenue_cents day-over-day. Alert if:

New sale (any revenue increase)
Revenue spike (>2x daily average)
First sale on a product

Correlation Tracking

Log engagement events (Moltbook posts, social) with timestamps. Compare to sales timing to identify what drives conversions.

Limitations

No traffic sources via API — visible in dashboard only
No funnel data — views/clicks not exposed
Rate limit: ~500 req/hour (generous)

---name: gumroaddescription: Pull analytics from Gumroad API. Track products, sales, revenue, and conversion rates. Use for daily stats, trend analysis, and correlating marketing efforts with sales.---# Gumroad AnalyticsPull product and sales data from Gumroad's API for tracking and analysis.## Setup**Credentials:** `~/.config/gumroad/credentials.json````json{ "access_token": "YOUR_GUMROAD_ACCESS_TOKEN", "created_at": "YYYY-MM-DD"}```Get token: Gumroad → Settings → Advanced → Applications → Create Application## Quick Commands### Pull current stats```bash./scripts/gumroad-stats.sh```### Pull and log daily metrics```bash./scripts/gumroad-daily.sh```### Export sales data```bash./scripts/gumroad-sales.sh [--after YYYY-MM-DD] [--product PRODUCT_ID]```## API Reference**Base URL:** `https://api.gumroad.com/v2`**Auth:** `Authorization: Bearer ACCESS_TOKEN`### Key Endpoints| Endpoint | Purpose ||----------|---------|| `GET /products` | All products with sales counts || `GET /sales` | Sales list with pagination || `GET /sales/:id` | Single sale details |### Product Response Fields- `name`, `id`, `short_url`- `sales_count`, `sales_usd_cents`- `price`, `formatted_price`- `published`, `deleted`### Sales Response Fields- `id`, `email`, `product_name`- `price`, `gumroad_fee`- `created_at`, `country`- `variants`, `custom_fields`## Metrics LoggingDaily snapshots: `memory/metrics/gumroad/YYYY-MM-DD.json````json{ "date": "2026-02-17", "products_count": 31, "published_count": 19, "top_products": [ {"name": "Product", "sales": 9, "revenue_cents": 3300} ], "totals": { "sales": 100, "revenue_cents": 8100 }}```## Analysis Patterns### Conversion Rate```conversion_rate = paid_sales / total_downloadsavg_sale_value = revenue_cents / sales_count```### Trend DetectionCompare `revenue_cents` day-over-day. Alert if:- New sale (any revenue increase)- Revenue spike (>2x daily average)- First sale on a product### Correlation TrackingLog engagement events (Moltbook posts, social) with timestamps. Compare to sales timing to identify what drives conversions.## Limitations- **No traffic sources via API** — visible in dashboard only- **No funnel data** — views/clicks not exposed- **Rate limit:** ~500 req/hour (generous)

Frequently asked questions

Gumroad