gumroad-cli: Gumroad API v2 CLI (products/sales/followers/offer-codes/buyers-csv)

README.md

@@ -0,0 +1,23 @@
+# gumroad-cli
+
+CLI for the Gumroad API v2 (Python 3, stdlib only — no pip deps).
+
+## Setup
+```bash
+export GUMROAD_TOKEN=<token>   # or --token flag
+```
+
+## Commands
+| Command | Description |
+|---------|-------------|
+| `products` | List all products (id, name) |
+| `product <id>` | Product detail (price, description, custom fields) |
+| `sales` | List sales (email, product, amount, date) |
+| `followers` | List follower emails — **404: Gumroad API has no followers endpoint** (dashboard UI only) |
+| `offer-codes` | List offer codes per product |
+| `buyers-csv` | Export unique buyer emails to CSV (for Listmonk sync) |
+
+## Notes
+- Gumroad store `alfalahtech.gumroad.com` is the **archived** store; active store = Polar on fi2.falahos.my/products.
+- No API path exists to bulk-add followers/subscribers → Listmonk stays the source of truth for blasts.
+- Buyer sync flow: `gumroad-cli buyers-csv` → import CSV into Listmonk.