smartspec docs

The technical SEO scanner that recognizes the failure patterns of AI-built sites — Lovable, Bolt, v0, Replit, Cursor — and tells you exactly how to fix them.

Install in 30 seconds

npm i -g smartspec
# or
curl -fsSL smartspec.dev/install | bash

Then:

smartspec audit https://your-site.com

Where to start

• Quickstart — install + first audit in one go.
• AI builders cheat sheet — which rules trip your Lovable / Bolt / v0 / Replit / Cursor project.
• CLI reference — every command and every flag.
• Vibecoder rules — the 10 rules built specifically for AI-builder failure modes.
• Claude Code skill — invoke smartspec from inside Claude Code or Cursor.

How smartspec is different

• Specialized. It knows that a "Vite + React" <title> is a v0 leftover, not just a generic "default title" warning.
• CLI-first. Pipe to jq, embed in CI, send to an LLM.
• Local. No account, no telemetry, no upload of your URL.
• Open source. MIT-licensed on GitHub.