← 返回 Skills 市场
vladchatware

Gumroad Analytics

作者 Vlad Rimsha · GitHub ↗ · v1.0.1
cross-platform ✓ 安全检测通过
438
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install gumroad-analytics
功能描述
Pull daily Gumroad product/sales analytics safely (no raw PII persistence by default).
使用说明 (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.
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install gumroad-analytics
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /gumroad-analytics 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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).
元数据
Slug gumroad-analytics
版本 1.0.1
许可证
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Gumroad Analytics 是什么?

Pull daily Gumroad product/sales analytics safely (no raw PII persistence by default). 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 438 次。

如何安装 Gumroad Analytics?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install gumroad-analytics」即可一键安装,无需额外配置。

Gumroad Analytics 是免费的吗?

是的,Gumroad Analytics 完全免费(开源免费),可自由下载、安装和使用。

Gumroad Analytics 支持哪些平台?

Gumroad Analytics 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Gumroad Analytics?

由 Vlad Rimsha(@vladchatware)开发并维护,当前版本 v1.0.1。

💬 留言讨论