/seo-geo-optimizer

name: seo-geo-optimizer
description: Comprehensive SEO/GEO/AEO analysis toolkit for optimizing content visibility across traditional search engines (Google, Bing), AI platforms (ChatGPT, Perplexity, Claude, Gemini, Grokipedia), answer engines (Google AI Overviews, Bing Copilot, featured snippets), voice assistants (Google Assistant, Siri, Alexa), and social media (Facebook, Twitter, LinkedIn, WhatsApp, Instagram). Analyzes HTML/Markdown/JSX files for metadata completeness, schema markup, keyword optimization, entity extraction, and generates multi-format audit reports with platform-specific recommendations.
author: Boris Djordjevic, 199 Biotechnologies
license: MIT. Complete terms in LICENSE

SEO/GEO/AEO Optimizer Guide

Overview

This skill analyzes content for SEO/GEO/AEO optimization across traditional search engines, AI platforms, and answer engines. Use it to audit content files, generate schema markup, validate metadata, extract keywords, and produce comprehensive reports with actionable recommendations.

**2025 Context**: AI-referred traffic grew 527% (Jan-May 2025). Content optimized for AI citation shows 33-40% higher visibility.

Quick Start

Comprehensive Audit

# Generate full audit report (JSON, Markdown, HTML)
python scripts/audit_report.py ~/project/about.html --format all

# Output: ~/Documents/SEO_Audit_YYYY-MM-DD_HH-MM-SS/
# - audit_report.json (raw data)
# - audit_report.md (readable text)
# - audit_report.html (visual dashboard)

Content Analysis

# Analyze file structure and metadata
python scripts/analyze_content.py ~/project/page.html

# Output: JSON with meta tags, schema, content structure, issues, score

Schema Generation

# Generate FAQ schema (highest AI citation probability)
python scripts/schema_generator.py faq \
  --question "What is longevity medicine?" \
  --answer "Longevity medicine optimizes biomarkers like LDL <70 mg/dL to reduce cardiovascular risk by 30-40%."

# Generate Article schema with E-E-A-T signals
python scripts/schema_generator.py article \
  --title "Understanding Biomarkers" \
  --author "Dr. Sarah Johnson" \
  --credentials "MD, PhD" \
  --date "2025-01-15"

Content Optimization (Phase 2)

# Full optimization pipeline for specific platform
python scripts/auto_implementer.py page.html perplexity

# Optimize content structure (meta description, FAQ, data tables)
python scripts/content_optimizer.py page.html

# Platform-specific optimization
python scripts/platform_optimizer.py page.html chatgpt

# Check freshness (3.2x citations for content <30 days old)
python scripts/freshness_monitor.py page.html

Core Operations

1. Metadata Validation

Validate meta tags, Open Graph, Twitter Cards, and schema completeness.

python scripts/metadata_validator.py ~/project/page.html

**Fix Critical Issues**:

• Title too short → Expand to 50-60 chars with brand name
• Missing og:image → Add 1200×630px image for social previews
• No schema → Generate FAQ/Article schema for AI citation

2. Keyword Analysis

Extract primary, semantic, long-tail, and question-based keywords with semantic clustering.

# Full analysis with clustering
python scripts/keyword_analyzer.py ~/project/page.html

# Fast mode without clustering
python scripts/keyword_analyzer.py ~/project/page.html --no-clusters

**Optimization Tips**:

• Primary keyword density: 1-3% (avoid stuffing)
• Add 3+ question keywords for voice search
• Long-tail phrases (3-4 words) for specificity
• Use keyword clusters to build pillar content strategy

3. Entity Extraction

Extract persons, organizations, places for Knowledge Graph optimization.

python scripts/entity_extractor.py ~/project/page.html

**E-E-A-T Signals** (+40% AI citation boost):

• Add full names with credentials (MD, PhD, MBA)
• Include institutional affiliations (Stanford, Harvard)
• Link to external profiles (Google Scholar, LinkedIn)

4. Schema Markup Generation

Generate JSON-LD schemas for AI platforms.

FAQ Schema (Highest Citation Probability)

python scripts/schema_generator.py faq \
  --question "What is optimal LDL cholesterol?" \
  --answer "Optimal LDL for longevity is <70 mg/dL, reducing cardiovascular risk by 30-40%."

**Voice Search Optimization**:

• Answers ≤29 words for voice assistants
• Natural language questions
• Direct, specific answers

5. IndexNow Instant Indexing

Submit URLs directly to search engines for immediate indexing (Bing, Yandex, Seznam, Naver).

# Generate key (one-time setup)
python scripts/indexnow_submit.py --generate-key --output ./public

# Submit URL after publishing
python scripts/indexnow_submit.py https://yoursite.com/new-page --key YOUR_KEY

# Batch submit
python scripts/indexnow_submit.py --batch urls.txt --key YOUR_KEY

**GEO Impact**:

• Bing index feeds AI platforms (ChatGPT, Perplexity, Claude)
• Content indexed in minutes vs weeks
• 3.2x citation boost for fresh content (<30 days)

Platform Optimization

ChatGPT (Depth & Authority)

• Comprehensive coverage (1500-2500 words)
• Author credentials prominent (MD, PhD, MBA)
• Citations to primary sources (PubMed, arXiv)
• Evidence-based claims with statistics

Perplexity (Freshness & Citations)

• Recent `dateModified` (update weekly)
• Inline citations with links
• Specialized, deep-dive content
• Current statistics (2024-2025)

Claude (Accuracy & Primary Sources)

• Primary source citations only
• Methodology transparent
• Limitations acknowledged
• Data availability stated

Gemini (Community & Local)

• User reviews and ratings
• Google Business Profile optimized
• Local citations (NAP consistency)
• Traditional authority signals

Grokipedia (xAI, Transparency & RAG)

• RAG-based citations (20-30% better factual consistency)
• Transparent version history and licensing
• Primary source attribution (publisher + year)
• Wikipedia-derived content requires CC-BY-