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:
code
❌ 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:
- •Detailed workflow steps: workflow.md
- •Writing rules & SEO reference: reference.md
- •Output templates: See templates/