# SEO Optimizer Pro

> SEO Optimizer Pro

- Skill: `demerzels-lab/seo-optimizer-pro` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add demerzels-lab/seo-optimizer-pro`
- Raw SKILL.md: https://api.skillmd.com/api/skills/demerzels-lab/seo-optimizer-pro/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: Demerzels-lab (https://skillmd.com/u/demerzels-lab)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/demerzels-lab/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 extract and cite these directly

---

## 🔒 Security & Privacy

### Data Handling
- ✅ Content analyzed in-memory only
- ✅ Not stored or transmitted to external servers
- ✅ Claude API processes via encrypted HTTPS
- ✅ Analysis results stored locally only

### API Keys
- ✅ API keys stored in environment variables
- ✅ Never logged or exposed
- ✅ Each provider uses their official API
- ✅ Zero-knowledge architecture

### Compliance
- ✅ GDPR compliant (no data storage)
- ✅ CCPA compliant (no data collection)
- ✅ Works with proprietary content
- ✅ No third-party data sharing

---

## ❓ FAQ

**Q: How do you calculate readability score?**
A: We use the Flesch-Kincaid grade level formula and convert it to a 0-100 scale. Higher scores = easier to read.

**Q: Are these recommendations guaranteed to improve rankings?**
A: No ranking is guaranteed, but these suggestions are based on proven SEO factors. Impact varies by industry, competition, and current content quality.

**Q: What's the difference between SEO and AEO?**
A: SEO optimizes for Google's algorithm. AEO optimizes for AI chatbots that generate responses. They overlap significantly—good content for humans is usually good for both.

**Q: Can I use this for languages other than English?**
A: The readability analysis is English-optimized, but keyword analysis and Claude suggestions work for any language.

**Q: How long should content be?**
A: It depends on topic complexity. Generally: 300+ words minimum, 1000+ for comprehensive coverage, 2000+ for pillar/authority pages.

**Q: What if I have a very long document?**
A: The skill analyzes the first 2000 characters by default. For longer documents, split into sections and analyze each separately.

**Q: Does this check technical SEO like page speed?**
A: This skill focuses on content optimization. For technical SEO (speed, mobile, crawlability), use tools like Google PageSpeed Insights.

**Q: Can I optimize for multiple keywords at once?**
A: Yes! Pass a list of target keywords. We'll analyze density for each and provide keyword-specific recommendations.

**Q: How accurate is the AEO scoring?**
A: AEO is still evolving. Our recommendations are based on 2026 best practices from AI search optimization research.

**Q: Does this skill generate SEO content from scratch?**
A: No, this skill analyzes and optimizes existing content. To generate new content, use other AI writing tools first.

---

## 🗺️ Roadmap

### ✅ Current Release (v1.0.0)
- Content readability analysis
- Keyword density tracking
- Technical SEO audit
- Claude AI optimization suggestions
- AEO-specific recommendations
- Real-time impact estimation

### 🚧 Coming Soon (v1.1.0)
- **Competitor analysis** - Compare your content to top 5 Google results
- **Bulk analysis** - Analyze 10+ pages in one run
- **Historical tracking** - Track optimization progress over time
- **Recommendation automation** - Apply suggestions automatically
- **Export formats** - PDF reports, JSON data, CSV analysis

### 🔮 Future (v1.2+)
- **Multi-language support** - Full support for 20+ languages
- **Schema generation** - Auto-generate JSON-LD schema
- **Link analysis** - Deep internal/external link auditing
- **Content gap analysis** - Identify missing topics in your content
- **Slack integration** - Run analyses from Slack
- **Team dashboards** - Shared workspace with multiple users
- **Historical analytics** - Track how content performs over time

---

## 📚 Resources

### Documentation
- 📖 **Full Guide**: https://docs.unisai.vercel.app/seo-optimizer
- 💡 **Tutorials**: https://docs.unisai.vercel.app/seo-optimizer/tutorials
- 🎓 **AEO Course**: https://docs.unisai.vercel.app/seo-optimizer/aeo-guide

### Community
- 💬 **Slack Community**: https://slack.unisai.vercel.app
- 📧 **Email Support**: support@unisai.vercel.app
- 🐛 **Bug Reports**: https://github.com/unisai/seo-optimizer/issues
- ⭐ **Feature Requests**: https://slack.unisai.vercel.app

### Contact
- Email: support@unisai.vercel.app
- Slack: https://slack.unisai.vercel.app
- Website: https://unisai.vercel.app

---

## 📄 License & Terms

This skill is **free and open to all users** on ClawhHub.

### ✅ You CAN:
- Use the skill for free, unlimited times
- Analyze unlimited content
- Export optimization reports
- Use for commercial purposes
- Use for personal and business projects

### ❌ You CANNOT:
- Redistribute or resell the skill
- Modify the source code without permission
- Reverse engineer the skill

**Full Terms**: See [LICENSE.md](LICENSE.md)

---

## 🚀 Get Started

1. Access this free skill on ClawhHub (no subscription needed)
2. Set your Anthropic API key
3. Analyze your first piece of content
4. Review recommendations and implement

---

## 🏷️ Tags

**Primary**: seo, content-optimization, aeo, ai-search, copywriting

**Categories**: seo-tools, content-analysis, marketing-tech, ai-optimization

**Features**: keyword-analysis, readability-scoring, meta-tag-generation, technical-seo, ai-search-optimization

---

## 📝 Changelog

### [1.1.0] - 2026-02-02

#### ✨ Multi-Model Support
- **Claude 4.5 Series** - Opus, Sonnet, Haiku models
- **GPT-5.2 Series** - Pro, Thinking, Instant variants
- **Gemini 2.5/3.0** - Google's latest models
- **Llama 3.2/3.3** - Meta's open-source models
- **Mistral Large** - Mistral AI's flagship model
- **Model Selection** - Choose your preferred AI model for analysis

#### 🔧 Technical Improvements
- Model-agnostic architecture for flexibility
- Support for 12+ leading AI models
- Dynamic model validation
- Improved API compatibility

### [1.0.0] - 2026-02-02

#### ✨ Initial Release
- **Content Analysis** - Readability, word count, paragraph structure
- **Keyword Tracking** - Density analysis for target keywords
- **Technical SEO** - Heading structure, link analysis, meta tags
- **AI Integration** - AI-powered title, description, H1 suggestions
- **AEO Optimization** - 5 specific recommendations for AI search visibility
- **Impact Estimation** - Predicted ranking improvement from optimizations
- **Beautiful Reports** - Formatted analysis with clear recommendations

#### 🎨 2026 Update
- Current 2026 models and pricing
- Professional, technical tone
- Focus on AEO (Answer Engine Optimization)

#### 🔒 Security & IP Protection
- IP watermark: `PROPRIETARY_SKILL_SEO_OPTIMIZER_2026`
- Zero data storage
- HTTPS-only API communication
- Environment variable security

---

**Last Updated**: February 2, 2026
**Current Version**: 1.0.0
**Status**: Active & Maintained

© 2026 UniAI. All rights reserved.