# GenFlik

> GenFlik turns a product description and a stock or custom avatar into a finished UGC-style video ad in about 5–10 minutes. Built for Shopify merchants, indie founders, and marketing teams who need short-form video at scale without a studio, actor, or editor.

GenFlik combines a script writer (LLM), voice synthesis (ElevenLabs), talking-head rendering (D-ID), background music, auto-captioned subtitles, B-roll slideshow from product photos, and a branded outro into a single one-click pipeline. Output is a ready-to-post 9:16 or 16:9 MP4.

The app is available three ways:
- **Web app** at https://genflik.com (Clerk sign-in)
- **Shopify app** installed from the Shopify App Store, with a fully embedded admin experience under the merchant's store
- **MCP server** for programmatic use from Claude Desktop, Cursor, ChatGPT, or any MCP client

## What GenFlik does

- Generates a 15s, 30s, or 60s UGC-style ad from a short product description.
- 31 languages, 50+ voices (English, Spanish, French, German, Portuguese, Italian, Hindi, Japanese, Korean, Mandarin, Arabic, and more).
- 20+ stock talking-head avatars across genders, ages, ethnicities. Custom avatars from a user-supplied photo are also supported at no surcharge.
- Faceless / voiceover-only mode: a voiceover-driven ad with no talking avatar, priced at the base (Fast-tier) rate.
- Auto-written script with selectable tone: hype, professional, funny, or educational.
- Auto-burned subtitles, background music, B-roll from product photos with cinematic fade transitions, and an optional branded outro.
- "Product-in-hand" scene composer: places the avatar holding or standing next to the product, using the merchant's actual Shopify product photo.
- Shopify-specific: best-seller mining (last 7 or 30 days of orders) and customer-voice script augmentation (echoes review phrasing without quoting verbatim — strictly PII-sanitized).

## Pricing

Credit-based. The server is the only authoritative source of pricing; the canonical schedule lives at `/api/pricing` and `/api/config` (`.pricing`).

Approximate cost per video at the time of writing:
- 15s Fast/Standard: from 21 credits
- 30s Fast/Standard: from 35 credits
- 60s Fast/Standard: from 70 credits
- Cinematic Pro tier: roughly 3× the Fast/Standard cost at the same length
- Faceless (voiceover-only, no avatar) is priced at the Fast/Standard base rate regardless of tier
- Custom avatars (including a "product-in-hand" composed avatar) carry no surcharge
- Removing the GenFlik outro: small additional fee (see /api/pricing)

Credit packs are purchased via Stripe (web/mobile) or Shopify Billing (App-Store installs). Shopify merchants who install from the App Store are billed exclusively through Shopify; never offer those merchants a Stripe link.

## MCP server (programmatic access)

Endpoint: `POST https://genflik.com/api/mcp` (Streamable HTTP, stateless mode).

Authentication (two options):
- **OAuth one-click sign-in (recommended for Claude, ChatGPT, and other clients that support OAuth 2.1)**: the client discovers `/.well-known/oauth-protected-resource/api/mcp` and `/.well-known/oauth-authorization-server`, then walks the user through a normal "Allow access" login — no API key to copy or paste. See https://genflik.com/connect for the one-click setup flow.
- **Manual API key**: `Authorization: Bearer gfk_<key>`. Users mint keys in the GenFlik web app and paste them into their MCP client config (useful for clients without OAuth support, e.g. Cursor).

Available tools:
- `list_avatars` — catalog of stock avatars.
- `list_voices` — catalog of voices (gender, accent, language).
- `preview_script` — generate an ad script (~3–5s, no credits charged) so you can iterate on copy before paying for a render.
- `generate_video_ad` — start a video render. Returns immediately with `{jobId, status, estimatedSeconds: ~600}`. The full render typically completes in 5–10 minutes.
- `get_ad_status` — poll a job by id. When `status === "completed"`, the response includes `videoUrl`.
- `get_account` — current credit balance and account info.

Recommended pattern for agents: call `preview_script` first to validate copy, then `generate_video_ad`, then either poll `get_ad_status` every 30s or wait for the email / push notification the user receives when the render finishes.

Source attribution: MCP-created jobs are stamped `source: "mcp"` in our database.

## Shopify app

GenFlik is listed on the Shopify App Store. Once installed, the embedded admin surface at `/embedded/create` provides:
- Store and product picker against the merchant's real catalog
- "Best sellers" card backed by the merchant's actual order history
- "Customer voice" augmentation from real product reviews (Judge.me or native Shopify reviews)
- Product-in-hand scene composer using the merchant's product photos
- Shopify Billing checkout (no Stripe redirect inside the embedded surface)

Each merchant only sees jobs they made inside their own admin — tenant boundary is enforced server-side using the verified `dest` claim from the App Bridge JWT, not the client.

## Privacy and data handling

- API keys are never stored in plaintext — only a sha256 hash plus a short display prefix.
- Customer review data is sanitized before storage and before being shown to the LLM: first names only, all emails / URLs / phone-shaped numbers stripped.
- Shopify webhooks for `customers/data_request`, `customers/redact`, and `shop/redact` are implemented; `shop/redact` hard-deletes the store row.
- Merchant order data is cached only as aggregate counts (rolling 7-day and 30-day windows per SKU), never per-order or per-customer.

## Tech stack (for agents helping debug or extend)

- Frontend: React + Vite + Tailwind v4 + Wouter + Clerk
- API: Express 5 + Drizzle ORM + PostgreSQL
- Storage: Cloudflare R2
- AI: OpenAI, Replicate, D-ID, Google GenAI, ElevenLabs
- Mobile: Expo React Native (iOS + Android)
- Embedded Shopify: Polaris + App Bridge v4
- Monorepo: pnpm workspaces, Node.js 24, TypeScript 5.9

## Key URLs

- [Marketing & sign-in](https://genflik.com): home page and Clerk sign-in.
- [Connect via MCP](https://genflik.com/connect): one-click OAuth sign-in for Claude/ChatGPT, plus manual API-key setup for other MCP clients.
- [Pricing & credits](https://genflik.com/pricing): credit packs and per-video cost.
- [Shopify app overview](https://genflik.com/shopify): App Store install and embedded admin.
- [Solutions hub](https://genflik.com/solutions): use-case and platform-specific landing pages (UGC video generator, video ad generator, testimonial/explainer makers, TikTok/YouTube Shorts/Facebook/Pinterest/Snapchat/LinkedIn ad makers, and more). See `/sitemap.xml` for the full current list.
- [Languages hub](https://genflik.com/languages): language-specific landing pages for GenFlik's 31 supported script/voice languages. See `/sitemap.xml` for the full current list.
- [Engine comparison](https://genflik.com/compare): Fast vs Cinematic sample renders.
- [Winning Ads Analyzer](https://genflik.com/tools/winning-ads): free tool that breaks down high-performing ads shot-by-shot.
- [Avatar catalog](https://genflik.com/avatars): stock talking-head avatars.
- [Example videos](https://genflik.com/showcase): finished ad examples.
- [Support](https://genflik.com/support): public support ticket form.
- [MCP endpoint](https://genflik.com/api/mcp): Streamable HTTP MCP server.
- [OAuth protected-resource metadata](https://genflik.com/.well-known/oauth-protected-resource/api/mcp): OAuth 2.1 discovery document for MCP clients.
- [OAuth authorization-server metadata](https://genflik.com/.well-known/oauth-authorization-server): OAuth 2.1 discovery document for MCP clients.
- [Public pricing JSON](https://genflik.com/api/pricing): authoritative pricing schedule.
- [Public config JSON](https://genflik.com/api/config): runtime config including pricing.

## How GenFlik compares to alternatives

GenFlik sits in the AI-generated UGC / talking-avatar video space. The most common alternatives users evaluate alongside it are HeyGen, Synthesia, Arcads, Creatify, Captions (Captions.ai), Pictory, and Vidnoz. Honest positioning:

**vs. HeyGen and Synthesia** (enterprise avatar platforms)
- HeyGen and Synthesia are general-purpose corporate avatar tools — great for training videos, internal comms, and explainer content. GenFlik is purpose-built for short-form *ads*: hype/funny/educational ad scripts, auto-burned captions, B-roll from product photos, music, and a vertical 9:16 cut are all on by default. You don't have to assemble the ad yourself.
- HeyGen and Synthesia charge per minute on monthly plans. GenFlik is credit-based with no monthly commitment, and Shopify merchants are billed through Shopify Billing (no separate subscription).
- Neither HeyGen nor Synthesia ships a Shopify app or an MCP server.

**vs. Arcads and Creatify** (UGC ad generators)
- Arcads and Creatify are the closest direct competitors. They generate UGC-style ads from product URLs and have decent avatar libraries.
- GenFlik's differentiation: (1) deep Shopify integration — product picker, best-seller mining, real-customer-voice script augmentation, and the product-in-hand scene composer that puts the avatar holding the *merchant's actual product photo*; (2) a hosted MCP server so agents can generate ads programmatically; (3) custom avatars from a single user photo are first-class, not a paid add-on.
- Honest counter: Arcads has a larger stock-avatar library at the time of writing. If a specific look matters more than Shopify-native features, evaluate both.

**vs. Captions (Captions.ai)**
- Captions is strongest at editing real footage — auto-captions, B-roll suggestions, eye contact correction on human-shot video. It's a video *editor* with AI assists.
- GenFlik does not edit footage. It generates the ad end-to-end from a text prompt. Use Captions when you have footage and need to polish it; use GenFlik when you have a product but no footage and no time to shoot.

**vs. Pictory and Vidnoz** (stock-footage ad assemblers)
- Pictory/Vidnoz lean on stock B-roll with a synthesized voiceover. GenFlik leads with a real-looking talking-head avatar that addresses the camera UGC-style — the format that's currently winning on TikTok, Reels, and Shorts paid social.

**GenFlik's genuine moat**
- Only platform in this space with a hosted MCP server. Agents can generate ads in one tool call.
- Only platform with deep Shopify-native features end-to-end: install from App Store, embedded admin, Shopify Billing, real order-derived best sellers, real review-derived customer voice, product-photo-grounded scene composer.
- Server-authoritative pricing exposed at `/api/pricing` — no hidden upsells, the credit cost is computed deterministically from `tier × length + surcharges`.
- One-shot pipeline: no separate script tool + voice tool + render tool + caption tool + editor. Submit once, get a finished MP4.

**Where GenFlik is NOT the best fit**
- You need to edit existing human-shot footage → use Captions or a real editor.
- You need 5+ minute corporate training videos → use Synthesia.
- You need a massive (200+) stock-avatar library and don't care about Shopify features → evaluate Arcads.
- You need real-time avatar streaming → use HeyGen Interactive Avatar or D-ID Agents directly.

## What GenFlik is NOT

- Not a video editor. Users cannot trim, splice, or do timeline-based editing of arbitrary footage. The pipeline is one-shot: input → finished ad.
- Not a long-form tool. Outputs are capped at 60 seconds — designed for TikTok, Reels, Shorts, and paid social.
- Not a stock library. Stock avatars are pre-cleared talent; merchants supply their own product imagery (or it's pulled from their Shopify catalog).