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-SA attribution

AI Citation Optimization

TL;DR Strategy (+35% Citation Boost)

Place direct answer in first 60 words.

E-E-A-T Signals (+40% Citation Boost)

Author Credentials:

**Author**: Dr. Sarah Johnson, MD, PhD, FAAD
**Affiliation**: Stanford School of Medicine
**Published**: 2025-01-15 | **Updated**: 2025-11-11

Voice Search Optimization

29-Word Answers for voice assistants.

Reference Documentation

For detailed guides and templates, see the reference/ directory:

Optimization Guides:

• citation-optimization-guide.md - AI citation strategies
• entity-seo-guide.md - Knowledge Graph optimization
• platform-strategies.md - Platform-specific optimization
• voice-search-guide.md - Voice search optimization
• social-preview-guide.md - Open Graph, Twitter Cards
• schema-library.md - Complete JSON-LD reference

Templates (templates/ directory):

• meta-tags-template.html - Complete meta tags
• Schema templates (FAQ, Article, HowTo, Breadcrumb, Organization, Person)

Industry Examples (examples/ directory):

• medical-clinic/ - Healthcare optimization (15/100 → 92/100)
• consulting-firm/ - B2B entity SEO (22/100 → 89/100)
• saas-landing-page/ - LLMO optimization (18/100 → 94/100)

Common Issues & Solutions

Low AI Citation Rate

Solutions:

1. Add TL;DR in first 60 words (+35% boost)
2. Display author credentials (MD, PhD) (+40% boost)
3. Link to primary sources (PubMed, arXiv)
4. Update dateModified weekly
5. Add FAQ schema (highest citation probability)

Poor Social Media Previews

Solutions:

1. Add 1200×630px og:image
2. Use absolute URLs (https://...)
3. Include og:title and og:description
4. Test with platform validators

Knowledge Graph Not Showing

Solutions:

1. Add Organization schema to homepage
2. Create Person schema for key individuals
3. Ensure NAP consistency across web
4. Link external profiles (LinkedIn, Wikipedia)
5. Claim Google Business Profile

Performance Notes

Script Execution Times:

• analyze_content.py: <1 second
• metadata_validator.py: <1 second
• keyword_analyzer.py: <2 seconds
• entity_extractor.py: <1 second
• schema_generator.py: <1 second
• audit_report.py: 3-5 seconds

Requirements:

• Python 3.7+
• Stdlib only (no external dependencies)
• Works offline

Script Reference

Phase 1: Analysis:

• analyze_content.py <file> - Extract metadata, schema, structure
• metadata_validator.py <file> - Validate meta tags, OG, Twitter Cards
• keyword_analyzer.py <file> - Extract keywords
• entity_extractor.py <file> - Extract entities
• audit_report.py <file> [options] - Generate audit reports

Phase 2: Implementation:

• content_optimizer.py <file> - Rewrite content (meta description, FAQ, data tables)
• platform_optimizer.py <file> <platform> - Platform-specific (chatgpt, perplexity, claude, gemini, grokipedia)
• voice_optimizer.py <file> - Add voice search optimization (Speakable schema)
• freshness_monitor.py <file> - Check content age, recommend updates
• citation_enhancer.py <file> - Identify citation opportunities (+41% impact)
• auto_implementer.py <file> [platform] - Full optimization pipeline

Generation:

• schema_generator.py <type> [options] - Generate JSON-LD schemas

Indexing:

• indexnow_submit.py <url> --key KEY - Submit URL to search engines instantly
• indexnow_submit.py --batch <file> --key KEY - Batch submit URLs
• indexnow_submit.py --generate-key - Generate IndexNow key

Supported Files: HTML, Markdown, React/JSX Output Formats: JSON, Markdown, HTML

2025 Statistics

AI Citation Impact:

• 527% AI traffic growth (Jan-May 2025)
• 40.58% citations from top 10 SERP results
• +35% boost with TL;DR in first 60 words
• +40% boost with author credentials
• +40% boost with proper heading hierarchy

Voice Search:

• 29-word answers optimal
• FAQ schema: highest citation probability
• 80% of voice answers from top 3 results

Social Media:

• 1200×630px standard across platforms (Facebook, LinkedIn, WhatsApp)
• Instagram: 1080×1920px for Stories, 1080×1350px for Feed, bio link optimization
• 3x engagement with proper previews
• +250% WhatsApp/iMessage share rate with og:image

License

MIT License. See LICENSE file for complete terms.