SEO Optimizer Pro

# SEO Optimizer Pro

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

Analyze and optimize content with 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 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

### Model-Agnostic AI Integration
Pass any model ID — provider is auto-detected from the model name prefix.
No hardcoded list; new models work without updates.

| Provider | Tested Models | Prefix |
|----------|--------------|--------|
| **Anthropic** | claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5-20251001 | `claude-` |
| **OpenAI** | gpt-5.2-pro, gpt-5.2, gpt-5.1 | `gpt-`, `o1`, `o3` |
| **Google** | gemini-2.5-pro, gemini-2.5-flash | `gemini-` |
| **Mistral** | mistral-large-latest, mistral-small-latest | `mistral-`, `mixtral-` |
| **DeepSeek** | deepseek-chat, deepseek-reasoner | `deepseek-` |
| **xAI** | grok-4-1-fast, grok-3-beta | `grok-` |
| **MiniMax** | MiniMax-M2.1 | `MiniMax`, `minimax` |
| **Qwen** | qwen3.5-plus, qwen3-max-instruct | `qwen` |
| **Meta Llama** | meta-llama/llama-4-maverick, meta-llama/llama-3.3-70b-instruct | `meta-llama/`, `llama-` |

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

---

## 🔐 Credentials Required

You need **one API key** — for whichever provider/model you want to use:

| Provider | Env Variable | Prefix | Get Key |
|----------|-------------|--------|---------|
| Anthropic | `ANTHROPIC_API_KEY` | `claude-` | https://console.anthropic.com |
| OpenAI | `OPENAI_API_KEY` | `gpt-`, `o1`, `o3` | https://platform.openai.com |
| Google | `GOOGLE_API_KEY` | `gemini-` | https://aistudio.google.dev |
| Mistral | `MISTRAL_API_KEY` | `mistral-`, `mixtral-` | https://console.mistral.ai |
| DeepSeek | `DEEPSEEK_API_KEY` | `deepseek-` | https://platform.deepseek.com |
| xAI | `XAI_API_KEY` | `grok-` | https://console.x.ai |
| MiniMax | `MINIMAX_API_KEY` | `minimax`, `MiniMax` | https://platform.minimax.io |
| Qwen/Alibaba | `DASHSCOPE_API_KEY` | `qwen` | https://dashscope.aliyun.com |
| OpenRouter | `OPENROUTER_API_KEY` | `meta-llama/`, `llama-` | https://openrouter.ai |

**Only set the key for the provider you're using.** For example, to use Claude:
```bash
export ANTHROPIC_API_KEY=sk-