aeo-radar: Instructions file for Claude Code

CLAUDE.md — Dev playbook for AEO Radar

Context for Claude Code (or any LLM assistant) working on this repo. Keep it short; if the code answers the question, don't repeat the answer here.

Tech stack

• CLI: TypeScript + tsx, Playwright (stealth plugin), Claude CLI via execSync
• DB: SQLite via Prisma 7 (file at data/aeo.db)
• Dashboard: Next.js 16 + React 19 + Ant Design 6 + Recharts (port 3003)
• Package manager: npm

Common commands

# Crawl (defaults to headless)
npx tsx src/cli.ts run                 # ChatGPT
npx tsx src/cli.ts run chatgpt --visible  # debug with visible browser

# Seeding & analysis
npx tsx src/cli.ts seed                # generate prompts from brand.ts
npx tsx src/cli.ts analyze <runId>     # re-run analysis on a past run

# Database
npm run db:push                        # apply schema changes to SQLite

# Dashboard
cd web && npm run dev                  # http://localhost:3003

Source layout

src/
├── cli.ts                  # Entry point (run / analyze / seed)
├── types.ts                # LLM_PLATFORMS + shared types
├── config/
│   └── brand.ts            # ← single source of truth for brand/keywords
├── crawlers/
│   ├── base.ts             # Stealth + challenge detection + persistent profile
│   └── chatgpt.ts          # DOM selectors: #prompt-textarea, stop-button
├── pipeline/
│   ├── runner.ts           # Orchestrates prompts × platforms × analysis
│   └── analyzer.ts         # Claude CLI → structured JSON
├── prompts/
│   └── generator.ts        # Seeds keywords/prompts from brand.ts
└── db/
    └── prisma.ts           # Prisma singleton

prompts/
├── generator-template.md   # Claude template for prompt generation
└── analysis-template.md    # Claude template for answer analysis

web/                        # Next.js dashboard
├── src/app/                # Pages + API routes
├── src/components/         # KPI cards, charts, tables, settings
└── src/lib/theme.ts        # Grayscale tokens, AntD ConfigProvider