| name | seo-article-optimizer |
| description | Optimize single articles or landing pages for SEO. Analyzes keywords, readability, headings, meta tags, internal links, E-E-A-T signals, featured snippets. Outputs scores, optimized draft, and publish assets. Use for blog posts, landing pages, or single URL optimization. |
| allowed-tools | Read, Grep, Glob, WebFetch, Edit, Write |
SEO Article Optimizer
Optimize a single article or landing page to be publish-ready and trackable.
Outputs
- Structured Report — Scores, priorities, quick wins
- Optimized Draft — Markdown, preserving original voice
- Publishing Assets — Meta title/description, slug, alt text, internal links, snippet blocks
- Implementation Checklist — Ready for editors or engineering
When to Use
- "Help me optimize this article for SEO"
- "Generate meta tags for this page"
- "Improve readability and structure"
- "Target featured snippets"
- Input: Full article text, Markdown, or single page URL
Not Applicable (Use seo-site-audit Instead)
- Multi-page or site-wide: robots.txt, sitemap, canonical, site architecture, performance systems
Required Inputs
- Content: Full text or URL
- Search Intent: Informational / Commercial / Transactional (must specify one)
- Primary Keyword (optional): If not provided, will infer and state assumption
- Internal Link Targets (1-3 URLs): Product page, pricing page, signup page, etc.
- Tone: Keep original (default) / More authoritative / More marketing / More neutral
Scoring Model (100 points)
| Category | Points |
|---|
| Keywords & Intent Fit | 25 |
| Structure & Scanability | 20 |
| Readability | 15 |
| Meta/Slug/Assets | 15 |
| Internal Linking & Conversion | 10 |
| Content Depth & Trust | 15 |
Each category must include: score reasoning + highest priority fix.
Show deductions clearly:
❌ Keyword missing in H1: -5 points
⚠️ Density too low (0.8% vs target 1-2%): -3 points
✅ Good heading hierarchy: +0 (no deduction)
Issue Priority Classification
Critical (Fix Immediately):
- Missing or poor meta description
- No keyword in title or H1
- Keyword density too high/low (stuffing or insufficient)
High Priority:
- Poor readability score
- Chaotic heading hierarchy
- Images missing alt text
- Thin content
Medium Priority:
- Additional keyword opportunities
- Featured snippet opportunities
- Internal link optimization
Workflow
For detailed step-by-step workflow, see workflow.md.
Summary:
- Keywords & Intent Analysis
- Structure & Scanability Check
- Readability Metrics
- Meta/Slug/Alt/Links Generation
- Content Depth & E-E-A-T Signals
- Featured Snippet Opportunities
- Final Output (Report + Optimized Draft)
Constraints
- Never give advice without copy-paste ready meta/slug/rewrites
- Never force keywords unnaturally; prioritize natural expression (flag over-optimization risks)
- Never fabricate competitor data; if user wants comparison, request top URLs or permission to fetch
- Always preserve author's original voice and tone during optimization
Troubleshooting
| Issue | Solution |
|---|
| Cannot fetch URL | Ask user to provide page content directly |
| No keyword provided | Infer from content, state assumption clearly |
| Content too short for analysis | Request full article or note limitations |
| Missing internal link targets | Ask user for 1-3 conversion page URLs |
Supporting Files
For detailed information, read these files when needed:
