WebAgency MVP

An automated web development agency pipeline. Ingests local business data, scores leads, generates modern landing pages, and drafts outreach emails — fully automated.

What It Does

1. Ingest — Upload a CSV of local businesses from Outscraper
2. Filter — AI classifies which businesses have simple "poster sites" we can rebuild
3. Crawl — Firecrawl scrapes each qualified site
4. Score — AI scores each site for rebuild potential (outdated design, no backend, etc.)
5. Generate — AI builds a modern single-file HTML landing page for each hot lead
6. Outreach — AI drafts a personalized cold email with the preview link

Quick Start

1. Install dependencies

npm install

2. Set up environment variables

cp .env.example .env.local
# Fill in all values in .env.local

3. Set up Supabase

• Create a project at supabase.com
• Run schema.sql in the Supabase SQL editor
• Copy your project URL and keys into .env.local

4. Run the dev server

npm run dev

Open http://localhost:3000

5. Upload a CSV

• Export businesses from Outscraper
• Upload via the dashboard
• Watch the pipeline run

Architecture

See CLAUDE.md for full technical documentation including the pipeline state machine, Supabase schema, module ownership, and agent instructions.

Pipeline Status Flow

raw → qualified → crawled → hot → generating → complete
     ↘ rejected    ↘ cold

Generated Sites

Sites are generated as single HTML files and served statically at:

http://localhost:3000/sites/[business-id]

Tech Stack

• Next.js 14 (App Router)
• TypeScript
• Tailwind CSS
• Supabase
• Firecrawl API
• OpenRouter API (Claude/GPT/Gemini model routing)
• shadcn/ui

Demo Flow

1. Upload the sample CSV
2. Watch businesses get classified in real time
3. Click "Process Leads" to crawl and score
4. Click "Generate Sites" to build landing pages
5. Show before/after comparison for hot leads
6. Show drafted outreach email with preview link