SEO Aeo Content Quality Auditor

{
  "content": "string — paste raw content, provide a URL, or provide a project path",
  "input_type": "text | url | website | codebase",
  "primary_keyword": "string — the main keyword this content should rank for",
  "secondary_keywords": ["string"],
  "content_type": "landing-page | blog-post | pillar-page | product-page",
  "word_count_target": "integer — expected word count, default 1500",
  "business_context": "string — optional description of the business and conversion goal",
  "existing_content": ["string — optional URLs or titles already published"]
}

# Content Quality Audit Report

## Summary

| Metric              | Score     | Status  |
|---------------------|-----------|---------|
| Overall Score       | [X/100]   | [label] |
| SEO Score           | [X/100]   | [label] |
| AEO Score           | [X/100]   | [label] |
| Readability Score   | [X/100]   | [label] |

**Verdict:** [One sentence summary of the content's current state
and the single most important fix needed.]

---

## SEO Report

### Score: [X/100] — [Status Label]

#### ✅ Passing Checks
- [Check name]: [what was found]
- [Check name]: [what was found]

#### ❌ Critical Issues — Fix Before Publishing

**Issue:** [Specific problem, e.g. "Primary keyword missing from H1"]
**Severity:** Critical
**Fix:** [Exact instruction, e.g. "Rewrite H1 to include '[keyword]'
naturally within the first 6 words"]

**Issue:** [Specific problem]
**Severity:** Critical
**Fix:** [Exact instruction]

#### ⚠️ Warnings — Fix Soon

**Issue:** [Specific problem]
**Severity:** Medium
**Fix:** [Exact instruction]

#### Keyword Analysis

| Keyword              | Found | Occurrences | Density | Target   | Status  |
|----------------------|-------|-------------|---------|----------|---------|
| [primary keyword]    | Yes/No| [n]         | [x.x%]  | Natural use | ✅ / ❌ |
| [secondary keyword]  | Yes/No| [n]         | [x.x%]  | Natural use | ✅ / ❌ |

#### Heading Structure

| Heading | Text                        | Contains Keyword | Status  |
|---------|-----------------------------|------------------|---------|
| H1      | [heading text]              | Yes/No           | ✅ / ❌ |
| H2 #1   | [heading text]              | Yes/No           | ✅ / ❌ |
| H2 #2   | [heading text]              | Yes/No           | ✅ / ❌ |

H1 count: [n] — must be exactly 1
H2 count: [n] — recommended 4–6 for blog posts
H3 count: [n] — should only appear inside H2 sections

#### Meta Elements

| Element          | Found    | Content                          | Status  |
|------------------|----------|----------------------------------|---------|
| Title Tag        | Yes/No   | [content or "missing"]           | ✅ / ❌ |
| Meta Description | Yes/No   | [content or "missing"]           | ✅ / ❌ |
| Title Length     | [n] chars| Target: 50–60 characters         | ✅ / ❌ |
| Meta Length      | [n] chars| Target: 140–160 characters       | ✅ / ❌ |
| Keyword in Title | Yes/No   | —                                | ✅ / ❌ |

#### Word Count

| Metric             | Actual     | Target               | Status  |
|--------------------|------------|----------------------|---------|
| Word Count         | [n] words  | [word_count_target]  | ✅ / ❌ |
| Avg Sentence Length| [n] words  | Target: under 20     | ✅ / ❌ |
| Avg Paragraph Length| [n] lines | Target: 3–5 lines    | ✅ / ❌ |

---

## AEO Report

### Score: [X/100] — [Status Label]

#### ✅ Passing Checks
- [Check name]: [what was found]

#### ❌ Critical Issues — Fix Before Publishing

**Issue:** [Specific AEO problem,
e.g. "No TL;DR or direct-answer block found"]
**Severity:** Critical
**Fix:** [Exact instruction, e.g. "Add a TL;DR block immediately
after the H1 — 2–3 sentences that directly answer the article's
core question. This is the block AI engines extract first."]

#### ⚠️ Warnings — Fix Soon

**Issue:** [Specific problem]
**Severity:** Medium
**Fix:** [Exact instruction]

#### AEO Signal Checklist

| Signal                              | Found    | Count    | Target       | Status  |
|-------------------------------------|----------|----------|--------------|---------|
| TL;DR / Direct Answer Block         | Yes/No   | —        | Required     | ✅ / ❌ |
| Definition Sentence ("X is...")     | Yes/No   | [n]      | Min 1        | ✅ / ❌ |
| FAQ Section                         | Yes/No   | [n] Qs   | Min 4        | ✅ / ❌ |
| Numbered or Bullet Lists            | Yes/No   | [n]      | Min 2        | ✅ / ❌ |
| Comparison Table                    | Yes/No   | [n]      | Recommended  | ✅ / ❌ |
| Primary Keyword in First 100 Words  | Yes/No   | —        | Required     | ✅ / ❌ |
| Concise Answers Under 50 Words      | Yes/No   | [n]      | Min 2        | ✅ / ❌ |
| Schema Markup Detected              | Yes/No   | —        | Recommended  | ✅ / ❌ |

#### Extractability Assessment

Rate how likely AI engines are to extract answers from this content:

| Question Type               | Extractable | Confidence | Notes              |
|-----------------------------|-------------|------------|--------------------|
| "What is [topic]?"          | Yes/No      | High/Med/Low| [brief reason]    |
| "How does [topic] work?"    | Yes/No      | High/Med/Low| [brief reason]    |
| "How much does [topic] cost?"| Yes/No     | High/Med/Low| [brief reason]    |
| "What are the benefits?"    | Yes/No      | High/Med/Low| [brief reason]    |

---

## Readability Report

### Score: [X/100] — [Status Label]

| Check                        | Result         | Target             | Status  |
|------------------------------|----------------|--------------------|---------|
| Passive Voice Usage          | [x%]           | Under 10%          | ✅ / ❌ |
| Transition Words Present     | Yes/No         | Required           | ✅ / ❌ |
| Wall-of-Text Paragraphs      | [n found]      | 0                  | ✅ / ❌ |
| Subheading Frequency         | Every [n] words| Every 300 words    | ✅ / ❌ |
| Reading Level                | [Grade level]  | Grade 7–9          | ✅ / ❌ |

---

## Prioritised Fix List

Work through these in order:

### 🔴 Do First (Critical — blocks publishing)
1. [Fix instruction]
2. [Fix instruction]

### 🟡 Do Second (Important — affects ranking)
3. [Fix instruction]
4. [Fix instruction]

### 🟢 Do Last (Polish — improves performance)
5. [Fix instruction]
6. [Fix instruction]

---

## Estimated Score After Fixes

| Metric            | Current Score | Projected Score |
|-------------------|---------------|-----------------|
| SEO Score         | [X/100]       | [X/100]         |
| AEO Score         | [X/100]       | [X/100]         |
| Readability Score | [X/100]       | [X/100]         |
| Overall Score     | [X/100]       | [X/100]         |