Claude Code SEO Audit — Free Prompt Inside

You are a technical SEO auditor. Your goal is to perform a comprehensive SEO health check on a website and deliver an interactive HTML report with scores, pass/fail checks, and specific fix recommendations.

Here is the website to audit:

- Website URL: [YOUR WEBSITE URL]
- Business name: [YOUR BUSINESS NAME]
- What we do: [ONE SENTENCE DESCRIPTION OF YOUR BUSINESS]
- Primary keyword targets: [LIST 3-5 KEYWORDS YOU WANT TO RANK FOR]

Follow these steps in order. Complete each step fully before moving to the next.

---

STEP 1 — CRAWL THE SITE

Visit the homepage and discover up to 20 internal pages by following links. For each page, collect:

- URL and HTTP status code
- Page title and length (characters)
- Meta description and length
- H1 tag (count and text)
- H2-H6 heading hierarchy
- Word count
- Image count and how many have alt text
- Internal link count
- External link count
- Whether the page has canonical tag, OG tags, and schema markup

Also check these site-wide signals:
- Is the site using HTTPS?
- Does robots.txt exist? How many disallow rules?
- Does an XML sitemap exist? How many URLs?
- What is the server response time (TTFB estimate)?
- Are there redirect chains on any pages?

---

STEP 2 — SCORE EACH CATEGORY

Group your findings into these categories and score each one as Pass, Warning, or Fail:

TECHNICAL HEALTH:
- HTTPS encryption (pass if yes)
- HTTP status codes (pass if all 200)
- Redirect chains (warning if >2 hops, fail if >4)
- Canonical tags (pass if present and matching URL)
- robots.txt (pass if exists)
- XML sitemap (pass if exists with >0 URLs)
- Response time (pass if <1s, warning if 1-3s, fail if >3s)

ON-PAGE SEO (per page):
- Title length (pass if 30-60 chars)
- Meta description (pass if 120-160 chars)
- H1 count (pass if exactly 1)
- H2 count (pass if >=2)
- Image alt text (pass if all images have alt)
- Word count (pass if >=300)
- Internal links (pass if >=3)
- OG title present
- OG image present

CONTENT QUALITY:
- Heading hierarchy (warning if skipping levels, e.g., H1 to H3)
- Duplicate titles across pages
- Duplicate meta descriptions across pages
- Thin content pages (word count <200)
- Missing meta descriptions

STRUCTURED DATA:
- Schema markup present (pass if any JSON-LD found)
- Types of schema found
- Schema validation (warning if fields missing)

---

STEP 3 — GENERATE FIX RECOMMENDATIONS

For every Warning and Fail finding, write a specific, actionable fix recommendation. Not generic advice — reference the exact page, the exact issue, and exactly what to change.

Bad example: "Add meta descriptions to pages that are missing them."
Good example: "Page /pricing is missing a meta description. Add: 'Compare pricing plans. Start with a 3-day free trial and get started for $9/month.' (98 chars)"

Prioritize fixes as:
- Critical (will directly hurt rankings if not fixed)
- Important (best practice, should fix soon)
- Minor (nice to have)

---

STEP 4 — CALCULATE OVERALL SCORE

Compute an overall SEO health score from 0-100:
- Technical Health: 30% weight
- On-Page SEO: 30% weight
- Content Quality: 20% weight
- Structured Data: 10% weight
- Site-wide signals (sitemap, robots, HTTPS): 10% weight

---

STEP 5 — BUILD THE HTML REPORT

Output a single, self-contained HTML file with embedded CSS. The report should include:

1. HEADER: Website name, URL, audit date, overall score displayed as a large circular progress ring (green if >80, yellow if 60-80, red if <60)

2. CATEGORY CARDS: One card per category showing the category score, number of passes/warnings/fails, with a colored indicator

3. SITE CRAWL TABLE: All pages discovered with columns for URL, status, title, H1, word count, images, and issues found. Sortable by clicking column headers.

4. DETAILED FINDINGS: Expandable sections for each category. Each finding shows pass/warning/fail icon, the check name, current value, and the fix recommendation if applicable.

5. HEADING TREE: Visual hierarchy of headings for each page, with issues highlighted (skipped levels, missing H1, multiple H1s, etc.)

6. FIX PRIORITY LIST: All recommendations sorted by priority (Critical first, then Important, then Minor). Each item shows the page, the issue, and the exact fix.

Style the report with:
- Clean white background, subtle gray borders
- Sans-serif font (system font stack)
- Green (#059669) for pass, yellow (#d97706) for warning, red (#dc2626) for fail
- Responsive layout that works on mobile
- Collapsible sections to keep it manageable
- No external dependencies — everything inline