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 field mapping rules (TikTok is always "Short"; Instagram is "Reel"/"Post" if linked, "Story" if not), 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 to see TikTok Short / IG Reel / IG Story counts, the top posters by volume, and (once engagement starts getting captured going forward) the top posts by engagement.
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.
- 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. 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.
- 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.
