## Keyword Research Report: [Topic]

### Primary Keywords
| Keyword | Intent | Difficulty | Opportunity Score |
|---------|--------|------------|-------------------|

### Long-tail Variations
- [keyword variation 1]
- [keyword variation 2]

### Content Recommendations
1. [Recommended article topic and angle]
2. [Recommended article topic and angle]

### PAA Questions to Target
- [Question 1]
- [Question 2]

## Content Optimization Report: [filename]

### SEO Score: [X]/100

### Quick Wins (Auto-fixable)
- [ ] [Issue 1] → [Fix]
- [ ] [Issue 2] → [Fix]

### Manual Review Required
- [ ] [Issue with explanation]

### Internal Link Suggestions
Link from: "[anchor text]" → /blog/[related-post]

## Technical SEO Audit Report

### Overall Score: [X]/100 [Status Badge]

### Critical Issues (Fix Immediately)
- [Issue with impact and fix instructions]

### Warnings (Should Fix)
- [Issue with impact]

### Passed Checks
- [X] [Check name]

### Recommendations Priority Queue
1. [Highest impact fix]
2. [Second priority]

## Competitor Analysis: [URL]

### Content Comparison
| Metric | Competitor | Our Site | Gap |
|--------|------------|----------|-----|
| Avg. Content Length | | | |
| Schema Types | | | |

### Keyword Gap (They Rank, We Don't)
- [keyword 1]
- [keyword 2]

### Actionable Opportunities
1. [Opportunity with implementation suggestion]

{
  "technologies": [
    {
      "slug": "nextjs",
      "name": "Next.js",
      "description": "The React Framework for the Web",
      "features": ["SSR", "SSG", "API Routes"],
      "relatedPosts": []
    }
  ],
  "roles": [
    {
      "slug": "frontend-developer",
      "name": "Frontend Developer",
      "keywords": ["React", "CSS", "JavaScript"],
      "challenges": ["responsive design", "performance"]
    }
  ],
  "features": [
    {
      "slug": "dark-mode",
      "name": "Dark Mode",
      "description": "Eye-friendly dark theme support",
      "benefits": ["reduced eye strain", "battery saving"]
    }
  ],
  "templates": {
    "techRole": {
      "titlePattern": "Best {tech} Portfolio for {role}s | Build Your Developer Portfolio",
      "descriptionPattern": "Create a stunning {role} portfolio with {tech}. Features include {features}."
    }
  }
}

// app/templates/[tech]/[role]/page.tsx
export async function generateStaticParams() {
  // Returns all tech × role combinations
}

export async function generateMetadata({ params }) {
  // Dynamic meta tags based on tech + role
}

export default function TemplatePage({ params }) {
  // Unique content for each combination
  // - Hero section
  // - Features grid
  // - Related blog posts
  // - FAQ section with Schema
  // - CTA
}

## Internal Link Report

### Site Link Graph Summary
- Total pages: X
- Average links per page: X
- Orphan pages: X

### Recommended Link Insertions
| Source | Anchor Text | Target | Reason |
|--------|-------------|--------|--------|

### Orphan Page Rescue
- [page] → Suggested link from [source]

Step 1: Technical Health Check
    ↓
Step 2: Content Batch Scoring (all blog posts)
    ↓
Step 3: Keyword Gap Analysis (WebSearch for core topics)
    ↓
Step 4: Generate Prioritized Improvements
    ↓
Output: Comprehensive Report + Executable Fix List

## Comprehensive SEO Analysis Report

Generated: [timestamp]

### Executive Summary
- Overall Health Score: [X]/100
- Critical Issues: X
- Quick Wins Available: X
- Estimated Impact: [High/Medium/Low]

### Technical Health
[Technical audit results]

### Content Analysis
[Batch content scoring]

### Keyword Opportunities
[Gap analysis results]

### Prioritized Action Items
1. [Highest impact, easiest fix]
2. [High impact]
3. ...

### One-Click Fixes Available
Run `apply seo fixes` to automatically fix X issues.

ai-blog-writer creates content
        ↓
pseo-engine optimizes content
        ↓
Publish optimized article