seo-geo-optimizer

# 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

```bash
# 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

```bash
# 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

```bash
# 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)

```bash
# 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.

```bash
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.

```bash
# 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.

```bash
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)

```bash
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).

```bash
# 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**:
```markdown
**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