Cashclaw SEO Auditor

node scripts/audit.js --url "https://example.com" --output audit-data.json

# Fetch the page
curl -sL -o page.html -w "%{http_code} %{time_total}s %{size_download}bytes" "https://example.com"

# Check robots.txt
curl -sL "https://example.com/robots.txt"

# Check sitemap
curl -sL "https://example.com/sitemap.xml"

# Check SSL
curl -sI "https://example.com" | head -20

# Check redirect chain
curl -sIL "https://example.com" 2>&1 | grep -i "location\|HTTP/"

[ ] HTTPS enabled and forced (HTTP redirects to HTTPS)
[ ] SSL certificate valid and not expiring within 30 days
[ ] robots.txt exists and is properly configured
[ ] XML sitemap exists and is valid
[ ] No broken internal links (4xx status codes)
[ ] No redirect chains longer than 2 hops
[ ] Clean URL structure (no query params for content pages)
[ ] Canonical tags present and correct
[ ] Hreflang tags (if multi-language)
[ ] Structured data / JSON-LD present and valid
[ ] Mobile-friendly viewport meta tag
[ ] No mixed content (HTTP resources on HTTPS page)
[ ] Server response time under 500ms
[ ] Gzip or Brotli compression enabled
[ ] HTTP/2 or HTTP/3 support

[ ] Title tag exists, unique, 50-60 characters
[ ] Meta description exists, unique, 150-160 characters
[ ] H1 tag exists and is unique on the page
[ ] Heading hierarchy is logical (H1 > H2 > H3, no skips)
[ ] Images have descriptive alt text
[ ] Images are optimized (WebP/AVIF, lazy loading)
[ ] Internal links use descriptive anchor text
[ ] Content length adequate for topic (minimum 300 words for landing pages)
[ ] Keyword appears in: title, H1, first paragraph, URL
[ ] No duplicate content issues
[ ] No thin pages (< 100 words)
[ ] Open Graph tags present (og:title, og:description, og:image)
[ ] Twitter Card tags present
[ ] Favicon configured

[ ] Check backlink profile (note: limited without API access, use available data)
[ ] Social media presence linked from site
[ ] Google Business Profile (if local business)
[ ] NAP consistency (Name, Address, Phone) across web
[ ] Domain authority estimation based on observable signals
[ ] Competitor comparison (Pro tier: audit top 3 competitors)

[ ] Page load time (target: < 3 seconds)
[ ] First Contentful Paint (target: < 1.8s)
[ ] Largest Contentful Paint (target: < 2.5s)
[ ] Total page size (target: < 3MB)
[ ] Number of HTTP requests (target: < 50)
[ ] JavaScript bundle size (target: < 500KB compressed)
[ ] CSS optimization (unused CSS, render-blocking)
[ ] Font loading strategy (font-display: swap)
[ ] Third-party script impact

Technical SEO:  35 points (each item = 35 / item_count)
On-Page SEO:    30 points (each item = 30 / item_count)
Off-Page SEO:   15 points (each item = 15 / item_count)
Performance:    20 points (each item = 20 / item_count)

PASS = full points
WARN = half points
FAIL = 0 points

Grade:
  90-100: A (Excellent)
  80-89:  B (Good)
  70-79:  C (Needs Improvement)
  60-69:  D (Poor)
  < 60:   F (Critical)

# SEO Audit Report
**URL:** {url}
**Date:** {date}
**Tier:** {Basic|Standard|Pro}
**Overall Score:** {score}/100 ({grade})

---

## Executive Summary
{2-3 sentences summarizing the site's SEO health and top priorities}

## Score Breakdown
| Category | Score | Grade |
|----------|-------|-------|
| Technical SEO | {x}/35 | {grade} |
| On-Page SEO | {x}/30 | {grade} |
| Off-Page SEO | {x}/15 | {grade} |
| Performance | {x}/20 | {grade} |
| **Overall** | **{x}/100** | **{grade}** |

## Critical Issues (Fix Immediately)
{Numbered list of FAIL items with specific fix instructions}

## Warnings (Fix Soon)
{Numbered list of WARN items with recommendations}

## What You Are Doing Well
{List of PASS items worth highlighting}

## Priority Action Plan
1. {Highest impact fix with estimated effort}
2. {Second highest impact fix}
3. {Third highest impact fix}
4. ...

## Detailed Findings

### Technical SEO
{Table of all items with PASS/WARN/FAIL and notes}

### On-Page SEO
{Table of all items with PASS/WARN/FAIL and notes}

### Off-Page SEO (Standard/Pro only)
{Table of all items with PASS/WARN/FAIL and notes}

### Performance
{Table of all items with PASS/WARN/FAIL and notes}

---
*Generated by CashClaw SEO Auditor | cashclaw.ai*

# Run a basic audit
cashclaw audit --url "https://example.com" --tier basic

# Run a standard audit
cashclaw audit --url "https://example.com" --tier standard --output report.md