← Back to Skills Marketplace
vladchatware

Gumroad Analytics

by Vlad Rimsha · GitHub ↗ · v1.0.1
cross-platform ✓ Security Clean
438
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install gumroad-analytics
Description
Pull daily Gumroad product/sales analytics safely (no raw PII persistence by default).
README (SKILL.md)

Gumroad Analytics

Collect Gumroad analytics in a privacy-conscious way.

What this skill does

  • Fetches sales and products from Gumroad API
  • Produces a daily summary JSON (counts + revenue totals)
  • Does not store raw API payloads by default

Credentials

Expected file: ~/.config/gumroad/credentials.json

Example:

{
  "access_token": "YOUR_GUMROAD_ACCESS_TOKEN"
}

Harden permissions:

chmod 600 ~/.config/gumroad/credentials.json

Run

bash skills/gumroad-analytics/scripts/fetch_metrics.sh

Optional raw storage (explicit opt-in):

bash skills/gumroad-analytics/scripts/fetch_metrics.sh --store-raw

Output

Summary file (default):

  • memory/metrics/gumroad/YYYY-MM-DD-summary.json

Raw files (only with --store-raw):

  • memory/metrics/gumroad/YYYY-MM-DD-raw-sales-redacted.json
  • memory/metrics/gumroad/YYYY-MM-DD-raw-products.json

Notes

  • Sales raw output is redacted before writing (email and buyer name fields removed).
  • If you do not need raw data, avoid --store-raw.
Usage Guidance
This skill appears to do what it says, but take these precautions before installing or running it: - Verify the credentials file (~/.config/gumroad/credentials.json) exists and contains only the Gumroad access token; keep file permissions restrictive (chmod 600) as recommended. - Be cautious with --store-raw: inspect the raw-output redaction logic and confirm it removes all PII fields you consider sensitive (the script only removes keys 'email','full_name','name','buyer_email'). - The script sends the token as a URL query parameter, which can be captured in logs; if you prefer, run in a controlled environment or modify the script to use an Authorization header if Gumroad supports it. - Note the script respects an optional GUMROAD_CREDENTIALS_FILE env var (not documented in SKILL.md) — if you rely on that, ensure its value points to the intended file. - As with any third-party script, inspect the code yourself and run it in an isolated environment if you have concerns about credential exposure or file writes.
Capability Analysis
Type: OpenClaw Skill Name: gumroad-analytics Version: 1.0.1 The skill bundle is benign. It fetches Gumroad analytics data, processes it, and stores summaries locally in the designated 'memory' directory. Credentials are read from a specified local file (`~/.config/gumroad/credentials.json`). The `SKILL.md` instructions are clear and do not contain prompt injection attempts. The `fetch_metrics.sh` script uses `curl` to interact with the legitimate Gumroad API (`api.gumroad.com`) and includes a Python script to redact PII (email, name) from raw sales data before optional storage, demonstrating a privacy-conscious design. No evidence of data exfiltration to unauthorized endpoints, persistence mechanisms, or other malicious behaviors was found.
Capability Assessment
Purpose & Capability
Name/description match the implementation: the script requires curl/python3/date and a Gumroad credentials JSON, calls api.gumroad.com/v2/sales and /products, computes a daily summary, and writes outputs under memory/metrics/gumroad. No unrelated services, binaries, or credentials are requested.
Instruction Scope
SKILL.md just instructs the agent to run the included shell script. The script only reads the declared credentials file (or an optional override), makes HTTPS calls to Gumroad, writes a summary file, and optionally writes redacted raw files when --store-raw is passed. It does not read other system files or transmit data to unexpected endpoints.
Install Mechanism
No install spec — instruction-only plus a small bundled shell script. Nothing is downloaded or written outside the working directory except the output files under memory/metrics/gumroad. This is low-risk and proportionate for the stated purpose.
Credentials
The skill declares no required environment variables, but the script will honor an optional GUMROAD_CREDENTIALS_FILE env var as an override (not documented in SKILL.md). The primary credential is a local credentials.json file, which is appropriate. Note: the script passes the access token as a query parameter in curl requests (access_token=...), which can be logged in some systems — consider using an Authorization header if Gumroad supports it. Also verify that redaction covers any PII fields you care about before enabling --store-raw.
Persistence & Privilege
always is false and the skill does not modify other skills or global agent configuration. It writes output only to memory/metrics/gumroad within the workspace and does not persist raw payloads unless explicitly requested by the user.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install gumroad-analytics
  3. After installation, invoke the skill by name or use /gumroad-analytics
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Declare required config/binaries; default to summary-only storage; raw data is explicit opt-in with sales redaction; add homepage metadata.
v1.0.0
Initial release of Gumroad Analytics skill. - Pulls product and sales analytics from the Gumroad API. - Provides scripts to fetch stats, log daily metrics, and export sales data. - Supports tracking by products, sales, revenue, and conversion rates. - Includes setup instructions, API endpoint references, and sample metrics logging. - Offers analysis patterns for conversion rate, trend detection, and marketing correlation. - Notes API limitations (no traffic/funnel data; rate limiting info included).
Metadata
Slug gumroad-analytics
Version 1.0.1
License
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Gumroad Analytics?

Pull daily Gumroad product/sales analytics safely (no raw PII persistence by default). It is an AI Agent Skill for Claude Code / OpenClaw, with 438 downloads so far.

How do I install Gumroad Analytics?

Run "/install gumroad-analytics" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Gumroad Analytics free?

Yes, Gumroad Analytics is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Gumroad Analytics support?

Gumroad Analytics is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Gumroad Analytics?

It is built and maintained by Vlad Rimsha (@vladchatware); the current version is v1.0.1.

💬 Comments