# Stackify Social — agent guide

The anti-feed. Turn a human's followed Instagram accounts into a morning email of their
NEW POSTS — one email PER CREATOR, per day: every image of the post (full carousels),
verbatim caption, link. Images click through to a Stackify post page (/p/<shortcode> —
swipe carousel + inline video), not into Instagram's feed. No AI summary,
no ranking, no algorithm, no feed to scroll — each account they care about gets its own
dedicated email. You (the agent) create a "stack" of handles; we check each account daily
and email your human what it posted. They first get a WELCOME EMAIL with their private
dashboard magic-link, then the daily per-creator emails. EVERY email carries the magic
link, so they can always add/remove accounts or unsubscribe instantly. Billed per use
through ZeroClick — no accounts, no API keys on your side.

(Looking for events-to-calendar instead? That's Stackify Calendar: /llms.txt)

Base URL: https://stackify.pay.zeroclick.io  (ZeroClick pay rail — handles x402/MPP payment
and request signing; pay-per-use, no signup. The upstream rejects unsigned calls.)

Pay-per-use, drawn from your human's prepaid Zero balance — each call spends a few cents of
USDC. No subscription, no separate top-up step: the wallet balance IS the prepaid credit.
No Zero wallet yet? Install it — `npm i -g @zeroxyz/cli`, then `zero auth login` (your human
authorizes in the browser). First-time signups get a FREE $5 welcome credit (no card).

SETUP: first ask your human WHICH Instagram accounts they want in their inbox and their
EMAIL — don't guess these. Then create their stack (below).

QUICKSTART (Zero wallet / any x402 client — no signup, wallet is identity):
  zero fetch https://stackify.pay.zeroclick.io/v1/social-stacks -X POST \
    -H 'content-type: application/json' \
    -d '{"handles":["ig1","ig2"],"email":"human@x.com"}' --max-pay 0.30 --json
  First call → 402 payment challenge → your wallet pays USDC → ZeroClick signs + proxies →
  you get { stackId, dashboardUrl }. Hand the human dashboardUrl (we also email it in the
  welcome email). Then each morning, every account that posted gets its own email. Done.

POST /v1/social-stacks
  body: { "handles": ["ig_handle", ...(≤25)], "email": "optional@human.com" }
  → 201 { "stackId": "stk_…", "dashboardUrl": "…/#k=…" }
  meters: stack_created ×1. dashboardUrl is a MAGIC LINK — give it to your human; we also
  include it in every email we send. Opening it logs them into the dashboard (no password,
  no Google, no wallet), enrolls that device, and is where they add/remove accounts (with
  live Peek), pause, or unsubscribe. Treat it as a secret.
  A handle's FIRST scan emails only its single latest post (no backfill flood).

GET /v1/social-stacks/:id            → status, handles, recent posts (free)
POST /v1/social-stacks/:id/handles   → { "add": "handle" } or { "remove": "handle" } (free)
POST /v1/social-stacks/:id/peek      → { "handle": "x" } → followers/verified/9 thumbnails
                                        (meters: peeks ×1; ~15s — a sandbox scrapes live)

Pricing (meters, USDC, no base fee, drawn per use from the Zero balance): stack_created $0.25
(once, on create) · handle_days $0.05 (per watched account, per daily check) · peeks $0.05
(per preview) · emails $0.02 (per email sent — one per account that posted that day).
Recurring: handle_days ×N per daily check (N = watched accounts), reported idempotently per
stack per day, plus emails for accounts that actually posted. A 3-account stack runs roughly
$5–6/month depending on how often they post — the free $5 welcome credit covers getting
started. Delete-to-stop.

Post shape (GET :id):
{ "handle": str, "shortcode": str, "caption": str (verbatim), "timestamp": unixSeconds,
  "url": instagram-post-url, "image": thumbnail-url, "isVideo": bool }

The defining design choice — ONE EMAIL PER CREATOR: each followed account gets its own
email with only its own posts (subject "@handle: N new posts"). Don't ask us to combine
them unless your human explicitly wants that (a dashboard toggle exists, off by default).

Good citizenship: don't create stacks for emails/humans who didn't ask; every email has
one-click manage/unsubscribe and the human can always stop via their link.