Find customers already asking for what you sell — and get a useful reply draft before your competitors see the thread.
LeadParrot is a high-intent lead-discovery and reply-draft tool. It monitors public/allowed sources (Reddit official API, Hacker News, RSS, manual paste), scores buyer intent with AI, and drafts helpful, non-spammy replies you review and post yourself.
LeadParrot does not auto-post, auto-DM, scrape private communities, or spam anyone. It is a discovery + drafting tool — you stay in control.
Status & provenance: Prototype built in hours with AI coding agents, directed and reviewed by Prakash Kantumutchu (KP). Never deployed as a commercial service; built to test end-to-end architecture, RLS, and deterministic fallback patterns. Verified on 23 Oct 2026:
tsc --noEmit(0 errors) and 139 tests passing across 24 test files (npm test). Case study: thisiskp.in/work/agent-built-saas-prototypes.
- Validation-first & runs with zero secrets. With no env configured the app boots in demo mode: seeded in-memory data + a deterministic mock AI provider, so the entire product is clickable offline.
- Provider abstraction. AI =
mock | openai | anthropic. Sources degrade to demo data + setup instructions when not configured. Stripe/Resend show "not configured" instead of crashing. - Safe by design. Official APIs only, keyword + negative-keyword filtering, affiliation disclosure in every reply draft, prominent platform-rules disclaimers.
- Org-scoped data with RLS. Postgres schema + Row Level Security so no cross-organization leakage.
Next.js (App Router) · TypeScript · Tailwind CSS · Supabase (Postgres/Auth/Storage/RLS) · Zod · Stripe (REST abstraction) · Resend (optional) · Vitest · Playwright.
# 1. Install
npm install
# 2. (Optional) configure env — everything is optional; omit for demo mode
cp .env.example .env.local
# 3. Run
npm run dev
# open http://localhost:3000With no .env.local, the app runs in demo mode: visit /login → "Enter demo workspace".
To force demo mode even with Supabase configured: LEADPARROT_DEMO=1.
All optional. See .env.example for the full list.
| Group | Vars | If missing |
|---|---|---|
| Supabase | NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY |
Demo mode (in-memory data, stub user) |
| AI | AI_PROVIDER (mock/openai/anthropic), OPENAI_API_KEY, ANTHROPIC_API_KEY |
Deterministic mock provider |
REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USER_AGENT |
Reddit scans return demo posts + setup note | |
RESEND_API_KEY, DIGEST_FROM_EMAIL |
Digest is in-app preview only | |
| Stripe | STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET, NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY, STRIPE_PRICE_* |
"Billing not configured"; webhook refuses unverified events once Stripe is configured |
| Jobs / observability | CRON_SECRET, ERROR_WEBHOOK_URL |
Digest cron refuses to run without CRON_SECRET; errors fall back to structured logs |
| App | NEXT_PUBLIC_APP_URL, ADMIN_EMAILS |
Localhost default; admin gated by demo/role |
- Create a project at supabase.com.
- Copy the URL + anon key + service-role key into
.env.local. - Run the migrations (below).
- Enable Email auth (and any OAuth providers you want) in the Supabase dashboard.
The SQL lives in supabase/migrations:
0001_init.sql— schema, triggers (auto-profile, auto-membership,updated_at).0002_rls.sql— Row Level Security policies +is_org_member()helper.
Using the Supabase CLI (recommended):
npm i -g supabase
supabase link --project-ref <your-ref>
supabase db push # applies migrations in supabase/migrationsOr paste into the SQL editor: run 0001_init.sql then 0002_rls.sql in order.
See docs/DATABASE.md for the full schema + RLS model.
Default AI_PROVIDER=mock. The mock provider (src/lib/ai/providers/mock.ts) returns deterministic scoring + reply drafts derived from the post text and your keywords/competitors — no network, fully reproducible (great for tests and demos).
Switch to a real provider by setting AI_PROVIDER=openai (or anthropic) and the matching API key. If the key is missing, the provider transparently falls back to the mock so nothing breaks. See docs/AI_SCORING_WORKFLOW.md.
npm run test # Vitest unit tests (scoring, schemas, keywords, usage, status, scan flow,
# reply-safety, rate limiter, Stripe signature, AI fallback, saveLead parity)
npm run test:coverage # same + coverage gate on the core business-logic modules
npm run typecheck # tsc --noEmit
npm run lint # next lint
# E2E (demo mode, offline):
npx playwright install chromium # one-time
npm run test:e2eCI runs typecheck · lint · test:coverage · build, then the Playwright e2e happy path (all in demo mode, no secrets).
The daily digest is delivered by a scheduled call to POST/GET /api/cron/digest, wired for Vercel Cron in vercel.json (daily at 13:00 UTC). The route requires Authorization: Bearer $CRON_SECRET, is idempotent per UTC day (it records a digest_emails row and skips orgs already sent today), and no-ops safely when the Supabase service role isn't configured. Without CRON_SECRET it refuses to run, so it can never be triggered anonymously.
| Source | Status | Notes |
|---|---|---|
| Manual | ✅ Always on | Paste a public URL/text, scored on demand |
| ✅ Official API | App-only OAuth, read-only, configurable subreddits/sort/window. No auto-commenting. | |
| Hacker News | ✅ Public API | Algolia HN Search (no auth) |
| RSS | ✅ | Any public RSS/Atom feed |
| Web search | 🔜 Placeholder | Reserved for SerpAPI/Tavily/Exa/Bing. No scraping. |
Details + safety rules: docs/SOURCE_INTEGRATIONS.md, docs/PLATFORM_SAFETY.md.
Works on Vercel or Railway. Set the env vars, run migrations against your Supabase project, point NEXT_PUBLIC_APP_URL at your domain, and configure the Stripe webhook to POST /api/stripe/webhook. Full guide: docs/DEPLOYMENT.md.
src/
app/ # App Router pages + route handlers
page.tsx # Landing
pricing/ demo/ # Marketing
login/ signup/ onboarding/ auth/
app/ # Authenticated area (/app/*): dashboard, projects, leads, billing, settings, digest, admin
api/ # demo/score, stripe/checkout, stripe/webhook
components/ # UI + interactive client components
lib/
ai/ # provider abstraction + Zod schemas + prompts
scoring/ # weighted score + keyword matching
sources/ # reddit / hackernews / rss / manual / web-search fetchers + status machine
db/ # DataStore interface, memory + supabase implementations, seed
billing/ email/ # Stripe + Resend abstractions
usage/ # plan limit checks
scan.ts # source → filter → AI → lead orchestration
supabase/migrations/ # schema + RLS
tests/unit/ tests/e2e/
docs/
- PRD · Architecture · Database
- AI scoring workflow · Source integrations
- Platform safety · Compliance
- Validation plan · Deployment
LeadParrot helps you discover public conversations and draft replies. You are responsible for following each platform's rules before responding. LeadParrot does not post for you.
MIT — see LICENSE.