SKILL: Revenue Monitor
Purpose
Track daily revenue across Gumroad, KDP, and Etsy. Alert on anomalies (sales spikes, drops, or zero-revenue days). Generate daily and weekly summaries. Make sure no sale goes unnoticed and no revenue problem goes undetected.
Configuration (Set Once)
Check skills/revenue-monitor/config.json. If not present, ask:
- Gumroad: Do you have a Gumroad API access token? (Settings → Advanced → API)
- KDP: Do you have KDP sales tracking set up? (Manual CSV export or AgentReach session)
- Etsy: Do you have an Etsy API key? (developer.etsy.com)
- Telegram alert chat ID: For revenue alerts (leave blank to disable)
- Revenue alert thresholds:
- Alert if daily sales exceed $[X] (spike alert) - Alert if no sales for [X] consecutive days (drop alert) - Weekly revenue goal: $[X]
- Check frequency: Daily at [time] / On demand only
Save to skills/revenue-monitor/config.json.
Daily Revenue Check
Run every day (or when triggered). Pull data from all configured platforms.
Gumroad Check
# Gumroad REST API v2
# GET https://api.gumroad.com/v2/sales
# Headers: Authorization: Bearer {GUMROAD_ACCESS_TOKEN}
# Params: after={yesterday_date}, before={today_date}
import requests
from datetime import date, timedelta
yesterday = (date.today() - timedelta(days=1)).isoformat()
today = date.today().isoformat()
response = requests.get(
"https://api.gumroad.com/v2/sales",
headers={"Authorization": f"Bearer {GUMROAD_TOKEN}"},
params={"after": yesterday, "before": today}
)
sales = response.json().get("sales", [])Extract per sale:
product_nameprice(in cents — divide by 100)created_atvariants_and_quantityreferrer(where the sale came from)
Compile into:
GUMROAD — [Date]
Sales: [X]
Revenue: $[X.XX]
Products sold:
- [Product A]: [X] units @ $[X]
- [Product B]: [X] units @ $[X]
Top referrer: [URL or "direct"]KDP Check (via AgentReach or Manual)
If AgentReach is configured with a KDP session:
agentreach kdp sales --days 1If not, check ~/.agentreach/kdp-sales-cache/ for last exported data.
If no automation: prompt the user to export KDP sales report and paste/share it.
KDP data to extract:
- Units ordered per title
- Estimated royalties
- KENP (Kindle Unlimited pages read)
KDP — [Date]
Units ordered: [X]
Estimated royalties: $[X.XX]
KENP pages: [X] (~$[X.XX])
Top title: [Title name]Etsy Check (if configured)
# Etsy API v3
# GET https://openapi.etsy.com/v3/application/shops/{shop_id}/receipts
# Headers: x-api-key: {ETSY_API_KEY}
response = requests.get(
f"https://openapi.etsy.com/v3/application/shops/{ETSY_SHOP_ID}/receipts",
headers={"x-api-key": ETSY_API_KEY},
params={"min_created": yesterday_timestamp, "max_created": today_timestamp}
)Compile:
ETSY — [Date]
Orders: [X]
Revenue: $[X.XX] (before Etsy fees)
Net revenue: ~$[X.XX] (after ~6.5% transaction fee)
Top product: [Product name]Daily Revenue Summary Format
📊 REVENUE SUMMARY — [Day, Date]
GUMROAD
Sales: [X] | Revenue: $[X.XX]
[Product breakdown]
KDP
Units: [X] | Royalties: ~$[X.XX]
[Title breakdown]
ETSY
Orders: [X] | Revenue: $[X.XX]
[Product breakdown]
─────────────────────────
TODAY TOTAL: $[X.XX]
MTD TOTAL: $[X.XX]
MTD GOAL: $[X.XX] ([X]% to goal)
─────────────────────────
YESTERDAY: $[X.XX] | CHANGE: [+/- X%]
7-DAY AVG: $[X.XX]/day
30-DAY TOTAL: $[X.XX]Anomaly Detection & Alerts
Spike Alert (Positive)
Trigger: Today's revenue exceeds 3x the 7-day average
🚀 REVENUE SPIKE ALERT — [Date]
Today: $[X.XX] (vs 7-day avg of $[X.XX])
That's [X]x your normal daily revenue!
Top source: [Platform] — [Product]
Possible cause: [Check if you ran any promotion, got a feature, etc.]
Action: Consider reposting what worked today. Check referrer data.Drop Alert (Concern)
Trigger: Zero sales for N consecutive days (configured threshold, default 3)
⚠️ REVENUE ALERT — [X] Days No Sales
Last sale: [Date] — [Product] on [Platform]
Days since: [X]
Possible causes to investigate:
• Product listings active? (Check all platforms)
• Any SEO/search ranking drops?
• Seasonal dip?
• Payment method issues?
Recommended action: Run a quick promotion or share a product link.Weekly Drop Alert
Trigger: This week's revenue is more than 30% below last week
📉 WEEKLY REVENUE DOWN [X]%
This week: $[X.XX]
Last week: $[X.XX]
Difference: -$[X.XX]
[Breakdown by platform showing where the drop happened]
Investigate: [Platform where the biggest drop occurred]Weekly Revenue Report
Every Sunday (or when triggered: "weekly revenue report"):
📈 WEEKLY REVENUE REPORT — Week of [Date]
TOTAL THIS WEEK: $[X.XX]
vs Last Week: $[X.XX] ([+/-X%])
vs Goal ($[X]): [X]% achieved
PLATFORM BREAKDOWN:
Gumroad: $[X.XX] ([X] sales)
KDP: $[X.XX] ([X] units + KENP)
Etsy: $[X.XX] ([X] orders)
TOP PERFORMERS:
1. [Product] — $[X.XX] ([X] units)
2. [Product] — $[X.XX] ([X] units)
3. [Product] — $[X.XX] ([X] units)
NEW PRODUCTS LAUNCHED THIS WEEK: [X]
BEST DAY: [Day] — $[X.XX]
WORST DAY: [Day] — $[X.XX]
MONTH TO DATE: $[X.XX] / $[Goal] goal ([X]%)
INSIGHTS:
• [One observation about what worked]
• [One observation about what didn't]
• [One recommendation for next week]Revenue Log Format
Log all data to systems/feedback/revenue-data.json:
{
"log": [
{
"date": "2026-03-18",
"gumroad": {
"sales_count": 0,
"revenue": 0.00,
"products": []
},
"kdp": {
"units": 0,
"royalties": 0.00,
"kenp_pages": 0
},
"etsy": {
"orders": 0,
"revenue": 0.00
},
"total": 0.00
}
]
}Month-End Report
On the last day of each month:
📅 MONTHLY REVENUE REPORT — [Month Year]
TOTAL REVENUE: $[X.XX]
vs Prior Month: $[X.XX] ([+/-X%])
BREAKDOWN:
Gumroad: $[X.XX] ([X]% of total)
KDP: $[X.XX] ([X]% of total)
Etsy: $[X.XX] ([X]% of total)
PRODUCTS (ranked by revenue):
1. [Product] — $[X.XX]
2. [Product] — $[X.XX]
...
DAYS WITH SALES: [X] / [X] days
BEST DAY: [Date] — $[X.XX]
AVERAGE DAY: $[X.XX]
GOAL STATUS: $[X.XX] / $[Goal] = [X]%
NEXT MONTH GOAL: $[X.XX]
ACTION ITEMS FOR NEXT MONTH:
• [Based on data — what to double down on]
• [What underperformed and why]
• [New products or promotions to try]Telegram Alert Format
When sending to Telegram, keep it short:
Daily (sent each morning):
💰 Yesterday: $X.XX
📦 Gumroad: X sales | KDP: X units | Etsy: X orders
📈 MTD: $X.XXSpike alert: Send full spike alert message (see above) Drop alert: Send full drop alert message (see above)
Commands / Triggers
- "Revenue report" → Today's daily summary
- "Weekly report" → Full weekly breakdown
- "Monthly report" → Full month summary
- "How are sales?" → Quick daily summary
- "Gumroad sales" → Gumroad only
- "KDP sales" → KDP only
- "How much this month?" → MTD total
- "Revenue last 30 days" → 30-day summary
- "Set revenue goal $X" → Update config
- "Any alerts?" → Check for anomalies now