Site Audit

Open-source technical SEO crawl and audit UI (Next.js + Python + PostgreSQL).

Why this project — Most site-audit and SEO tools are paid, limited, or built to upsell: paywalls, capped crawls, teaser scores, and “subscribe to see how to fix this.” Many free options give shallow or unreliable reports that push you toward a paid plan instead of real answers.

Goal — A free, self-hosted audit you control: crawl your sites, see honest technical SEO issues, connect Search Console and Analytics when you want, and export reports for clients — without a vendor sitting between you and the data.

Docker

docker compose up --build

Open http://localhost:3000/home.

Local dev

./local-run setup   # first time: Postgres, Python venv, migrations, npm deps
./local-run         # daily: start DB + Next.js dev server → http://localhost:3000/home
./local-run db      # Postgres only (no app)
./local-run migrate # apply Alembic migrations only
./local-run stop    # stop Postgres container

Tests

./local-test              # before push: full CI parity (DB + pytest + web)
./local-test python         # backend only: pytest + CLI smoke
./local-test web            # frontend only: typecheck, lint, vitest
./local-test quick          # fast loop: skip Docker start; needs DB already up
./local-test all --no-cov   # full run without pytest coverage gate

Contributions are welcome. See CONTRIBUTING.md for setup and pull request guidelines.

• CODE_OF_CONDUCT.md — community standards
• SECURITY.md — report vulnerabilities privately

• AGENT.md — repo layout and dev commands
• docs/GLOSSARY.md — UI terminology
• docs/COMPANY_STANDARDS.md — data and security policy

Google Search Console / Analytics: connect via Integrations (gear icon) in the app.

Production: docker-compose.prod.yml (set POSTGRES_PASSWORD, AUTH_SECRET).

Copyright (c) 2026 codefrydev. Released under the MIT License — see LICENSE. Issues and pull requests: codefrydev/WebsiteProfiling.