Content Optimizer

Overview

Content Optimizer bridges the gap between writing great content and ranking for it. It analyzes the top-ranking pages for your target keyword, extracts the topics and terms they cover, and compares them against your content to find what’s missing.

This isn’t keyword stuffing — it’s topical coverage. If every top-ranking page for “AI agents” discusses “multi-agent systems” and “agent frameworks,” and your page doesn’t, that’s a gap. Content Optimizer identifies these gaps and provides specific recommendations with priority rankings.

The skill also optimizes for readability, heading structure, internal linking opportunities, and featured snippet formatting.

How It Works

1. Analyze — Parse your content and target keyword
2. Benchmark — Scrape and analyze top 10 SERP results
3. Compare — Identify topical gaps, missing entities, and structural differences
4. Score — Rate your content’s optimization level (0-100)
5. Recommend — Provide specific, prioritized improvement suggestions

Use Cases

• Content refresh — Update old articles to regain rankings
• Pre-publish optimization — Ensure new content is fully optimized before publishing
• Competitive content — Match and exceed competitor content quality
• Featured snippets — Optimize content structure for snippet capture
• Content audits — Evaluate and prioritize optimization across entire sites

Getting Started

# Optimize a URL for a keyword
content-optimize --url "https://mysite.com/ai-agents" --keyword "AI agents"

# Optimize draft content
content-optimize --file draft.md --keyword "best coding agents" --output suggestions.md

Example

Analyzing: https://mysite.com/ai-agents-guide
Target keyword: "AI agents"

Content Score: 64/100

Missing Topics (high impact):
  + "multi-agent systems" — covered by 8/10 competitors
  + "agent frameworks comparison" — covered by 7/10 competitors
  + "AI agent security concerns" — covered by 6/10 competitors

Structure Improvements:
  📝 Add H2 for "How AI Agents Work" (all competitors have this)
  📝 Add comparison table (7/10 competitors use tables)
  📝 Add FAQ section (5/10 competitors, good for featured snippets)

Quick Wins:
  ✅ Add "multi-agent" to H2 heading
  ✅ Include 2-3 more internal links
  ✅ Add schema.org Article markup

Estimated improvement: 64 → 85/100 (+32% organic traffic potential)

Alternatives

• Surfer SEO — NLP-powered content optimization
• Clearscope — Content optimization platform
• MarketMuse — AI-driven content strategy and optimization