SFUGC Sync
Superfiliate has no API for UGC/Media data, so getting a month's posts into the sheet always starts with a live Claude scrape, not a button in this app — this app is deployed on Cloudflare only, with no GitHub repo, so there's nothing to browse for instructions except this page. Whoever does this needs three things: a Claude session that can drive a browser, login access to Superfiliate's admin (viva-raw.admin.superfiliate.com), and this app's app key (only when Claude asks for it — never hand it over up front).
A short phrase like "sync SFUGC for July 2026" only works if you're in a Claude Code session that already has this project's .claude/skills folder loaded — that's the only way a Claude client discovers what "SFUGC" even means. claude.ai, or Claude Code opened anywhere else, has zero context for it and will just ask you what you're talking about. That's exactly why get staged batch exists: it copies the entire self-contained procedure to your clipboard instead — Superfiliate navigation, the exact 9 Programs to filter to, the field mapping rules (TikTok is always "Short"; Instagram's Reel/Post/Story comes straight off Superfiliate's own Content Type column, not guessed from whether there's a link), and the exact POST /stage call — so it works in any Claude client, no project setup required. The app key is deliberately left out of the copied text (so it never sits in a chat transcript); Claude will ask you for it partway through, and you paste that in separately.
- get staged batch — flags the month in the Worker and copies the full sync prompt to your clipboard (or shows it in a popup to copy manually, if the browser blocks the automatic copy). A webpage can't type into Claude directly for you (a browser security boundary, not a limitation of this app), so paste is as close to one-click as this gets — open your Claude session and paste.
- Load staged batch — once Claude has staged a month, pulls it up here for you to review.
- In the review table: uncheck a row to exclude it, edit any cell inline, or remove a row entirely with the ✕. Collapse/Expand hides the table without losing your edits.
- Push to Sheet — appends the checked rows to the SFUGC tab, skipping anything already there.
- UGC Stats — pick a month and click Check UGC Stats to see TikTok Short / IG Reel / IG Story counts, the top posters by volume (with links to their posts), and the top-ranking posts by engagement. Only counts rows already pushed to the sheet — link and engagement are both required fields in the scrape (not optional) precisely because this panel depends on them; only a Story is allowed to skip Link (Superfiliate gives it none) and Engagement (no view/like count ever shown for one).
SF Reporting
Builds the mid-month/end-of-month Superfiliate earnings report.
- Report Type / Month / SF Export (CSV) — pick Mid-Month or End-of-Month, the month, and upload your Superfiliate export. The report processes every row in the CSV as-is — it doesn't filter by date, so whatever date range you actually exported is what gets used.
- Fetch from Shopify — has its own Report Type/Month, separate from the one above. Pulls repeat-discount orders directly from Shopify for that period and appends new ones to the Shopify Prelim tab (never duplicates). If a generic checkout code was used, upload that month's SF export above first so it can still credit the right affiliate. Also auto-adds a Deductions row (below) for any affiliate matched in that period who doesn't already have one — always review before generating a preview.
- Fetch all SF — refreshes the All SF tab from a live Superfiliate export of all enrolled affiliates; shows when it was last run.
- Deductions / Additions — add rows for repeat-discount offenses or missed-code referrals (Deductions can also get auto-filled by Fetch from Shopify, above). Save (next to Generate Preview) persists both lists for this month/type immediately.
- Generate Preview — builds the report table and Bonus Cheat Sheet exactly as they'll appear in the sheet. Ctrl/Cmd + scroll to zoom the preview.
- fraud code CSV — End-of-Month only. Rebuilds the "Fraud Code Usage Template" tab in the Repeat Discount - Shopify Flow sheet from this month's Shopify Prelim data (Order Date, Affiliate Email, Customer Email, Order #, Order Amount, Amount Deducted from Wallet), and downloads the same rows as a CSV for Nana.
- Import to a Sheet — creates the actual Google Sheet from the preview. Generate CSV unlocks afterward, for a plain CSV copy of the same import.
TVR Filter
Screening tool: finds Team Viva Referral Program signups over a date range and flags any whose name/email hints they might actually belong to a different partner category (vet, breeder, trainer, influencer, pet industry, or just a non-generic domain).
- 1 Month / 3 Months / 6 Months — fills From/To with a rolling window ending today. Edit From/To by hand for a custom range; that clears the preset highlight.
- Fetch Team Viva — pulls signups in that range and screens them. This is a preliminary AI-based screen, not a definitive classification — always double-check before acting on a flag.
- Results open in a popup with Download CSV at the bottom for the flagged list only.
