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.4, gpt-5.4-pro, gpt-5.4-mini, gpt-5.4-thinking, gpt-5.2-pro, gpt-5.2	`gpt-` , `o1` , `o3`
Google	gemini-3.1-pro-preview, gemini-3.1-flash-lite, gemini-3-flash, gemini-2.5-pro	`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)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


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


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


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


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


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:

export ANTHROPIC_API_KEY=sk-ant-...

Or to use GPT:

export OPENAI_API_KEY=sk-...

The skill itself is free. You pay the provider directly for API usage at their standard rates.

⚠️ Important Privacy Notice

Your content IS sent to third-party AI providers. Before using this skill with sensitive content, review the privacy policy of your chosen provider:

Anthropic Privacy: https://www.anthropic.com/legal/privacy
OpenAI Privacy: https://openai.com/policies/privacy-policy
Google Gemini Terms: https://ai.google.dev/gemini-api/terms
OpenRouter Privacy: https://openrouter.ai/privacy
Mistral Terms: https://mistral.ai/terms/

Recommendation: Test with non-sensitive sample content first. Each provider has different data retention policies.

🚀 Quick Start

1. Access the Skill

Available for free on ClawhHub - no subscription required

2. Set Up

Required:

API key for your chosen provider (see Credentials table above)

Optional:

Content to analyze (HTML or plain text)
Target keywords (recommended for better analysis)

3. Python Usage

from skills.seo_optimizer import SEOOptimizer
Initialize with default Claude model
optimizer = SEOOptimizer()
Or use a different model
optimizer = SEOOptimizer(model="gpt-5.4")  # Use GPT-5.4
optimizer = SEOOptimizer(model="gemini-3.1-pro-preview")  # Use Gemini 3.1
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}")

Tested Models (any model matching a provider prefix also works):

```
claude-opus-4-6
```
(Recommended — best quality)
```
claude-sonnet-4-6
```
```
claude-haiku-4-5-20251001
```
(Default — fastest/cheapest)

gpt-5.4

gpt-5.4-pro

gpt-5.4-mini

gpt-5.4-thinking

```
gpt-5.2-pro
```
,
```
gpt-5.2
```

gemini-3.1-pro-preview

gemini-3.1-flash-lite

gemini-3-flash

```
gemini-2.5-pro
```
,
```
gemini-2.5-flash
```

mistral-large-latest

mistral-small-latest

```
deepseek-chat
```
,
```
deepseek-reasoner
```
```
grok-4-1-fast
```
,
```
grok-3-beta
```
```
MiniMax-M2.1
```
```
qwen3.5-plus
```
,
```
qwen3-max-instruct
```

meta-llama/llama-4-maverick

meta-llama/llama-3.3-70b-instruct

4. CLI Usage

# 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 AI 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.8)

Content readability analysis (Flesch-Kincaid)
Keyword density tracking
Technical SEO audit
Multi-provider AI optimization (Claude, GPT-5.4, Gemini 3.1, DeepSeek, Grok, MiniMax, Qwen, Llama, Mistral)
AEO-specific recommendations
Impact estimation

🚧 Coming Soon

Competitor analysis - Compare your content to top Google results
Bulk analysis - Analyze multiple pages in one run
Export formats - PDF reports, JSON data, CSV analysis
Multi-language readability - Support beyond English

🔮 Future

Schema generation - Auto-generate JSON-LD schema
Link analysis - Deep internal/external link auditing
Content gap analysis - Identify missing topics in your content

📚 Resources

Support

Email: support@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

🚀 Get Started

Access this free skill on ClawhHub (no subscription needed)
Install the SDK for your provider:
```
pip install anthropic
```
(or openai, google-generativeai, mistralai)
Set the API key for your chosen provider (see Credentials table above)
Analyze your first piece of content

🏷️ 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.0.8] - 2026-04-09

✨ Model Updates

GPT-5.4 Series - Added gpt-5.4, gpt-5.4-pro, gpt-5.4-mini, gpt-5.4-thinking (released March 2026)
Gemini 3.1 Series - Added gemini-3.1-pro-preview, gemini-3.1-flash-lite (released February/March 2026)
Updated Claude model options to 4.6 series in manifest and docs

[1.0.7] - 2026-02-27

🏗️ Model-Agnostic Architecture

Provider auto-detected from model name prefix — no hardcoded whitelist
Any new model works automatically without code changes
Added DeepSeek, xAI Grok, MiniMax, Qwen as first-class providers
Updated Claude to 4.6 series (claude-opus-4-6, claude-sonnet-4-6)
Simplified internals — all OpenAI-compat providers share one code path

[1.0.6] - 2026-02-14

🔒 Security & Transparency Improvements

Source Code Included - Fixed license contradiction; source code IS included for transparency and security audits
License Clarification - Changed from "proprietary" to "free-to-use" with clear modification rights for personal use
Data Sharing Warnings - Added explicit warnings about third-party AI provider data sharing with links to privacy policies
Metadata Consistency - Fixed registry metadata to accurately reflect required environment variables
Install Recommendations - Updated requirements.txt and docs to recommend selective SDK installation (not all packages)

📝 Documentation Updates

Added GitHub repository and verifiable support contacts
Clarified which API key is required for which model
Added provider privacy policy links for informed consent
Updated all version references to 1.0.6

[1.0.2] - 2026-02-14

✨ 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: April 9, 2026 Current Version: 1.0.8 Status: Active & Maintained

SEO Optimizer Pro

AI Skill Market Insights

Be Part of the 0+ Developer Community