Quickstart

Install smartspec and run your first audit in under a minute.

1. Install

Pick one:

# Node-based (works on any platform with Node >= 20)
npm i -g smartspec

# Native binary — no Node required (macOS, Linux)
curl -fsSL smartspec.dev/install | bash

Verify the install:

smartspec version

If smartspec is not found, see Installation › Verify.

2. Run your first audit

Point smartspec at any public URL:

smartspec audit https://example.com

You'll see a health score and the findings grouped by severity (critical, warning, info).

3. Limit how much it crawls

By default smartspec walks up to 250 pages. For a quick first look:

smartspec audit https://example.com --max-pages 20

4. Get JSON for tooling

smartspec audit https://example.com -f json > audit.json
jq '.findings[] | select(.severity == "critical")' audit.json

5. Filter by category

Only run the rules you care about:

smartspec audit https://example.com --categories schema,mobile,security

Next steps

• CLI reference › audit — every flag.
• AI builders cheat sheet — which rules hit your stack.
• Claude Code skill — let the agent run the audit for you.