growth-tools 0.1.0__tar.gz

growth_tools-0.1.0/.env.example

@@ -0,0 +1,32 @@
+# ── Reddit ────────────────────────────────────────────────────────────────────
+REDDIT_CLIENT_ID=your_reddit_app_id
+REDDIT_CLIENT_SECRET=your_reddit_app_secret
+REDDIT_USER_AGENT=growth-tools/1.0
+
+# ── OpenAI (for classification + outreach drafts) ─────────────────────────────
+OPENAI_API_KEY=sk-...
+OPENAI_MODEL=gpt-4.1-mini
+
+# ── Supabase (lead storage) ───────────────────────────────────────────────────
+SUPABASE_URL=https://your-project.supabase.co
+SUPABASE_SERVICE_ROLE_KEY=eyJ...
+
+# ── Discord ───────────────────────────────────────────────────────────────────
+DISCORD_TOKEN=your_discord_bot_token
+# Comma-separated channel IDs to monitor (leave blank = all channels)
+ALLOWED_CHANNEL_IDS=
+
+# ── GitHub ────────────────────────────────────────────────────────────────────
+GITHUB_TOKEN=ghp_...
+
+# ── Scoring thresholds ────────────────────────────────────────────────────────
+# Min intent score (0-100) to save a lead
+LEAD_INTENT_THRESHOLD=70
+# Min confidence for Discord auto-reply
+DISCORD_CONFIDENCE_THRESHOLD=0.75
+
+# ── Brand identity (used in LLM-generated reply/outreach drafts) ──────────────
+BRAND_NAME=YourProduct
+BRAND_TAGLINE=helps teams ship production-ready apps
+# Describe the core problem your ICP (ideal customer profile) has
+ICP_PAIN=move from prototype to production

growth_tools-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,52 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest tests/ -v
+
+      - name: Lint
+        run: |
+          pip install ruff
+          ruff check src/
+
+  dry-run-reddit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install package
+        run: pip install -e .
+      - name: Smoke test CLI (dry-run)
+        run: growth-reddit --dry-run --subreddits SaaS
+        env:
+          BRAND_NAME: TestBrand
+          BRAND_TAGLINE: Test tagline
+          ICP_PAIN: Test pain
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          REDDIT_CLIENT_ID: ${{ secrets.REDDIT_CLIENT_ID }}
+          REDDIT_CLIENT_SECRET: ${{ secrets.REDDIT_CLIENT_SECRET }}
+          REDDIT_USER_AGENT: CI/1.0
+        continue-on-error: true

growth_tools-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+.env
+*.log
+.DS_Store

growth_tools-0.1.0/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: growth-tools
+Version: 0.1.0
+Summary: Lead capture from Reddit, Discord and GitHub with hybrid LLM scoring and outreach drafts.
+Project-URL: Repository, https://github.com/nometria/growth-tools
+License: MIT
+Keywords: discord,growth,leads,outreach,reddit,saas,scoring
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.10
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: discord-py>=2.3.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: openai>=1.52.0
+Requires-Dist: praw>=7.7.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: supabase>=2.0.0
+Requires-Dist: tenacity>=8.2.0
+Requires-Dist: uvicorn[standard]>=0.30.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# growth-tools
+
+> Automated lead capture from Reddit, Discord and GitHub — with hybrid LLM scoring and outreach drafts.
+
+Built for dev-tool and SaaS companies that want inbound signal from developer communities
+without hiring a full-time growth team.
+
+---
+
+## Quick start
+
+```bash
+# Clone and install
+git clone https://github.com/ownmy-app/growth-tools
+cd growth-tools
+pip install -e .
+
+# Configure your environment
+cp examples/sample-icp.env .env
+# Edit .env with your API keys and brand config
+
+# Run Reddit monitor (one-shot)
+growth-reddit
+
+# Run the website auditor API
+growth-api
+# or: uvicorn growth_tools.api.main:app --port 8000
+
+# Run tests
+pytest tests/ -v
+```
+
+Required environment variables (see `examples/sample-icp.env`):
+```bash
+OPENAI_API_KEY=sk-proj-...
+REDDIT_CLIENT_ID=...
+REDDIT_CLIENT_SECRET=...
+BRAND_NAME="Your Product"
+ICP_KEYWORDS="supabase,self-host,postgres,..."
+```
+
+---
+
+## What's included
+
+| Module | What it does |
+|--------|-------------|
+| `systems/reddit_capture.py` | Monitors subreddits, two-stage filter (keyword → LLM), saves hot leads |
+| `systems/discord_bot.py` | Discord bot with per-channel cooldown, confidence threshold gating |
+| `systems/website_auditor.py` | Detects tech stack from HTML/headers (Next.js, Vite, Supabase, Vercel…) |
+| `systems/github_auditor.py` | Scans repos for migration readiness (package.json, Dockerfile analysis) |
+| `systems/crm_sequencer.py` | LLM-generated outreach drafts (capped at 90 words for reply rates) |
+| `core/scoring.py` | Hybrid rule + LLM scoring: `0.5 × rule_score + 0.5 × llm_intent_score` |
+| `core/llm.py` | OpenAI client with fallback model + tenacity retries |
+| `api/main.py` | FastAPI: `POST /audit/website`, `POST /audit/github`, `GET /health` |
+
+---
+
+## Scoring tiers
+
+| Score | Tier | Action |
+|-------|------|--------|
+| ≥ 80 | **hot** | Immediate outreach |
+| 60–79 | **nurture** | Add to sequence |
+| 40–59 | **educate** | Send content |
+| < 40 | **ignore** | Skip |
+
+Rule signals: `+25` high-intent builder (Lovable/Replit/Bolt/v0), `+30` high-intent pain
+(deploy/migrate/security/ownership), `+20` has public repo, `+25` mentions clients.
+Blended 50/50 with LLM intent score.
+
+---
+
+## Supabase schema
+
+```sql
+create table lead_signals (
+  id           uuid primary key default gen_random_uuid(),
+  source       text,          -- 'reddit' | 'discord' | 'github'
+  title        text,
+  body         text,
+  url          text,
+  author       text,
+  intent_score int,
+  tier         text,
+  builder      text,
+  pain_type    text,
+  reply_draft  text,
+  created_at   timestamptz default now()
+);
+```
+
+---
+
+## Setup
+
+```bash
+git clone https://github.com/ownmy-app/growth-tools
+cd growth-tools
+pip install -e .
+cp examples/sample-icp.env .env
+# Edit .env
+```
+
+---
+
+## Run
+
+```bash
+# Reddit monitor (one-shot)
+growth-reddit
+
+# Discord bot (persistent)
+python -m growth_tools.systems.discord_bot
+
+# Website auditor API
+growth-api
+# or: uvicorn growth_tools.api.main:app --port 8000
+
+# Audit a specific website
+curl -X POST http://localhost:8000/audit/website -H 'Content-Type: application/json' \
+  -d '{"url": "https://example.com"}'
+```
+
+---
+
+## Customise
+
+**Target subreddits** — set `ICP_KEYWORDS` in `.env`
+
+**Lead scoring** — edit weights in `core/scoring.py` (or move to YAML config)
+
+**Outreach tone** — edit prompts in `core/llm.py`
+
+---
+
+## Immediate next steps
+1. Make subreddits + keywords configurable via env / YAML
+2. Add GitHub lead capture (scan repos that import competitor SDKs)
+3. Add Slack notification on "hot" leads
+4. Package as `pip install growth-tools`
+
+---
+
+## Commercial viability
+- Open-core: open source the capture + scoring, charge for the CRM sequencer
+- SaaS: $200–500/mo per team for managed lead pipeline
+- Competitors: Trigify, Drippi — neither does GitHub + Reddit + LLM scoring combined
+
+---
+
+## Example output
+
+Running `pytest tests/ -v`:
+
+```
+============================= test session starts ==============================
+platform darwin -- Python 3.13.9, pytest-9.0.2, pluggy-1.5.0
+cachedir: .pytest_cache
+rootdir: /tmp/ownmy-releases/growth-tools
+configfile: pyproject.toml
+plugins: anyio-4.12.1, cov-7.1.0
+collecting ... collected 4 items
+
+tests/test_brand_config.py::test_brand_name_reads_from_env PASSED        [ 25%]
+tests/test_brand_config.py::test_brand_tagline_reads_from_env PASSED     [ 50%]
+tests/test_brand_config.py::test_icp_pain_reads_from_env PASSED          [ 75%]
+tests/test_brand_config.py::test_no_hardcoded_brand_names_in_source PASSED [100%]
+
+============================== 4 passed in 0.03s ===============================
+```
+
+See `examples/sample-leads.json` for representative scored lead output and `examples/sample-icp.env` for required environment variable configuration.

growth_tools-0.1.0/README.md

@@ -0,0 +1,173 @@
+# growth-tools
+
+> Automated lead capture from Reddit, Discord and GitHub — with hybrid LLM scoring and outreach drafts.
+
+Built for dev-tool and SaaS companies that want inbound signal from developer communities
+without hiring a full-time growth team.
+
+---
+
+## Quick start
+
+```bash
+# Clone and install
+git clone https://github.com/ownmy-app/growth-tools
+cd growth-tools
+pip install -e .
+
+# Configure your environment
+cp examples/sample-icp.env .env
+# Edit .env with your API keys and brand config
+
+# Run Reddit monitor (one-shot)
+growth-reddit
+
+# Run the website auditor API
+growth-api
+# or: uvicorn growth_tools.api.main:app --port 8000
+
+# Run tests
+pytest tests/ -v
+```
+
+Required environment variables (see `examples/sample-icp.env`):
+```bash
+OPENAI_API_KEY=sk-proj-...
+REDDIT_CLIENT_ID=...
+REDDIT_CLIENT_SECRET=...
+BRAND_NAME="Your Product"
+ICP_KEYWORDS="supabase,self-host,postgres,..."
+```
+
+---
+
+## What's included
+
+| Module | What it does |
+|--------|-------------|
+| `systems/reddit_capture.py` | Monitors subreddits, two-stage filter (keyword → LLM), saves hot leads |
+| `systems/discord_bot.py` | Discord bot with per-channel cooldown, confidence threshold gating |
+| `systems/website_auditor.py` | Detects tech stack from HTML/headers (Next.js, Vite, Supabase, Vercel…) |
+| `systems/github_auditor.py` | Scans repos for migration readiness (package.json, Dockerfile analysis) |
+| `systems/crm_sequencer.py` | LLM-generated outreach drafts (capped at 90 words for reply rates) |
+| `core/scoring.py` | Hybrid rule + LLM scoring: `0.5 × rule_score + 0.5 × llm_intent_score` |
+| `core/llm.py` | OpenAI client with fallback model + tenacity retries |
+| `api/main.py` | FastAPI: `POST /audit/website`, `POST /audit/github`, `GET /health` |
+
+---
+
+## Scoring tiers
+
+| Score | Tier | Action |
+|-------|------|--------|
+| ≥ 80 | **hot** | Immediate outreach |
+| 60–79 | **nurture** | Add to sequence |
+| 40–59 | **educate** | Send content |
+| < 40 | **ignore** | Skip |
+
+Rule signals: `+25` high-intent builder (Lovable/Replit/Bolt/v0), `+30` high-intent pain
+(deploy/migrate/security/ownership), `+20` has public repo, `+25` mentions clients.
+Blended 50/50 with LLM intent score.
+
+---
+
+## Supabase schema
+
+```sql
+create table lead_signals (
+  id           uuid primary key default gen_random_uuid(),
+  source       text,          -- 'reddit' | 'discord' | 'github'
+  title        text,
+  body         text,
+  url          text,
+  author       text,
+  intent_score int,
+  tier         text,
+  builder      text,
+  pain_type    text,
+  reply_draft  text,
+  created_at   timestamptz default now()
+);
+```
+
+---
+
+## Setup
+
+```bash
+git clone https://github.com/ownmy-app/growth-tools
+cd growth-tools
+pip install -e .
+cp examples/sample-icp.env .env
+# Edit .env
+```
+
+---
+
+## Run
+
+```bash
+# Reddit monitor (one-shot)
+growth-reddit
+
+# Discord bot (persistent)
+python -m growth_tools.systems.discord_bot
+
+# Website auditor API
+growth-api
+# or: uvicorn growth_tools.api.main:app --port 8000
+
+# Audit a specific website
+curl -X POST http://localhost:8000/audit/website -H 'Content-Type: application/json' \
+  -d '{"url": "https://example.com"}'
+```
+
+---
+
+## Customise
+
+**Target subreddits** — set `ICP_KEYWORDS` in `.env`
+
+**Lead scoring** — edit weights in `core/scoring.py` (or move to YAML config)
+
+**Outreach tone** — edit prompts in `core/llm.py`
+
+---
+
+## Immediate next steps
+1. Make subreddits + keywords configurable via env / YAML
+2. Add GitHub lead capture (scan repos that import competitor SDKs)
+3. Add Slack notification on "hot" leads
+4. Package as `pip install growth-tools`
+
+---
+
+## Commercial viability
+- Open-core: open source the capture + scoring, charge for the CRM sequencer
+- SaaS: $200–500/mo per team for managed lead pipeline
+- Competitors: Trigify, Drippi — neither does GitHub + Reddit + LLM scoring combined
+
+---
+
+## Example output
+
+Running `pytest tests/ -v`:
+
+```
+============================= test session starts ==============================
+platform darwin -- Python 3.13.9, pytest-9.0.2, pluggy-1.5.0
+cachedir: .pytest_cache
+rootdir: /tmp/ownmy-releases/growth-tools
+configfile: pyproject.toml
+plugins: anyio-4.12.1, cov-7.1.0
+collecting ... collected 4 items
+
+tests/test_brand_config.py::test_brand_name_reads_from_env PASSED        [ 25%]
+tests/test_brand_config.py::test_brand_tagline_reads_from_env PASSED     [ 50%]
+tests/test_brand_config.py::test_icp_pain_reads_from_env PASSED          [ 75%]
+tests/test_brand_config.py::test_no_hardcoded_brand_names_in_source PASSED [100%]
+
+============================== 4 passed in 0.03s ===============================
+```
+
+See `examples/sample-leads.json` for representative scored lead output and `examples/sample-icp.env` for required environment variable configuration.

growth_tools-0.1.0/examples/sample-icp.env

@@ -0,0 +1,39 @@
+# Growth Tools — Required Environment Variables
+# Copy this to .env and fill in your values
+
+# ── Brand / ICP Configuration ─────────────────────────────────────────────────
+# These define YOUR product so the LLM generates accurate outreach
+BRAND_NAME="Acme DevTools"
+BRAND_TAGLINE="The fastest way to self-host your AI-generated app"
+ICP_PAIN="teams that built with Lovable, Bolt, or Manus and now need to self-host"
+ICP_KEYWORDS="supabase,self-host,postgres,multi-tenant,AI-generated,Lovable,Bolt,Manus,v0"
+OUTREACH_CTA="Want a 5-minute demo?"
+
+# ── Reddit Credentials ────────────────────────────────────────────────────────
+REDDIT_CLIENT_ID=your_reddit_client_id
+REDDIT_CLIENT_SECRET=your_reddit_client_secret
+REDDIT_USER_AGENT=growth-tools/0.1 by u/your_reddit_username
+REDDIT_USERNAME=your_reddit_username
+REDDIT_PASSWORD=your_reddit_password
+
+# Subreddits to monitor (comma-separated)
+REDDIT_SUBREDDITS=SaaS,webdev,nextjs,reactjs,Supabase,startups,entrepreneur
+
+# ── Discord Configuration ─────────────────────────────────────────────────────
+DISCORD_BOT_TOKEN=your_discord_bot_token
+DISCORD_GUILD_IDS=123456789012345678,987654321098765432
+
+# ── OpenAI (for LLM scoring) ──────────────────────────────────────────────────
+OPENAI_API_KEY=sk-proj-...
+OPENAI_MODEL=gpt-4o-mini
+LLM_SCORE_THRESHOLD=0.6
+
+# ── Supabase (for lead storage) ───────────────────────────────────────────────
+SUPABASE_URL=https://your-project-ref.supabase.co
+SUPABASE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+
+# ── Scoring Weights ───────────────────────────────────────────────────────────
+# Final score = RULE_WEIGHT * rule_score + LLM_WEIGHT * llm_score
+RULE_WEIGHT=0.5
+LLM_WEIGHT=0.5
+MIN_SCORE_THRESHOLD=0.55

growth_tools-0.1.0/examples/sample-leads.json

@@ -0,0 +1,78 @@
+[
+  {
+    "id": "reddit_abc123",
+    "source": "reddit",
+    "platform_url": "https://reddit.com/r/SaaS/comments/abc123/is_there_a_good_solution_for_multi_tenant_auth",
+    "author": "u/buildingmysaas",
+    "content": "We're trying to build a multi-tenant SaaS on top of Supabase but running into issues with RLS and per-tenant schemas. Anyone have a good solution? Currently we're on Vercel + Next.js.",
+    "subreddit": "SaaS",
+    "score": 0.87,
+    "rule_score": 0.75,
+    "llm_intent_score": 0.99,
+    "scoring_breakdown": {
+      "keyword_hits": ["supabase", "multi-tenant", "RLS", "Next.js"],
+      "pain_match": "schema isolation, auth complexity",
+      "intent": "actively evaluating solutions"
+    },
+    "outreach_draft": "Hey! Saw your post about multi-tenant Supabase — we built a schema-per-tenant migration tool that handles exactly this. It sets up isolated app_{id} schemas with RLS and Supabase auth wired in. Happy to share a quick demo if that's useful.",
+    "captured_at": "2026-03-22T09:14:32Z",
+    "status": "new"
+  },
+  {
+    "id": "reddit_def456",
+    "source": "reddit",
+    "platform_url": "https://reddit.com/r/webdev/comments/def456/migrating_from_firebase_to_supabase",
+    "author": "u/migrationpain",
+    "content": "Has anyone migrated from Firebase to Supabase? We have ~50k users and need to move auth and the Firestore data. Looking for tools that can help automate this.",
+    "subreddit": "webdev",
+    "score": 0.71,
+    "rule_score": 0.65,
+    "llm_intent_score": 0.77,
+    "scoring_breakdown": {
+      "keyword_hits": ["firebase", "supabase", "migrate", "auth"],
+      "pain_match": "migration complexity, user data",
+      "intent": "looking for migration tooling"
+    },
+    "outreach_draft": "We help teams migrate from Firebase to Supabase — auth users, Firestore collections, and storage. Done it for teams with 100k+ users. Worth a call?",
+    "captured_at": "2026-03-22T10:02:11Z",
+    "status": "new"
+  },
+  {
+    "id": "discord_ghi789",
+    "source": "discord",
+    "platform_url": "https://discord.com/channels/1016518.../#general",
+    "author": "devuser#4821",
+    "content": "anyone tried deploying a manus.im project to their own infra? want to use postgres instead of their managed db",
+    "channel": "general",
+    "score": 0.63,
+    "rule_score": 0.58,
+    "llm_intent_score": 0.68,
+    "scoring_breakdown": {
+      "keyword_hits": ["manus", "postgres", "deploy", "infra"],
+      "pain_match": "vendor lock-in, self-hosting",
+      "intent": "exploring self-hosting options"
+    },
+    "outreach_draft": "Hey! We have a one-command tool that migrates Manus projects to self-hosted Supabase + Postgres. Takes about 5 minutes. DM me if you want to try it.",
+    "captured_at": "2026-03-22T11:45:00Z",
+    "status": "contacted"
+  },
+  {
+    "id": "reddit_jkl012",
+    "source": "reddit",
+    "platform_url": "https://reddit.com/r/nextjs/comments/jkl012/security_review_of_ai_generated_code",
+    "author": "u/securityminded",
+    "content": "We used Bolt to generate our MVP and now our CTO wants a security review before we go to production. Anyone know a good tool that catches secrets and SQL injection in AI-generated code?",
+    "subreddit": "nextjs",
+    "score": 0.92,
+    "rule_score": 0.88,
+    "llm_intent_score": 0.96,
+    "scoring_breakdown": {
+      "keyword_hits": ["bolt", "security", "secrets", "SQL injection", "AI-generated"],
+      "pain_match": "production security, AI code quality",
+      "intent": "actively searching for a specific tool"
+    },
+    "outreach_draft": "We built a free static scanner specifically for AI-generated code (Bolt, Lovable, v0). Catches hardcoded secrets, SQL injection, CORS misconfigs — zero dependencies, runs in CI. Check it out at github.com/ownmy-app/security-scanner",
+    "captured_at": "2026-03-22T14:30:55Z",
+    "status": "new"
+  }
+]

growth_tools-0.1.0/examples/test-output.txt

@@ -0,0 +1,14 @@
+============================= test session starts ==============================
+platform darwin -- Python 3.13.9, pytest-9.0.2, pluggy-1.5.0 -- /Users/architsharma/miniconda3/bin/python3.13
+cachedir: .pytest_cache
+rootdir: /private/tmp/ownmy-releases/growth-tools
+configfile: pyproject.toml
+plugins: anyio-4.12.1, cov-7.1.0
+collecting ... collected 4 items
+
+tests/test_brand_config.py::test_brand_name_reads_from_env PASSED        [ 25%]
+tests/test_brand_config.py::test_brand_tagline_reads_from_env PASSED     [ 50%]
+tests/test_brand_config.py::test_icp_pain_reads_from_env PASSED          [ 75%]
+tests/test_brand_config.py::test_no_hardcoded_brand_names_in_source PASSED [100%]
+
+============================== 4 passed in 0.03s ===============================

growth_tools-0.1.0/growth_tools/api/main.py

@@ -0,0 +1,83 @@
+"""
+FastAPI app: website auditor + GitHub repo auditor.
+Run: uvicorn api.main:app --reload (from growth-tools dir)
+"""
+import sys
+from pathlib import Path
+
+_root = Path(__file__).resolve().parent.parent
+if str(_root) not in sys.path:
+    sys.path.insert(0, str(_root))
+
+from fastapi import FastAPI, HTTPException
+from fastapi.middleware.cors import CORSMiddleware
+from pydantic import BaseModel
+
+from systems.website_auditor import audit_url as website_audit
+from systems.github_auditor import analyze_repo_url as github_audit
+from systems.crm_sequencer import add_lead
+from core.db import is_db_available
+
+app = FastAPI(
+    title="Growth Tools API",
+    description="Website auditor & GitHub repo auditor for production-readiness.",
+    version="1.0.0",
+)
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
+class AuditWebsiteRequest(BaseModel):
+    url: str
+    save_as_lead: bool = False
+
+
+class AuditGitHubRequest(BaseModel):
+    repo_url: str
+
+
+@app.get("/health")
+def health():
+    return {"status": "ok", "db": is_db_available()}
+
+
+@app.post("/audit/website")
+def audit_website(req: AuditWebsiteRequest):
+    """Paste app URL; returns detected stack, risks, and next step. Optionally saves as lead."""
+    if not req.url or len(req.url) > 2048:
+        raise HTTPException(status_code=400, detail="Invalid URL")
+    result = website_audit(req.url)
+    if req.save_as_lead and result.get("ok") and is_db_available():
+        try:
+            lead = add_lead(
+                source=result.get("url", req.url),
+                source_url=result.get("url", req.url),
+                title=result.get("title"),
+                platform="website",
+                pain_type="audit",
+                intent_score=50,
+                metadata={"audit": result},
+            )
+            if lead:
+                result["lead_id"] = lead.get("id")
+        except Exception:
+            pass
+    return result
+
+
+@app.post("/audit/github")
+def audit_github(req: AuditGitHubRequest):
+    """Provide repo URL; returns detected stack, missing items, migration suggestions."""
+    if not req.repo_url or len(req.repo_url) > 2048:
+        raise HTTPException(status_code=400, detail="Invalid repo URL")
+    return github_audit(req.repo_url)
+
+
+if __name__ == "__main__":
+    import uvicorn
+    uvicorn.run(app, host="0.0.0.0", port=8000)