seo-optimizer-pro

# SEO Optimizer Pro

**AI-powered SEO content optimization for both Google ranking and AI search (AEO).**

Analyze and optimize content with Claude AI for search visibility across traditional Google results and emerging AI search platforms (ChatGPT, Google AI Overviews, Claude, etc).

---

## 🚀 Why This Skill?

### Problem Statement
SEO optimization requires balancing multiple objectives:
- Content must rank on Google with proper technical SEO
- AI search optimization (AEO) is a new frontier—getting cited in ChatGPT, Google AI Overviews, Claude responses
- Manual analysis of readability, keyword density, heading structure is time-consuming
- Unclear what will actually impact rankings vs. what's just best practice
- Need both technical optimization AND compelling AI-optimized content

### The Solution
Analyze and optimize content using Claude AI combined with technical SEO audits. Get specific recommendations for both traditional Google ranking AND emerging AI search visibility.

### Why This Matters
- **AI Search is Growing**: ChatGPT, Google AI Overviews, Claude are becoming major discovery channels
- **2026 Trend**: Quality content with proper structure ranks better in both systems
- **Data-Driven**: Real recommendations based on actual SEO metrics, not just generic advice
- **Dual Optimization**: One analysis optimizes for both Google AND AI search platforms

---

## ✨ What You Get

### Comprehensive SEO Analysis
Every analysis includes:
- 📊 **Readability Score** - Flesch-Kincaid grade level and readability metrics
- 🔑 **Keyword Analysis** - Density tracking and natural integration suggestions
- 📐 **Content Structure** - Heading hierarchy, paragraph length, word count
- 🎯 **Technical SEO** - Meta tags, link analysis, structured data
- 🤖 **AI Search Optimization** - Recommendations for ChatGPT citations, AI Overviews

### Multi-Model AI Integration
Works with multiple AI models for flexibility:
- **Claude 4.5 Series** - Highest quality reasoning (Opus, Sonnet, Haiku)
- **GPT-5.2 Series** - Advanced reasoning (Pro, Thinking, Instant)
- **Gemini 2.5/3.0** - Fast & efficient analysis
- **Llama 3.2/3.3** - Open-source alternative
- **Mistral Large** - High-performance model

Features:
- **Title Optimization** - SEO-friendly titles (40-60 chars)
- **Meta Descriptions** - Auto-generated descriptions (150-160 chars)
- **H1 Suggestions** - Optimized heading tags
- **Key Points Expansion** - What topics to expand for better coverage
- **Keyword Integration** - Natural ways to incorporate target keywords
- **Internal Linking Ideas** - Strategic internal linking opportunities

### Answer Engine Optimization (AEO)
Five specific recommendations to:
- Get your content featured in AI search results
- Appear as cited sources in ChatGPT, Google AI Overviews, Claude
- Optimize for question-answer format (how AI searches work)
- Build authority signals that AI systems recognize
- Structure content for AI comprehension and citation

### Technical Metrics
Analyze:
- Word count and content length
- Sentence and paragraph structure
- Keyword density by target keyword
- Heading structure (H1, H2, H3...)
- Readability (Flesch-Kincaid grade)
- Link analysis (internal/external)
- Content organization

---

## 📊 Real-World Example

```
ANALYZING: Blog post about "Cloud Storage Solutions"

═══════════════════════════════════════════════════════════════

📊 METRICS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Word Count: 847 words
• Readability Score: 68/100 (Good)
• Flesch-Kincaid Grade: 8.2 (High school level - good)
• Avg Paragraph: 32 words (Optimal range)

🔑 KEYWORD DENSITY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• cloud storage: 1.8% ✅ (Optimal)
• data security: 0.8% (Increase to 1-2%)
• backup solutions: 0.4% (Too low)

💡 TOP SUGGESTIONS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🟡 [KEYWORDS] "backup solutions" appears only 0.4% of the time
   Current: 0.4% → Recommended: 1-2%
   Impact: Better keyword relevance signal

🟢 [TECHNICAL] Heading structure is well organized
   Current: H1 (1), H2 (4), H3 (2) ✅
   Impact: Excellent for SEO and accessibility

🟡 [CONTENT] Consider expanding "data encryption" section
   Current: 1 paragraph → Recommended: 2-3 paragraphs
   Impact: More thorough topic coverage, higher authority

🤖 AI SEARCH OPTIMIZATION (AEO)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Add a FAQ section with common questions about cloud storage
   → This format gets cited in ChatGPT and Google AI Overviews

2. Include specific comparison tables (Google vs AWS vs Azure)
   → Structured data that AI systems cite as authoritative

3. Add a "Quick Summary" box with key takeaways
   → AI search pulls these summaries for AI-generated responses

4. Link to authoritative sources in your references
   → Shows expertise, increases citation likelihood

5. Structure content as problem → solution → benefits
   → Matches how AI systems generate responses

🎯 ESTIMATED IMPACT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Medium Impact - Implementing 3-5 suggestions could improve ranking
potential by 10-20%. Key factors: Expanding keyword coverage,
enhancing structure for AI readability, adding comparison tables.
```

---

## Use Cases

### Content Marketing
- Optimize blog posts for both Google and AI search
- Ensure content gets cited in ChatGPT, Google AI Overviews
- A/B test content structure recommendations
- Scale content optimization across multiple writers

### SEO Professionals
- Audit client websites for optimization opportunities
- Provide data-driven recommendations with impact estimates
- Build optimization reports with specific, actionable steps
- Track progress across multiple keyword targets

### Product Documentation
- Optimize docs for both search and AI assistant discovery
- Ensure technical content appears in AI search results
- Improve readability scores for accessibility
- Structure docs for AI system comprehension

### E-Commerce
- Optimize product descriptions for Google Shopping and AI search
- Improve category page rankings with strategic content
- Enhance FAQ sections for AEO visibility
- Increase organic traffic from emerging AI search channels

### News & Publishing
- Optimize articles for news search and AI citations
- Improve readability for different audience levels
- Structure content for AI system extraction and citation
- Track SEO performance metrics over time

---

## 🚀 Quick Start

### 1. Access the Skill
Available for free on ClawhHub - no subscription required

### 2. Set Up
Ensure you have:
- Your Anthropic API key configured
- Content to analyze (HTML or plain text)
- Target keywords (optional but recommended)

### 3. Python Usage

```python
from skills.seo_optimizer import SEOOptimizer

# Initialize with default Claude model
optimizer = SEOOptimizer()

# Or use a different model
optimizer = SEOOptimizer(model="gpt-5.2-pro")  # Use GPT-5.2
# optimizer = SEOOptimizer(model="gemini-3-pro")  # Use Gemini 3
# optimizer = SEOOptimizer(model="mistral-large-2501")  # Use Mistral

# Analyze content
results = optimizer.analyze_content(
    content="""
    <h1>Cloud Storage Solutions</h1>
    <p>Cloud storage has revolutionized how we store and access data...</p>
    ...(your content)...
    """,
    url="https://example.com/cloud-storage",
    target_keywords=["cloud storage", "data security", "backup solutions"]
)

# Get formatted results
print(optimizer.format_results(results))

# Access detailed metrics
print(f"Readability: {results.metrics.readability_score}/100")
print(f"Word Count: {results.metrics.word_count}")

# Get AI suggestions
print(results.content_optimization)

# Get AEO recommendations
for i, rec in enumerate(results.aeo_recommendations, 1):
    print(f"{i}. {rec}")
```

**Supported Models:**
- `claude-opus-4-5-20251101` (Recommended)
- `claude-sonnet-4-5-20250929`
- `claude-haiku-4-5-20251001`
- `gpt-5.2-pro`
- `gpt-5.2-thinking`
- `gpt-5.2-instant`
- `gemini-3-pro`
- `gemini-2.5-pro`
- `gemini-2.5-flash`
- `llama-3.3-70b`
- `llama-3.2-90b`
- `mistral-large-2501`

### 4. CLI Usage

```bash
# Analyze a file
seo-optimizer analyze "blog-post.html" --keywords "cloud storage" "data security"

# Generate optimization report
seo-optimizer analyze "article.txt" --report --output report.json

# Quick AEO analysis
seo-optimizer aeo "content.html" --keywords "topic-1" "topic-2"
```

---

## 🤖 AI Search Optimization (AEO) Deep Dive

### What is AEO?
Answer Engine Optimization is the practice of optimizing content to appear in AI-generated search results and as cited sources in AI chatbots (ChatGPT, Google AI Overviews, Claude, Perplexity, etc).

### Why AEO Matters
- **ChatGPT** can cite your content in responses (if properly formatted)
- **Google AI Overviews** pull information from highly-relevant, authoritative sources
- **Claude** and other AI systems prioritize structured, clear information
- **2026 Reality**: AI search is becoming a primary discovery channel alongside Google

### AEO Best Practices (From Analysis)

**1. Structure for AI Comprehension**
- Use clear heading hierarchy (H1 → H2 → H3)
- Break content into logical sections
- Use lists and bullet points liberally
- AI systems parse structured content better

**2. Direct Answers Format**
- Start with direct answer to the main question
- Support with detailed explanation
- Include supporting evidence/sources
- Match how humans ask questions

**3. Structured Data**
- FAQ schema for Q&A format
- Product schema for product pages
- Organization schema for company info
- Schema.org markup helps AI systems understand context

**4. Authority Signals**
- Link to authoritative sources
- Cite peer-reviewed research
- Include author credentials
- AI systems recognize and cite authoritative sources

**5. Comparison Tables**
- Structured comparisons get cited in AI responses
- Use tables for side-by-side information
- Include pros/cons lists
- AI systems ext

... (truncated)