CLI

# 1. Audit any URL. No account.
npx seomatic audit https://example.com

# 2. Find crawl-budget waste in a server log. No account.
npx seomatic logs /var/log/nginx/access.log

# 3. Read your own Search Console data.
export SEOMATIC_API_KEY=smk_live_...
npx seomatic gsc top-queries --days 28

npx seomatic audit https://example.com --json

{
  "url": "https://example.com",
  "score": 30,
  "passed": 3,
  "total": 10,
  "checks": [{ "id": "reachable", "ok": true, "detail": "HTTP 200 in 133ms" }]
}

npx seomatic audit https://example.com --json 2>/dev/null | jq .score

{ "error": "Missing or invalid API key" }

# Fail a build when a page regresses
score=$(npx seomatic audit "$URL" --json | jq -r .score)
[ "$score" -ge 80 ] || { echo "SEO score $score < 80"; exit 1; }

# List every check that failed
npx seomatic audit "$URL" --json | jq -r '.checks[] | select(.ok|not) | .id'

# Find AI crawlers wasting budget on errors
npx seomatic logs access.log --json   | jq -r '.bots[] | select(.isAiBot and .wastedCrawlPct > 20)
           | "(.bot) (.wastedCrawlPct)% wasted"'

# Retry only on runtime failures, never on your own bad call
for i in 1 2 3; do
  npx seomatic me --json && break
  [ $? -eq 2 ] || break
  sleep $((i * 2))
done