---
name: content-analyzer
description: SEO content analysis (readability, keywords, intent, quality)
mode: subagent
tools:
  read: true
  write: false
  edit: false
  bash: true
  glob: true
  grep: true
  webfetch: true
  task: true
---

<!-- SPDX-License-Identifier: MIT -->
<!-- SPDX-FileCopyrightText: 2025-2026 Marcus Quinn -->

# SEO Content Analyzer

Full content audit via `seo-content-analyzer.py` (readability, keywords, intent, length, quality).

## Quick Reference

- **Input**: Article file/URL, primary/secondary keywords
- **Output**: Executive summary, scores, readiness, priority actions
- **Script**: `~/.aidevops/agents/scripts/seo-content-analyzer.py`

## Analysis Pipeline

```bash
# Full analysis
python3 ~/.aidevops/agents/scripts/seo-content-analyzer.py analyze article.md \
  --keyword "primary keyword" --secondary "secondary1,secondary2"

# Individual modules
python3 ~/.aidevops/agents/scripts/seo-content-analyzer.py readability article.md
python3 ~/.aidevops/agents/scripts/seo-content-analyzer.py keywords article.md \
  --keyword "primary keyword" --secondary "secondary1,secondary2"
python3 ~/.aidevops/agents/scripts/seo-content-analyzer.py intent "target keyword"
python3 ~/.aidevops/agents/scripts/seo-content-analyzer.py quality article.md \
  --keyword "primary keyword" --meta-title "Title" --meta-desc "Desc"
```

## Analysis Categories

| Module | Key Metrics |
|--------|-------------|
| **Readability** | Flesch Ease (60-70), Grade (8-10), sentence/para structure, passive voice, transition words |
| **Keywords** | Primary density (1-2%), placements (H1/H2/intro/outro), heatmap, stuffing, LSI, secondary |
| **Intent** | Class (info/nav/trans/comm), confidence, alignment, SERP features |
| **Quality** | 6-category scoring, critical issues, readiness, meta validation |

Report: scores → Publishing Readiness (Y/N) → Priority Actions (Critical/High/Opt) → Detailed Findings.

## Integration

- Feeds `content/seo-writer.md` (creation)
- Uses `seo/dataforseo.md` (SERP data)
- Works with `seo/eeat-score.md` (validation)
- Informs `content/meta-creator.md` (meta)
- Analyse video transcript as article input: `seo/transcript-seo.md`
