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 Worker URL (https://sf-dashboard-worker.andy-210.workers.dev) + app key.
The prompt to type is: sync SFUGC for <month> <year> — e.g. "sync SFUGC for July 2026." Claude then: navigates Superfiliate → Social Listening → Media, filters to that month, reads each post's Platform/Date/Username/Link/Post Type (TikTok is always "Short"; Instagram is "Reel"/"Post" if linked, "Story" if not) and view/like count if shown, then calls POST /stage on the Worker URL above with an x-app-key header and a {month, rows} body. (If you're Andy: the full step-by-step is also saved as a Claude Skill at sf-dashboard/.claude/skills/sfugc-sync in this project's local folder, for any Claude session that has file access to it.)
- get staged batch — flags the month in the Worker and copies the exact prompt to your clipboard. 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
End-of-month screening tool: finds Team Viva Referral Program signups from the selected month 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).
- Month + Fetch Team Viva — pulls that month's signups 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.
