Seo Geo Optimizer

SEO/GEO/AEO Optimizer

Audit content for search engine and AI platform visibility. Generates schema markup, validates metadata, extracts keywords, and produces actionable reports.

When NOT to Use

• Creating new content from scratch (use content generation tools)
• Image optimization (use image-specific tools)
• Server-side performance (use web performance tools)

Decision Matrix

Pick the right script based on user intent:

Platforms for auto_implementer: chatgpt, perplexity, claude, gemini, grokipedia

Schema types: faq, article, howto, organization, person

Preflight

Before running any script, verify: 1. File exists and is a supported type (.html, .md, .mdx, .jsx, .tsx) 2. Python 3.7+ available (scripts use stdlib only, no external deps)

Error Handling

• FileNotFoundError: Check the path. Scripts accept absolute or relative paths.
• JSON decode errors: The input file may have malformed schema markup. Run metadata_validator.py first to identify issues.
• Low scores (< 50): Not an error. Run audit_report.py --format all for detailed recommendations, then apply fixes with auto_implementer.py.
• Script import errors: All scripts share scripts/shared/ utilities. Ensure the full scripts directory is intact.

Output

Reports saved to ~/Documents/SEO_Audit_YYYY-MM-DD_HH-MM-SS/ in three formats:

• JSON: Raw audit data for programmatic use
• Markdown: Readable report with recommendations
• HTML: Visual dashboard with scores and charts

References

Consulting Firm SEO/GEO Example

Industry: Professional Services / Management Consulting Business Type: Strategy & Operations Consulting Focus: Entity SEO & Knowledge Graph Optimization

---

Overview

This example demonstrates entity-focused SEO/GEO optimization for a management consulting firm. The strategy emphasizes Knowledge Graph integration, professional credentials, and B2B authority signals.

Key Difference from Medical Example: Less local focus, more emphasis on thought leadership, professional networks (LinkedIn), and entity relationships.

---

Before → After Comparison

Overall Score

• Before: 22/100 (Poor)
• After: 89/100 (Excellent)
• Improvement: +67 points (+305%)

Key Metrics

---

Critical Optimization: Entity SEO

Challenge

Consulting firms struggle with entity recognition because:

• Individual consultants are the brand (not location-based)
• Services are intangible (hard to describe uniquely)
• Authority depends on personal credentials
• Knowledge Graph prioritizes established entities

Solution: Multi-Entity Strategy

1. Organization Entity

Schema Implementation:

{
  "@type": "ProfessionalService",
  "name": "Strategic Advisory Partners",
  "description": "Management consulting specializing in market entry strategy, operational transformation, and M&A advisory",
  "foundingDate": "2015",
  "founders": [
    {
      "@type": "Person",
      "@id": "https://strategicadvisory.com/team/john-smith#person"
    },
    {
      "@type": "Person",
      "@id": "https://strategicadvisory.com/team/emily-chen#person"
    }
  ],
  "sameAs": [
    "https://linkedin.com/company/strategic-advisory",
    "https://crunchbase.com/organization/strategic-advisory",
    "https://www.wikidata.org/wiki/Q12345678"
  ],
  "award": [
    "Top 50 Strategy Firms, Consulting Magazine 2024",
    "Forbes Best Management Consultants 2023"
  ]
}

Key Elements:

• ProfessionalService type (not LocalBusiness)
• Founded date for credibility
• Founders linked via @id
• Awards for authority
• Crunchbase + Wikidata (B2B validation)

2. Person Entities (Consultants)

Example: Managing Partner

{
  "@type": "Person",
  "@id": "https://strategicadvisory.com/team/john-smith#person",
  "name": "John Smith",
  "honorificSuffix": "MBA, CFA",
  "jobTitle": "Managing Partner, Strategy Practice",
  "worksFor": {
    "@type": "Organization",
    "@id": "https://strategicadvisory.com/#organization"
  },
  "alumniOf": [
    {
      "@type": "EducationalOrganization",
      "name": "Harvard Business School"
    },
    {
      "@type": "EducationalOrganization",
      "name": "MIT Sloan School of Management"
    }
  ],
  "sameAs": [
    "https://linkedin.com/in/johnsmith-strategy",
    "https://twitter.com/johnsmithMBA",
    "https://www.wikidata.org/wiki/Q87654321"
  ],
  "knowsAbout": [
    "Market Entry Strategy",
    "Operational Transformation",
    "M&A Advisory",
    "Private Equity"
  ],
  "award": [
    "40 Under 40, Business Insider 2023",
    "Top Strategy Consultant, Forbes 2022"
  ],
  "colleague": [
    {
      "@type": "Person",
      "@id": "https://strategicadvisory.com/team/emily-chen#person"
    }
  ]
}

Critical Fields:

• honorificSuffix: MBA, CFA (B2B credentials)
• alumniOf: Harvard, MIT (educational pedigree)
• sameAs: LinkedIn (MUST-HAVE for B2B)
• knowsAbout: Expertise areas (topical authority)
• colleague: Entity relationships

3. Service Entities

Example: Strategy Service

{
  "@type": "Service",
  "serviceType": "Market Entry Strategy",
  "provider": {
    "@type": "Organization",
    "@id": "https://strategicadvisory.com/#organization"
  },
  "areaServed": {
    "@type": "Country",
    "name": "United States"
  },
  "hasOfferCatalog": {
    "@type": "OfferCatalog",
    "name": "Strategy Services",
    "itemListElement": [
      {
        "@type": "Offer",
        "itemOffered": {
          "@type": "Service",
          "name": "Market Assessment",
          "description": "Comprehensive market analysis with competitive landscape, TAM/SAM/SOM sizing, and entry recommendations"
        }
      }
    ]
  }
}

---

Content Strategy: Thought Leadership

Before

• Generic service descriptions
• No author attribution
• No case studies
• No quantified results

After: Authority Content

1. Consultant Profiles (Person Pages)

Each consultant gets a dedicated profile page with:

# John Smith, MBA, CFA - Managing Partner

**TL;DR**: John Smith leads Strategic Advisory's market entry practice, advising 50+ companies on expansion strategy. Former McKinsey consultant and Harvard MBA with $2B+ in transaction value across 100+ projects.

## Expertise
- Market entry strategy (15+ years)
- Operational transformation
- M&A advisory (50+ deals closed)
- Private equity partnerships

## Experience
### Strategic Advisory Partners (2015-Present)
- Founded market entry practice
- Advised Fortune 500 on international expansion
- $2B+ transaction value

### McKinsey & Company (2008-2015)
- Senior Associate, Strategy Practice
- Led 30+ client engagements
- Specialized in PE portfolio optimization

## Education
- MBA, Harvard Business School (2008)
- MS Management, MIT Sloan (2006)
- BS Economics, Yale University (2004)

## Publications
- "Market Entry Frameworks for Technology Companies" (2024)
- "Operational Excellence in PE Portfolio Companies" (2023)
- 20+ articles in Harvard Business Review, McKinsey Quarterly

## Awards
- 40 Under 40, Business Insider (2023)
- Top Strategy Consultant, Forbes (2022)

## Speaking
- SXSW 2024: "AI-Driven Market Analysis"
- Web Summit 2023: "International Expansion Strategies"
- Harvard Business Conference 2023 (keynote)

## External Profiles
- LinkedIn: linkedin.com/in/johnsmith-strategy
- Twitter: @johnsmithMBA
- Google Scholar: scholar.google.com/citations?user=XYZ

## Schema Implementation
[Person schema with all above details]

E-E-A-T Signals:

• ✅ Experience: 15+ years, specific numbers
• ✅ Expertise: Area specialization with evidence
• ✅ Authoritativeness: Publications, speaking, awards
• ✅ Trustworthiness: External validation (LinkedIn, etc.)

2. Case Studies (Proof)

# Case Study: Global Tech Company Market Entry

**Client**: Fortune 500 Software Company (confidential)
**Challenge**: Enter $8B European SaaS market
**Timeline**: 6-month engagement
**Results**:
- Market entry strategy → 3 target markets identified
- Revenue: $45M Year 1, $120M Year 2
- ROI: 8x consulting investment
- Market share: #3 position in 18 months

**Consultant**: John Smith, MBA, CFA
**Published**: 2024-03-15
**Modified**: 2025-11-11

[Full case study with methodology, analysis, results]

Schema:

{
  "@type": "CreativeWork",
  "headline": "Global Tech Company Market Entry Case Study",
  "author": {
    "@type": "Person",
    "@id": "https://strategicadvisory.com/team/john-smith#person"
  },
  "about": {
    "@type": "Thing",
    "name": "Market Entry Strategy"
  },
  "datePublished": "2024-03-15",
  "citation": [
    {
      "@type": "CreativeWork",
      "name": "Market Sizing Methodology",
      "author": "Smith & Johnson",
      "datePublished": "2023"
    }
  ]
}

---

LinkedIn Integration Strategy

Why LinkedIn Matters for Consulting

B2B buyers validate consultants through: 1. LinkedIn profiles (MOST IMPORTANT) 2. Company websites 3. Case studies 4. Peer recommendations

Implementation

1. Complete LinkedIn Profiles

Each consultant profile must include:

• Professional headshot
• Complete work history
• Detailed education
• Skills endorsed by 50+ connections
• Recommendations from clients (5+)
• Active content (1 post/week minimum)

2. Company Page Optimization

Company: Strategic Advisory Partners
Followers: 15,000+
Employees: 25-50
Industry: Management Consulting
Specialties: Market Entry, M&A, Operations

About:
Strategic Advisory Partners provides management consulting to Fortune 500 companies and private equity firms. Founded in 2015 by former McKinsey consultants, we specialize in market entry strategy, operational transformation, and M&A advisory.

Notable Clients: [redacted per NDA]
Transaction Value: $2B+ advised
Projects Completed: 200+
Industries Served: Technology, Healthcare, Financial Services

[Complete About section with keywords]

3. sameAs Implementation

"sameAs": [
  "https://linkedin.com/company/strategic-advisory",  // PRIMARY
  "https://linkedin.com/in/johnsmith-strategy",       // Each consultant
  "https://linkedin.com/in/emilychen-operations",     // Each consultant
  "https://crunchbase.com/organization/strategic-advisory",
  "https://www.wikidata.org/wiki/Q12345678",
  "https://twitter.com/strategicadvisory"
]

Validation: AI platforms check LinkedIn first for B2B entities

---

Knowledge Graph Strategy

Goal: Establish as Recognized Entity

Step 1: Entity Foundation (Month 1)

• [ ] Organization schema on homepage
• [ ] Person schema for each consultant
• [ ] LinkedIn profiles complete and linked
• [ ] Crunchbase profile created
• [ ] Company Wikipedia entry (if eligible)

Step 2: Entity Validation (Month 2-3)

• [ ] Publish thought leadership (10+ articles)
• [ ] Media mentions (Forbes, Harvard Business Review)
• [ ] Speaking engagements (conferences)
• [ ] Client testimonials (with permission)
• [ ] Industry awards (apply for recognitions)

Step 3: Entity Network (Month 4-6)

• [ ] Link consultant profiles (colleague relationships)
• [ ] Link to client organizations (with permission)
• [ ] Link to educational institutions (alumniOf)
• [ ] Link to publications (author schema)
• [ ] Build topic cluster authority

Expected Results

Month 3:

• Organization entity recognized
• Consultant profiles indexed
• LinkedIn integration complete

Month 6:

• Knowledge Panel for company
• Person panels for senior consultants
• Featured in "People Also Search For"
• Rich snippets for case studies

---

AI Platform Optimization

ChatGPT (B2B Research)

Query: "Who are the best market entry consultants?"

Before: Not mentioned

After: Listed with context

Strategic Advisory Partners, founded by former McKinsey consultants,
specializes in market entry strategy. Managing Partner John Smith (MBA, CFA,
Harvard) has advised 50+ companies with $2B+ transaction value.

Optimization:

• ✅ Credentials (MBA, CFA, McKinsey alumni)
• ✅ Quantified results ($2B+, 50+ companies)
• ✅ Institutional backing (Harvard, McKinsey)
• ✅ Specific expertise (market entry)

Perplexity (Real-Time B2B Search)

Query: "Compare market entry consulting firms"

Before: Not found

After: Included in comparison

Strategic Advisory Partners
- Founded: 2015 (Former McKinsey)
- Expertise: Market entry, M&A ($2B+ advised)
- Notable: 8x ROI on client engagements
- Recognition: Forbes Top Consultants 2023
- Source: strategicadvisory.com/about

Optimization:

• ✅ Recent dateModified
• ✅ Quantified metrics
• ✅ External validation (Forbes)
• ✅ Clear source attribution

Claude (Vetting Process)

Query: "Evaluate Strategic Advisory Partners consulting firm"

Before: "I don't have reliable information"

After: Detailed validation

Strategic Advisory Partners shows credibility signals:
- Founded by John Smith (Harvard MBA, ex-McKinsey)
- LinkedIn profile: 15K followers, verified
- Case studies: 5 published with client results
- External validation: Forbes recognition, HBR articles
- Transaction record: $2B+ documented
Status: Credible for market entry consulting

Optimization:

• ✅ External validation (LinkedIn, Forbes)
• ✅ Verifiable credentials
• ✅ Published case studies
• ✅ Institutional backing

---

B2B-Specific Schema Types

1. Organization with B2B Focus

{
  "@type": "ProfessionalService",
  "name": "Strategic Advisory Partners",
  "description": "Management consulting for Fortune 500 and PE firms",
  "serviceType": "Management Consulting",
  "areaServed": {
    "@type": "Country",
    "name": "United States"
  },
  "knowsAbout": [
    "Market Entry Strategy",
    "Operational Transformation",
    "M&A Advisory"
  ],
  "memberOf": [
    {
      "@type": "Organization",
      "name": "Association of Management Consulting Firms"
    }
  ],
  "award": [
    "Top 50 Strategy Firms, Consulting Magazine 2024"
  ],
  "numberOfEmployees": {
    "@type": "QuantitativeValue",
    "value": 35
  }
}

2. Service Catalog

{
  "@type": "OfferCatalog",
  "name": "Consulting Services",
  "itemListElement": [
    {
      "@type": "Offer",
      "itemOffered": {
        "@type": "Service",
        "name": "Market Entry Strategy",
        "description": "6-month engagement: Market assessment, competitive analysis, entry recommendations, implementation support",
        "category": "Strategy Consulting"
      },
      "priceSpecification": {
        "@type": "PriceSpecification",
        "priceCurrency": "USD",
        "price": "Contact for quote"
      }
    }
  ]
}

3. Consultant Network (Colleagues)

{
  "@type": "Person",
  "name": "John Smith",
  "colleague": [
    {
      "@type": "Person",
      "@id": "https://strategicadvisory.com/team/emily-chen#person",
      "name": "Emily Chen",
      "jobTitle": "Partner, Operations Practice"
    },
    {
      "@type": "Person",
      "@id": "https://strategicadvisory.com/team/michael-rodriguez#person",
      "name": "Michael Rodriguez",
      "jobTitle": "Partner, M&A Practice"
    }
  ]
}

Benefit: Google understands consultant relationships

---

Content Cluster Strategy

Hub Page: Market Entry Strategy

# Market Entry Strategy: Complete Guide

[Comprehensive hub page, 3,000+ words]

Internal links to:
- → Market Assessment Methodology
- → Competitive Landscape Analysis
- → TAM/SAM/SOM Sizing
- → Entry Mode Selection
- → Go-to-Market Planning
- → Case Study: Tech Company Entry
- → Case Study: Healthcare Expansion

Schema: Article with isPartOf connecting to hub

Spoke Pages: Specific Topics

Each spoke page (1,500+ words) links back to hub

• Market Assessment Methodology
• Competitive Landscape Analysis
• etc.

Result: Topic cluster authority for "market entry strategy"

---

Implementation Checklist

Week 1: Foundation

• [ ] Organization schema on homepage
• [ ] Person schema for 3 senior consultants
• [ ] LinkedIn profiles updated and linked (sameAs)
• [ ] Crunchbase profile created

Week 2: Content

• [ ] Consultant profile pages (3)
• [ ] Case studies published (3)
• [ ] Thought leadership articles (5)
• [ ] FAQ schema added

Month 1: Authority

• [ ] Media mentions (Forbes, HBR)
• [ ] Speaking engagements scheduled
• [ ] Industry awards applications
• [ ] Wikipedia entry (if eligible)

Month 3: Validation

• [ ] Monitor Knowledge Graph presence
• [ ] Test AI platform citations
• [ ] Refine based on results
• [ ] Scale to other consultants

---

Key Takeaways

1. LinkedIn is Critical: Primary validation for B2B entities 2. Individual Consultants = Brand: Person schema for each senior consultant 3. Credentials Matter: MBA, CFA, institutional affiliations (McKinsey, Harvard) 4. Quantify Everything: $2B+ transaction value, 50+ companies, 8x ROI 5. Entity Relationships: Link consultants (colleague), alumni (alumniOf), clients 6. Thought Leadership: 10+ articles, speaking engagements, awards 7. sameAs Priority: LinkedIn > Crunchbase > Wikidata > Twitter

---

ROI Estimates

Entity Recognition (Knowledge Graph):

• Baseline: 0 entity recognition
• After: Organization + 3 Person entities
• Brand authority: +300%

AI Citations:

• ChatGPT queries: 0 → 10-15/month
• Perplexity results: 0 → 8-12/month
• Claude validation: "Not found" → "Credible"

LinkedIn Engagement:

• Company followers: 1,000 → 15,000
• Profile views: 500/month → 5,000/month
• Inbound leads: +250%

---

Last Updated: November 11, 2025 Industry: Professional Services / Consulting Focus: Entity SEO & Knowledge Graph Optimization Level: Comprehensive (89/100)

Medical Clinic SEO/GEO Example

Industry: Healthcare / Medical Practice Business Type: Longevity Medicine & Aesthetic Treatments Location: San Francisco, CA

---

Overview

This example demonstrates comprehensive SEO/GEO optimization for a medical clinic specializing in longevity medicine and aesthetic treatments. It shows before/after transformation from poor implementation (Score: 15/100) to excellent optimization (Score: 92/100).

---

Files

• before.html - Poor SEO/GEO implementation (common mistakes)
• after.html - Fully optimized version (best practices)
• This README - Explanation of changes and results

---

Before → After Comparison

Overall Score

• Before: 15/100 (Critical)
• After: 92/100 (Excellent)
• Improvement: +77 points (+513%)

Key Metrics

---

Critical Changes Made

1. Meta Tags (+30% Impact)

Before:

<title>About Us</title>
<meta name="description" content="We are a medical clinic">

After:

<title>Longevity Medicine & Aesthetic Treatments | 199 Clinic San Francisco</title>
<meta name="description" content="Board-certified physicians providing evidence-based longevity medicine, aesthetic treatments, and regenerative therapies. Serving San Francisco since 2018. Book consultation today.">

Changes:

• Title: 8 → 61 characters (optimal)
• Description: 26 → 158 characters (optimal)
• Added primary keyword ("longevity medicine")
• Added brand name ("199 Clinic")
• Added location ("San Francisco")
• Added CTA ("Book consultation today")
• Added Open Graph tags (1200×630 image)
• Added Twitter Cards (summary_large_image)

Impact:

• +30 points to meta score
• Social media preview enabled
• Featured snippet eligible
• Better CTR in search results

2. Content Structure (+25% Impact)

Before:

• Two H1 tags (incorrect)
• No TL;DR
• Long paragraphs (hard to scan)
• No FAQ section
• No statistics
• 150 words total

After:

• Single H1 with primary keyword
• TL;DR in first 60 words (+35% citation boost)
• Short paragraphs (2-3 sentences)
• 5-question FAQ section (voice optimized)
• Statistics every 150-200 words
• 1,200+ words (comprehensive)

Impact:

• +35% AI citation probability (TL;DR)
• +25 points to content score
• Voice search optimized
• Featured snippet eligible
• Better user experience

3. E-E-A-T Signals (+40% Impact)

Before:

• No author byline
• No credentials
• Vague claims ("highly qualified")
• No dates
• No citations

After:

• Author: "Dr. Sarah Johnson, MD, PhD, FAAD"
• Affiliation: "Stanford School of Medicine"
• Education: "Harvard Medical School"
• Published: "January 15, 2023"
• Modified: "November 11, 2025"
• 3 citations to PubMed studies
• Quantified claims ("30-40% reduction")

Impact:

• +40% AI citation probability (credentials)
• +20 points to E-E-A-T score
• Google Knowledge Graph eligible
• ChatGPT prioritization
• Higher trust signals

4. Schema Markup (+20% Impact)

Before: No JSON-LD schema

After: 5 schemas implemented 1. MedicalBusiness (Organization)

• Name, address, phone (NAP)
• Founding date, founders
• Rating: 4.9/5 from 127 reviews
• sameAs links (LinkedIn, Twitter)

2. Person (Dr. Sarah Johnson)

• Full credentials (MD, PhD, FAAD)
• Affiliation (Stanford)
• Education (Harvard)
• Google Scholar, LinkedIn links
• @id for cross-referencing

3. Article (Content)

• Author (linked via @id)
• datePublished, dateModified
• Speakable schema (voice search)

4. FAQPage (Q&A)

• 5 questions (29-word answers)
• Voice search optimized
• Highest citation probability

5. BreadcrumbList (Navigation)

• Site structure
• Enhanced mobile display

Impact:

• +20 points to schema score
• Voice search enabled
• Rich snippets eligible
• AI citation probability increased
• Knowledge Graph integration

5. Entity Optimization (+15% Impact)

Before:

• No full names with credentials
• Generic "Dr. Johnson"
• No institutional affiliations
• No address details

After:

• Full name: "Dr. Sarah Johnson, MD, PhD, FAAD"
• Institutional affiliations:
• Works for: 199 Clinic
• Affiliation: Stanford School of Medicine
• Alumni: Harvard Medical School
• Complete NAP:
• 123 Market Street, Suite 400
• San Francisco, CA 94103
• +1-415-555-1234
• External validation:
• Google Scholar profile
• ORCID identifier
• LinkedIn profile

Impact:

• +15 points to entity score
• Google Knowledge Panel eligible
• Entity recognition in Knowledge Graph
• +40% AI citation boost
• Higher authority signals

---

AI Platform Results

ChatGPT (Depth & Authority)

• Before: Not cited (no credentials, no sources)
• After: High citation probability
• ✅ Comprehensive coverage (1,200 words)
• ✅ Author credentials (MD, PhD, FAAD)
• ✅ Citations to academic sources (PubMed)
• ✅ Evidence-based claims (quantified)
• ✅ Multiple perspectives

Perplexity (Freshness & Citations)

• Before: Not indexed (no dates, no sources)
• After: Priority citation
• ✅ Recent dateModified (2025-11-11)
• ✅ Inline citations with links
• ✅ Specialized, deep-dive content
• ✅ Clear source attribution
• ✅ Current statistics

Claude (Accuracy & Primary Sources)

• Before: Not trusted (no sources, vague claims)
• After: High trust
• ✅ Primary source citations only (PubMed)
• ✅ Methodology transparent
• ✅ Limitations acknowledged
• ✅ Data availability
• ✅ Credentials verified via external links

Gemini (Community & Local)

• Before: Not found (no NAP, no GMB)
• After: Local priority
• ✅ Complete NAP (Name, Address, Phone)
• ✅ Google Business Profile integration
• ✅ User reviews (4.9/5 from 127)
• ✅ Local citations
• ✅ Traditional authority signals

---

Voice Search Results

Before

• Google Assistant: "I couldn't find information about that."
• Siri: "Here's what I found on the web..."
• Alexa: "Sorry, I'm not sure about that."

After

• Google Assistant: Reads TL;DR and FAQ answers directly
• Siri: Provides featured snippet answer
• Alexa: Reads business info from MedicalBusiness schema

---

Featured Snippet Eligibility

Before

• No featured snippets
• No rankings for question queries
• No People Also Ask inclusion

After

• ✅ Featured snippet for "What is longevity medicine?"
• ✅ FAQ schema → People Also Ask
• ✅ TL;DR → Position zero eligible
• ✅ Voice search answers

---

Knowledge Graph Impact

Before

• No Knowledge Panel
• Not recognized as entity
• No social media integration

After

• ✅ Organization Knowledge Panel eligible
• Name: 199 Clinic
• Type: Medical Business
• Location: San Francisco, CA
• Rating: 4.9/5
• Social profiles linked

• ✅ Person Knowledge Panel eligible (Dr. Sarah Johnson)
• Credentials: MD, PhD, FAAD
• Affiliation: Stanford
• Education: Harvard
• Google Scholar linked

---

Social Media Previews

Before

• No preview image
• Generic title ("About Us")
• No description
• Unprofessional appearance

After

• ✅ 1200×630px preview image
• ✅ Optimized title (61 chars)
• ✅ Compelling description (158 chars)
• ✅ Professional display across:
• Facebook
• LinkedIn
• Twitter/X
• WhatsApp
• iMessage
• Slack

---

Implementation Timeline

Week 1

• ✅ Fix critical metadata (title, description)
• ✅ Add author credentials
• ✅ Implement FAQ schema
• ✅ Add TL;DR

Week 2

• ✅ Implement all schema types
• ✅ Add entity schemas (Person, Organization)
• ✅ Optimize heading hierarchy
• ✅ Add citations to primary sources

Month 1

• ✅ Expand content to 1,200+ words
• ✅ Add statistics and quantified claims
• ✅ Implement Open Graph and Twitter Cards
• ✅ Optimize for voice search

Month 3

• Monitor citation performance
• Refine based on results
• Scale to other content
• Document best practices

---

ROI Estimates

Based on 2025 industry data:

AI Citation Traffic:

• Baseline: 0 citations
• After optimization: 10-15 citations/month
• Traffic increase: +527% (industry average)

Featured Snippets:

• Before: 0 snippets
• After: 3-5 snippets (question queries)
• CTR improvement: +35-40%

Voice Search:

• Before: 0 voice results
• After: 5-8 voice answers
• Local discovery: +60%

Knowledge Panel:

• Before: No panel
• After: Organization + Person panels
• Brand awareness: +200%

Total Impact:

• Organic traffic: +200-300%
• AI platform visibility: +500%
• Brand authority: +400%
• Local discovery: +150%

---

Testing Checklist

After implementing changes, test:

• [ ] Google Rich Results Test (all schemas valid)
• [ ] Meta Tags Validator (no issues)
• [ ] Facebook Debugger (preview displays correctly)
• [ ] Twitter Card Validator (large image card)
• [ ] Voice search: "What is longevity medicine?"
• [ ] Voice search: "Where is 199 Clinic located?"
• [ ] Google Search: "199 Clinic" (Knowledge Panel)
• [ ] Google Search: "Dr. Sarah Johnson" (Person Panel)
• [ ] Mobile display (responsive, fast loading)
• [ ] PageSpeed Insights (Core Web Vitals pass)

---

Key Takeaways

1. Credentials Matter: +40% citation boost with MD, PhD, FAAD 2. TL;DR is Critical: +35% boost, place in first 60 words 3. FAQ Schema = Voice Search: Highest AI citation probability 4. Entity Recognition: Full NAP + sameAs = Knowledge Graph 5. Dates Matter: dateModified weekly for Perplexity priority 6. Primary Sources: Citations to PubMed/academic sources essential 7. Schema Interlinking: Use @id to connect Person → Organization → Article

---

Next Steps

1. Apply same principles to other pages:

• Services pages
• Treatment pages
• Blog articles
• Doctor profiles

2. Create topic clusters:

• Longevity medicine hub
• Aesthetic treatments hub
• Regenerative therapies hub

3. Build entity network:

• Individual doctor profiles (Person schema)
• Location pages (Place schema)
• Service pages (MedicalProcedure schema)

4. Monitor and iterate:

• Weekly: Update dateModified
• Monthly: Review AI citations
• Quarterly: Refine strategy

---

Last Updated: November 11, 2025 Industry: Medical / Healthcare Optimization Level: Comprehensive (92/100)

SaaS Landing Page SEO/GEO Example

Industry: Software as a Service (SaaS) Business Type: B2B Project Management Software Focus: LLMO (LLM Optimization) & Product Discoverability

---

Overview

This example demonstrates LLMO-focused SEO/GEO optimization for a SaaS product landing page. The strategy emphasizes AI platform discoverability, product comparison queries, and conversion-optimized content.

Key Difference: Focus on AI-generated product recommendations, comparison queries, and "best [tool] for [use case]" searches.

---

Before → After Comparison

Overall Score

• Before: 18/100 (Critical)
• After: 94/100 (Excellent)
• Improvement: +76 points (+422%)

Key Metrics

---

The LLMO Challenge for SaaS

Problem: AI Platforms Don't Recommend Unknown Products

Query: "What's the best project management software?"

ChatGPT Response:

• Before: [Your product] not mentioned
• After: "[Your product] is highly rated for [specific use case]"

Why? AI models prioritize: 1. Established entities (Knowledge Graph recognition) 2. Quantified claims (pricing, users, features) 3. Social proof (ratings, reviews, testimonials) 4. Clear differentiation (vs. competitors) 5. Recent information (dateModified)

---

Critical Optimization: Product Discoverability

1. SoftwareApplication Schema (MUST-HAVE)

{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "ProjectHub",
  "applicationCategory": "Project Management Software",
  "operatingSystem": "Web, iOS, Android, Windows, macOS",
  "offers": {
    "@type": "Offer",
    "priceCurrency": "USD",
    "price": "15.00",
    "priceSpecification": {
      "@type": "UnitPriceSpecification",
      "price": "15.00",
      "priceCurrency": "USD",
      "billingDuration": "P1M",
      "billingIncrement": 1
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "reviewCount": "2847",
    "bestRating": "5",
    "worstRating": "1"
  },
  "description": "AI-powered project management for remote teams. Trusted by 50,000+ companies to plan, track, and deliver projects 40% faster.",
  "applicationSubCategory": "Business Software",
  "screenshot": [
    "https://projecthub.com/images/screenshot-dashboard.jpg",
    "https://projecthub.com/images/screenshot-timeline.jpg",
    "https://projecthub.com/images/screenshot-reports.jpg"
  ],
  "featureList": [
    "AI-powered task prioritization",
    "Real-time collaboration",
    "Gantt chart timeline",
    "Resource allocation",
    "Time tracking",
    "Custom workflows",
    "API integrations (50+)",
    "Advanced reporting"
  ],
  "releaseNotes": "https://projecthub.com/changelog",
  "softwareVersion": "3.4.0",
  "dateModified": "2025-11-11",
  "creator": {
    "@type": "Organization",
    "@id": "https://projecthub.com/#organization"
  }
}

Critical Fields:

• offers: Pricing (AI models need this)
• aggregateRating: Social proof (4.8/5 rating)
• featureList: Specific capabilities
• applicationCategory: Clear classification
• operatingSystem: Platform availability

2. Organization Schema (Company)

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://projecthub.com/#organization",
  "name": "ProjectHub Inc.",
  "url": "https://projecthub.com",
  "logo": "https://projecthub.com/logo.png",
  "description": "AI-powered project management software for remote teams. Founded 2018, serving 50,000+ companies globally.",
  "foundingDate": "2018",
  "sameAs": [
    "https://linkedin.com/company/projecthub",
    "https://twitter.com/projecthub",
    "https://crunchbase.com/organization/projecthub",
    "https://www.wikidata.org/wiki/Q12345678"
  ],
  "slogan": "Work smarter, not harder",
  "numberOfEmployees": {
    "@type": "QuantitativeValue",
    "value": 150
  }
}

3. Product Schema (Detailed)

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ProjectHub",
  "description": "AI-powered project management for remote teams",
  "brand": {
    "@type": "Organization",
    "@id": "https://projecthub.com/#organization"
  },
  "offers": {
    "@type": "AggregateOffer",
    "lowPrice": "0",
    "highPrice": "99",
    "priceCurrency": "USD",
    "offerCount": "3",
    "offers": [
      {
        "@type": "Offer",
        "name": "Free Plan",
        "price": "0",
        "priceCurrency": "USD",
        "description": "Up to 10 users, basic features"
      },
      {
        "@type": "Offer",
        "name": "Pro Plan",
        "price": "15",
        "priceCurrency": "USD",
        "description": "Unlimited users, advanced features, priority support"
      },
      {
        "@type": "Offer",
        "name": "Enterprise Plan",
        "price": "99",
        "priceCurrency": "USD",
        "description": "Custom deployment, dedicated account manager, SLA"
      }
    ]
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "reviewCount": "2847"
  },
  "review": [
    {
      "@type": "Review",
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": "5"
      },
      "author": {
        "@type": "Person",
        "name": "Sarah Thompson"
      },
      "datePublished": "2025-10-15",
      "reviewBody": "ProjectHub transformed our remote team coordination. Task completion rate improved 40% in 3 months. The AI prioritization is incredibly accurate."
    }
  ]
}

---

Content Strategy: Comparison & Use Case Optimization

Target Queries

Comparison Queries (High Intent):

• "ProjectHub vs. Asana"
• "ProjectHub vs. Monday.com"
• "ProjectHub vs. Trello"
• "Best project management software"
• "Asana alternatives"

Use Case Queries:

• "Project management for remote teams"
• "Project management for agencies"
• "Project management for developers"
• "Project management for marketing teams"

Feature Queries:

• "Project management with AI"
• "Project management with Gantt charts"
• "Project management with time tracking"

Content Structure (Example: Landing Page)

# AI-Powered Project Management for Remote Teams | ProjectHub

**TL;DR**: ProjectHub is AI-powered project management software used by 50,000+ remote teams. Automate task prioritization, track progress in real-time, and deliver projects 40% faster. Free plan available. 4.8/5 rating from 2,847 reviews.

## What Is ProjectHub?

ProjectHub is AI-powered project management software designed for remote teams. Unlike traditional tools, ProjectHub uses machine learning to automatically prioritize tasks based on deadlines, dependencies, and team capacity.

Trusted by 50,000+ companies including Fortune 500 enterprises and fast-growing startups. Projects are completed 40% faster on average (internal study, 2024, n=1,200 teams).

### Key Features

**AI-Powered Prioritization** (+40% Efficiency)
Machine learning analyzes your project data and automatically prioritizes tasks. Studies show teams using AI prioritization complete projects 40% faster (ProjectHub, 2024).

**Real-Time Collaboration**
Update tasks, share files, and communicate without switching apps. 99.99% uptime SLA.

**Gantt Chart Timeline**
Visual project timelines with drag-and-drop scheduling. Auto-adjust dependencies when dates change.

**Resource Allocation**
See team capacity at a glance. AI suggests optimal task assignments based on workload and expertise.

**Time Tracking**
Built-in time tracking with automated timesheet generation. Integrates with payroll systems.

**Custom Workflows**
Build workflows that match your process. Templates for Agile, Waterfall, and hybrid methodologies.

**API Integrations**
Connect with 50+ tools: Slack, GitHub, Jira, Google Workspace, Microsoft 365, Salesforce.

**Advanced Reporting**
Real-time dashboards with customizable reports. Export to Excel, PDF, or Google Sheets.

## Who Uses ProjectHub?

### Remote Teams (Primary Use Case)
50,000+ distributed teams use ProjectHub to coordinate across time zones. Features built for async work:
- Async updates (no meetings required)
- Time zone-aware notifications
- Activity logs for full transparency

**Results**: 40% faster project completion, 60% fewer status meetings.

### Marketing Agencies
1,200+ agencies manage client projects with ProjectHub. Campaign planning, creative reviews, and client portals built-in.

**Results**: 30% more projects per quarter, 95% client satisfaction.

### Software Development Teams
8,000+ dev teams use ProjectHub for sprint planning and bug tracking. Integrates with GitHub, Jira, and CI/CD pipelines.

**Results**: 50% faster sprint velocity, 40% fewer bugs in production.

## ProjectHub vs. Competitors

### ProjectHub vs. Asana

| Feature | ProjectHub | Asana |
|---------|------------|-------|
| **AI Prioritization** | ✅ Yes | ❌ No |
| **Real-Time Collaboration** | ✅ Yes | ✅ Yes |
| **Gantt Charts** | ✅ Included | ⚠️ Premium only |
| **Time Tracking** | ✅ Built-in | ⚠️ Third-party |
| **Free Plan** | ✅ Up to 10 users | ✅ Up to 15 users |
| **Starting Price** | $15/user/month | $13.49/user/month |
| **Rating** | 4.8/5 (2,847 reviews) | 4.5/5 (12,000+ reviews) |
| **Best For** | AI-powered automation | Simple task management |

**Verdict**: Choose ProjectHub for AI prioritization and built-in time tracking. Choose Asana for larger free plan and simpler interface.

### ProjectHub vs. Monday.com

| Feature | ProjectHub | Monday.com |
|---------|------------|------------|
| **AI Prioritization** | ✅ Yes | ❌ No |
| **Customization** | ⭐️⭐️⭐️⭐️ | ⭐️⭐️⭐️⭐️⭐️ |
| **Learning Curve** | Easy (2 hours) | Moderate (1 day) |
| **Starting Price** | $15/user/month | $12/user/month |
| **Rating** | 4.8/5 | 4.7/5 |
| **Best For** | Remote teams, AI | Highly custom workflows |

**Verdict**: Choose ProjectHub for AI automation and faster onboarding. Choose Monday.com for maximum customization.

### ProjectHub vs. Trello

| Feature | ProjectHub | Trello |
|---------|------------|--------|
| **AI Prioritization** | ✅ Yes | ❌ No |
| **Gantt Charts** | ✅ Yes | ❌ No |
| **Time Tracking** | ✅ Yes | ❌ No |
| **Resource Management** | ✅ Yes | ❌ No |
| **Free Plan** | ✅ 10 users | ✅ Unlimited users |
| **Starting Price** | $15/user/month | $5/user/month |
| **Best For** | Complex projects | Simple boards |

**Verdict**: Choose ProjectHub for complex project management with AI. Choose Trello for simple Kanban boards at lower cost.

## Pricing

### Free Plan - $0/month
- Up to 10 users
- Unlimited projects
- Basic features
- 1 GB storage
- Community support

### Pro Plan - $15/user/month
- Unlimited users
- AI-powered prioritization
- Gantt charts
- Time tracking
- 100 GB storage
- Priority support
- API access

### Enterprise Plan - Custom Pricing
- Everything in Pro
- Custom deployment (on-prem or cloud)
- Dedicated account manager
- 99.99% uptime SLA
- Advanced security (SSO, SAML)
- Custom integrations

**14-day free trial** (no credit card required)

## Reviews & Testimonials

### What Customers Say

⭐️⭐️⭐️⭐️⭐️ 4.8/5 (2,847 reviews)

**Sarah Thompson, Marketing Director**
"ProjectHub transformed our remote team coordination. Task completion rate improved 40% in 3 months. The AI prioritization is incredibly accurate."

**Michael Chen, Engineering Manager**
"We switched from Jira to ProjectHub and haven't looked back. Sprint velocity increased 50%, and the team actually enjoys using it."

**Emily Rodriguez, Agency Owner**
"Managing 15+ client projects was chaos before ProjectHub. Now we deliver 30% more projects per quarter with the same team size."

### Industry Recognition

- **G2**: 4.8/5 (Best Project Management Software 2024)
- **Capterra**: 4.9/5 (Easiest to Use 2024)
- **Product Hunt**: #1 Product of the Day (March 2024)
- **Forbes**: "Best Project Management for Remote Teams" (2024)
- **TechCrunch**: "Rising Star in SaaS" (2023)

## FAQ

**Q: Is ProjectHub suitable for remote teams?**
A: Yes. ProjectHub is designed specifically for remote teams with async collaboration, time zone-aware notifications, and activity logs for transparency. 50,000+ distributed teams use ProjectHub.

**Q: Does ProjectHub have AI features?**
A: Yes. ProjectHub uses AI to automatically prioritize tasks based on deadlines, dependencies, and team capacity. Teams complete projects 40% faster on average with AI prioritization.

**Q: What integrations does ProjectHub support?**
A: ProjectHub integrates with 50+ tools including Slack, GitHub, Jira, Google Workspace, Microsoft 365, Salesforce, and Zapier. Full API available for custom integrations.

**Q: How much does ProjectHub cost?**
A: ProjectHub starts at $0/month for up to 10 users (Free Plan). Pro Plan is $15/user/month with AI features, Gantt charts, and time tracking. Enterprise pricing is custom.

**Q: Is there a free trial?**
A: Yes. 14-day free trial of Pro Plan (no credit card required). Free Plan available forever for up to 10 users.

## Get Started

**14-day free trial** • **No credit card required** • **Cancel anytime**

[Start Free Trial →]

---

Trusted by 50,000+ teams at:
[Company logos: Google, Microsoft, Spotify, Airbnb, etc.]

---

AI Platform Optimization Strategy

ChatGPT: Product Recommendations

Query: "What's the best project management software for remote teams?"

Optimization:

1. Clear Positioning
"ProjectHub is designed specifically for remote teams [differentiation]"

2. Quantified Claims
"50,000+ distributed teams [social proof]"
"40% faster project completion [measurable benefit]"

3. Feature Differentiation
"AI-powered prioritization [unique feature not in Asana/Trello]"

4. Pricing Transparency
"$15/user/month Pro Plan, Free plan for up to 10 users"

5. Social Proof
"4.8/5 rating from 2,847 reviews"

Result: ChatGPT includes ProjectHub in recommendations

For remote teams specifically, consider:

1. ProjectHub - Best for AI-powered automation
   - AI task prioritization
   - Built for remote teams
   - $15/user/month
   - 4.8/5 rating (2,847 reviews)

2. Asana - Best for simple task management
   [...]

Perplexity: Comparison Queries

Query: "ProjectHub vs Asana"

Optimization:

1. Comparison Tables
Create dedicated comparison pages with side-by-side tables

2. Objective Analysis
Include pros/cons for BOTH products (builds trust)

3. Quantified Differences
"ProjectHub: AI prioritization included
Asana: AI features not available"

4. Pricing Comparison
Clear, up-to-date pricing for both

5. Source Attribution
Link to both websites, cite version numbers

Result: Perplexity features comparison in results

According to projecthub.com/vs/asana (updated 2025-11-11):

Key Differences:
- AI Features: ProjectHub includes AI prioritization; Asana does not
- Time Tracking: ProjectHub has built-in tracking; Asana requires third-party
- Pricing: ProjectHub $15/user, Asana $13.49/user
- Rating: ProjectHub 4.8/5 (2,847), Asana 4.5/5 (12,000+)

Best for: ProjectHub → AI automation, Asana → Simplicity

Claude: Vetting & Validation

Query: "Is ProjectHub legitimate project management software?"

Optimization:

1. Verifiable Claims
"50,000+ companies" → Can be verified through press releases

2. External Validation
- G2 profile with reviews
- Capterra listing
- Product Hunt launch
- TechCrunch coverage

3. Transparent Limitations
"Best for: Remote teams
Not ideal for: Simple personal task management"

4. Methodology Transparency
"Internal study (2024, n=1,200 teams)" → Specific, verifiable

Result: Claude provides validation

ProjectHub appears to be a legitimate SaaS product:

Positive Signals:
- Established company (founded 2018)
- Verifiable customer count (50,000+, mentioned in TechCrunch)
- External reviews (G2: 4.8/5, Capterra: 4.9/5)
- Clear pricing and features
- API documentation available
- Regular updates (last: 2025-11-11)

Verification: Credible for remote team project management

---

Schema Implementation Priority

1. SoftwareApplication (MUST-HAVE)

Priority: Critical Impact: AI product recommendations Implementation: Homepage + /product page

2. AggregateRating (Social Proof)

Priority: Critical Impact: Trust signals, comparison queries Implementation: Homepage, /pricing, /reviews

3. FAQ (Voice Search)

Priority: High Impact: Voice search, featured snippets Implementation: Homepage, /faq

4. Product (Detailed Pricing)

Priority: High Impact: Price comparison queries Implementation: /pricing page

5. HowTo (Onboarding)

Priority: Medium Impact: "How to use [product]" queries Implementation: /getting-started

6. Organization (Company)

Priority: Medium Impact: Entity recognition, brand queries Implementation: Homepage, /about

---

Content Cluster Strategy

Hub: Project Management (Broad)

/project-management-software
  ├─ /project-management-for-remote-teams (spoke)
  ├─ /project-management-for-agencies (spoke)
  ├─ /project-management-for-developers (spoke)
  ├─ /project-management-with-ai (spoke)
  └─ /best-project-management-software (roundup)

Comparison Pages (High Intent)

/vs/asana
/vs/monday
/vs/trello
/vs/click-up
/vs/basecamp

Each page:

• Side-by-side comparison table
• Objective pros/cons for BOTH
• Use case recommendations
• Pricing comparison
• Link to both websites

Use Case Pages (Targeted)

/for/remote-teams
/for/agencies
/for/developers
/for/marketing-teams
/for/consultants

Each page:

• Industry-specific features
• Customer testimonials from that industry
• ROI data specific to use case
• Case study

---

Key Takeaways

1. SoftwareApplication Schema: MUST-HAVE for AI product recommendations 2. Quantified Claims: "50,000+ teams", "40% faster", "4.8/5 rating" 3. Comparison Content: Dedicated pages for "[Product] vs [Competitor]" 4. Pricing Transparency: Clear, up-to-date pricing in schema 5. Social Proof: Aggregate ratings with review count 6. Feature Differentiation: Highlight unique features (AI prioritization) 7. Use Case Targeting: Specific pages for target audiences 8. dateModified: Update weekly (Perplexity prioritizes fresh data)

---

ROI Estimates

AI Recommendations:

• Baseline: 0 mentions/month
• After optimization: 150+ mentions/month
• New sign-ups from AI: 50-75/month
• MRR from AI traffic: $7,500-$15,000

Comparison Queries:

• Visibility: 0% → 80% of comparison searches
• Traffic increase: +400%
• Conversion rate: 12% (high intent)

Voice Search:

• "Best project management" results: 0 → 5 placements
• Voice search traffic: +200%

Total Impact:

• Organic traffic: +300%
• Sign-ups: +250%
• MRR: +$15,000-$25,000/month
• CAC reduction: -40% (vs. paid ads)

---

Last Updated: November 11, 2025 Industry: SaaS / B2B Software Focus: LLMO & Product Discoverability Optimization Level: Comprehensive (94/100)

Phase 2: AI Optimization - Implementation Plan

Created: November 12, 2025 Status: In Planning Duration: Months 3-4 (8 weeks) Research Date: November 12, 2025

---

Executive Summary

Phase 2 transforms the SEO/GEO Optimizer from analysis-only to implementation-capable. Based on 2025 research analyzing 41M AI search results and 680M citations, this phase adds content rewriting, platform-specific optimization, and automated enhancement capabilities.

Key Insight: AI-referred traffic grew 527% (Jan-May 2025). Content with proper structure receives 40% more citations. Statistics Addition and Quotation Addition show 41% and 28% improvements over baseline.

---

Research Foundation (2025 Data)

GEO Best Practices

Content Structure (Princeton/Georgia Tech research):

• Short paragraphs: 60-100 words each
• Short sentences: 15-20 words maximum
• FAQ clusters: 40-60 word answers
• Evidence tables: Extractable facts with citations
• H2→H3→bullet structure: 40% more citations

Proven Optimization Methods:

• Statistics Addition: +41% improvement
• Quotation Addition: +28% improvement
• User-generated content: 450% citation surge (Reddit now 7.15%)
• Freshness: Content updated within 30 days = 3.2x more citations

Platform-Specific Citation Patterns

ChatGPT (40-60% of LLM traffic):

• Favors: Wikipedia (1.3M citations), G2 (196K), Forbes (181K)
• Structure: Answer-first, listicles, how-to guides (+35% citations)
• Schema: FAQPage and Article essential
• Credentials: Author credentials = +40% citation boost

Perplexity (Specialized/fresh content):

• Critical factor: Freshness (update every 2-3 days ideal, minimum 90 days)
• Structure: H2→H3→bullets (40% more citations)
• First hours: Critical for initial traction
• Prefers: Comprehensive guides, original research, comparisons

Claude (Growing, accuracy-focused):

• Attribution: 91.2% correct source attribution
• Citations: 5-8 primary sources with publisher + year
• Format: Inline citations, clickable links
• Recency: Current content for time-sensitive queries

Gemini (Google ecosystem):

• Traditional authority signals
• Community validation (Reddit-style)
• Google My Business integration
• Local Pack optimization

Voice Search (2025)

Market Size:

• 153.5M US users (20.5% globally)
• 75% of US households own smart speaker
• Featured snippets: 40.7% of voice answers

Optimization:

• Answer length: 30-40 words for featured snippets
• Speakable schema: 20-30 seconds (2-3 sentences) per section
• FAQ-style content with natural language
• Long-tail, question-based keywords

---

Phase 2 Architecture

What We Have (Phase 1)

✅ Analysis Layer:

• analyze_content.py - Extract metadata, structure, content
• metadata_validator.py - Validate meta tags, OG, Twitter
• keyword_analyzer.py - Extract keywords (primary, LSI, long-tail)
• entity_extractor.py - Extract persons, orgs, places
• schema_generator.py - Generate JSON-LD schemas
• audit_report.py - Generate reports (JSON, MD, HTML)

What We're Adding (Phase 2)

🆕 Implementation Layer:

• content_optimizer.py - Rewrite content for AI citation
• platform_optimizer.py - Apply platform-specific enhancements
• voice_optimizer.py - Enhance for voice search
• freshness_monitor.py - Track content age, recommend updates
• citation_enhancer.py - Add statistics, quotations, evidence tables
• auto_implementer.py - Orchestrate all optimizations

---

Implementation Plan

Week 1-2: Content Rewriting Engine

Script: content_optimizer.py

Purpose: Rewrite existing content following GEO best practices.

Core Functions:

def optimize_paragraph_length(text: str) -> str:
    """Break long paragraphs into 60-100 word chunks"""
    # Split paragraphs >100 words
    # Maintain semantic coherence
    # Return restructured text

def optimize_sentence_length(text: str) -> str:
    """Split long sentences into 15-20 word segments"""
    # Detect sentences >20 words
    # Split at natural break points (commas, conjunctions)
    # Preserve meaning

def add_tldr_section(content: Dict) -> Dict:
    """Generate TL;DR in first 40-60 words"""
    # Extract main topic from H1
    # Synthesize key points from H2s
    # Create direct answer (40-60 words)
    # Insert at content start

def create_faq_section(content: Dict) -> List[Dict]:
    """Generate FAQ from H2/H3 headings"""
    # Convert headings to questions
    # Extract/synthesize 40-60 word answers
    # Natural language format
    # Return FAQ schema + HTML

def add_evidence_tables(content: Dict) -> str:
    """Create extractable fact tables"""
    # Identify statistics in text
    # Extract claims with numbers
    # Format as table: Metric | Value | Source
    # Add schema markup

def enhance_heading_structure(content: Dict) -> Dict:
    """Optimize H2→H3→bullet hierarchy"""
    # Ensure single H1
    # Convert long paragraphs after H2 to H3+bullets
    # Add question-based H2s for voice search
    # Return restructured HTML

Input: HTML/Markdown file path Output: Optimized HTML/Markdown file Mode: Create new file or replace original (user choice)

Quality Gates:

• Preserve all facts and claims (no hallucination)
• Maintain original meaning and intent
• All statistics must have existing sources
• New headings must reflect existing content

---

Week 2-3: Platform-Specific Optimization

Script: platform_optimizer.py

Purpose: Apply platform-specific enhancements based on target AI engines.

Core Functions:

def optimize_for_chatgpt(content: Dict) -> Dict:
    """ChatGPT-specific optimization"""
    # Add author credentials prominently
    # Ensure 1500-2500 word count
    # Add citations to primary sources (PubMed, arXiv)
    # Generate Article schema with E-E-A-T
    # Format: Answer-first, listicles
    # Return enhanced content

def optimize_for_perplexity(content: Dict) -> Dict:
    """Perplexity-specific optimization"""
    # Update dateModified to current date
    # Add inline citations with [1], [2] format
    # Ensure H2→H3→bullet structure
    # Add "Last Updated" prominent display
    # Include current statistics (2024-2025)
    # Return enhanced content

def optimize_for_claude(content: Dict) -> Dict:
    """Claude-specific optimization"""
    # Add 5-8 primary source citations (publisher + year)
    # Transparent methodology section
    # Acknowledge limitations explicitly
    # Add "Data Sources" section
    # Inline citations with clickable links
    # Return enhanced content

def optimize_for_gemini(content: Dict) -> Dict:
    """Gemini-specific optimization"""
    # Add user reviews/testimonials
    # Generate Organization schema with GMB
    # Add local citations (NAP consistency)
    # Include community validation signals
    # Traditional authority signals (awards, press)
    # Return enhanced content

def optimize_multi_platform(content: Dict, platforms: List[str]) -> Dict:
    """Apply optimizations for multiple platforms"""
    # Combine strategies for selected platforms
    # Resolve conflicts (e.g., length preferences)
    # Prioritize universal best practices
    # Return balanced optimization

Conflict Resolution:

• ChatGPT wants 1500-2500 words, Perplexity wants freshness
• Solution: Comprehensive content + weekly updates
• Claude wants primary sources, ChatGPT wants Wikipedia
• Solution: Mix both (Wikipedia as intro, primary for depth)

---

Week 3-4: Voice Search Enhancement

Script: voice_optimizer.py

Purpose: Enhance content for voice assistants (Google Assistant, Siri, Alexa).

Core Functions:

def generate_featured_snippet_content(content: Dict) -> str:
    """Create 30-40 word summary for featured snippets"""
    # Extract main question/topic
    # Synthesize direct answer (30-40 words)
    # Use simple language (8th grade level)
    # Return snippet-ready text

def add_speakable_schema(content: Dict) -> Dict:
    """Add speakable schema to key sections"""
    # Identify 2-3 sentence segments (20-30 seconds)
    # Natural language, conversational tone
    # Add Speakable schema markup
    # Return content with schema

def optimize_for_questions(content: Dict) -> Dict:
    """Add question-based content"""
    # Generate who/what/where/when/why/how questions
    # Create natural language answers
    # Format as FAQ with short answers
    # Add FAQPage schema
    # Return enhanced content

def optimize_readability_for_voice(text: str) -> str:
    """Simplify language for TTS"""
    # Replace jargon with plain language
    # Simplify complex sentences
    # Remove parenthetical asides
    # Add pronunciation hints for technical terms
    # Return voice-friendly text

def generate_howto_schema(content: Dict) -> Dict:
    """Create HowTo schema for voice search"""
    # Extract step-by-step instructions
    # Format with durations (ISO 8601)
    # Add images for each step
    # Generate HowTo JSON-LD
    # Return schema

Voice Optimization Targets:

• Featured snippets: 40.7% of voice answers
• Answer length: 30-40 words ideal
• Reading level: 8th grade or lower
• Schema: Speakable + FAQ + HowTo

---

Week 4-5: Freshness Monitoring

Script: freshness_monitor.py

Purpose: Track content age and recommend updates based on platform requirements.

Core Functions:

def analyze_content_freshness(file_path: str) -> Dict:
    """Check content freshness indicators"""
    # Extract datePublished, dateModified from schema
    # Calculate days since last update
    # Identify dated content (years, "2023", "last year")
    # Check statistics currency (years in data)
    # Return freshness report

def recommend_update_frequency(content: Dict, platform: str) -> Dict:
    """Platform-specific update recommendations"""
    # Perplexity: Every 2-3 days (aggressive) or 90 days (minimum)
    # ChatGPT: Quarterly for evergreen, monthly for trends
    # Claude: When new research available (primary sources)
    # Gemini: Monthly for local, quarterly for general
    # Return schedule

def identify_outdated_elements(content: Dict) -> List[Dict]:
    """Find specific outdated content"""
    # Statistics with years (e.g., "2023: 10M users")
    # Dated language ("last year", "recently" >6 months old)
    # Old screenshots, images with dates
    # Deprecated practices or tools
    # Return list of issues with locations

def generate_update_recommendations(content: Dict) -> List[str]:
    """Specific actions to refresh content"""
    # Replace old statistics with current (source suggestions)
    # Update dateModified to today
    # Add "Last Updated: [Date]" prominent display
    # Refresh screenshots if applicable
    # Add recent case studies or examples
    # Return actionable list

def schedule_auto_updates(file_paths: List[str], config: Dict) -> Dict:
    """Create update schedule for multiple files"""
    # Analyze each file's platform targets
    # Determine optimal update frequency
    # Generate calendar schedule
    # Create monitoring alerts
    # Return schedule configuration

Monitoring Intervals:

• High priority (Perplexity focus): Weekly check, update every 2-3 days
• Medium priority (Multi-platform): Monthly check, update quarterly
• Low priority (Evergreen): Quarterly check, update annually

Automation:

• Cron job integration (optional)
• Email alerts when updates due
• Batch update recommendations
• Priority ranking (critical → low)

---

Week 5-6: Citation Enhancement

Script: citation_enhancer.py

Purpose: Add statistics, quotations, and evidence tables (41% and 28% improvement).

Core Functions:

def identify_citation_opportunities(content: Dict) -> List[Dict]:
    """Find locations to add statistics/quotations"""
    # Claims without numbers
    # General statements that could be quantified
    # Sections without expert quotes
    # Evidence-heavy topics (medical, technical)
    # Return opportunities with context

def suggest_statistics(context: str, topic: str) -> List[Dict]:
    """Suggest relevant statistics to add"""
    # Analyze paragraph context
    # Identify quantifiable claims
    # Suggest statistic types (percentages, growth, comparison)
    # Provide example format
    # Return suggestions with placeholders
    
    # NOTE: Does NOT fetch actual statistics (user must provide)
    # Suggests WHERE and WHAT TYPE of statistics to add

def suggest_quotations(context: str, topic: str) -> List[Dict]:
    """Suggest where to add expert quotations"""
    # Identify opinion statements
    # Find sections needing authority
    # Suggest quotation sources (researchers, practitioners)
    # Provide quotation format
    # Return suggestions with placeholders
    
    # NOTE: Does NOT generate fake quotes
    # Suggests WHERE quotes would strengthen content

def create_evidence_table(facts: List[Dict]) -> str:
    """Format facts as extractable evidence table"""
    # Structure: Metric | Value | Source | Year
    # Markdown table format
    # Add Table schema markup
    # Return table HTML/Markdown

def add_inline_citations(text: str, citations: List[Dict]) -> str:
    """Add citation markers to text"""
    # Format: [1], [2] or (Source, Year)
    # Link to references section
    # Clickable citations (Claude preference)
    # Return text with citations

def generate_references_section(citations: List[Dict]) -> str:
    """Create formatted references section"""
    # Sort by citation order
    # Format: [1] Author. Title. Publisher, Year. URL
    # Add schema markup (CitationEntity)
    # Return HTML/Markdown section

Quality Standards:

• NO fabricated statistics (user must provide real data)
• NO generated quotations (suggest existing quotes)
• All citations must have verifiable sources
• Evidence tables only from existing content facts

---

Week 6-7: Auto-Implementer Orchestration

Script: auto_implementer.py

Purpose: Orchestrate all Phase 2 optimizations in correct sequence.

Core Functions:

def auto_optimize_content(file_path: str, config: Dict) -> Dict:
    """Full automated optimization pipeline"""
    # 1. Run Phase 1 analysis (audit_report.py)
    # 2. Apply content optimization (content_optimizer.py)
    # 3. Apply platform optimization (platform_optimizer.py)
    # 4. Apply voice optimization (voice_optimizer.py)
    # 5. Add citation enhancements (citation_enhancer.py)
    # 6. Validate output (metadata_validator.py)
    # 7. Generate before/after report
    # Return optimization results

def create_optimization_preview(file_path: str, config: Dict) -> Dict:
    """Show changes before applying"""
    # Run optimizations in dry-run mode
    # Generate diff (before → after)
    # Highlight all changes
    # Provide approval prompt
    # Return preview report

def apply_selective_optimizations(file_path: str, selected: List[str]) -> Dict:
    """Apply only selected optimization types"""
    # User chooses: content, platform, voice, citations
    # Apply only selected modules
    # Preserve original for other aspects
    # Return partial optimization results

def batch_optimize_directory(directory: str, config: Dict) -> List[Dict]:
    """Optimize all files in directory"""
    # Find all HTML/MD files
    # Prioritize by current score (lowest first)
    # Apply optimizations with progress tracking
    # Generate batch report
    # Return results for all files

def configure_optimization_profile(name: str, settings: Dict) -> Dict:
    """Save reusable optimization profile"""
    # Platform targets (ChatGPT, Perplexity, etc.)
    # Aggressiveness level (conservative → aggressive)
    # Update frequency preferences
    # Content style preferences
    # Save as JSON profile
    # Return configuration

User Control:

• Preview before applying (dry-run mode)
• Selective optimization (choose modules)
• Aggressiveness levels: Conservative | Balanced | Aggressive
• Undo capability (backup original)

Optimization Profiles:

PROFILES = {
    "chatgpt_authority": {
        "platform": ["chatgpt"],
        "min_word_count": 1500,
        "add_credentials": True,
        "citation_style": "academic",
        "structure": "answer_first"
    },
    "perplexity_fresh": {
        "platform": ["perplexity"],
        "update_frequency": "weekly",
        "citation_style": "inline_numbers",
        "structure": "h2_h3_bullets",
        "emphasis": "freshness"
    },
    "multi_platform": {
        "platform": ["chatgpt", "perplexity", "claude"],
        "min_word_count": 1200,
        "update_frequency": "monthly",
        "citation_style": "mixed",
        "structure": "balanced"
    },
    "voice_optimized": {
        "platform": ["google_assistant", "siri"],
        "add_faq": True,
        "add_speakable": True,
        "featured_snippet": True,
        "reading_level": 8
    }
}

---

Testing Strategy

Test Cases

1. Basic Content Optimization:

• Input: /tmp/test-page.html (current basic page)
• Expected: TL;DR added, paragraphs split, FAQ section, evidence table
• Metrics: Word count 63→800+, score 43→70+

2. Platform-Specific Optimization:

• Input: Medical clinic page
• Target: ChatGPT (authority)
• Expected: Credentials prominent, 1500+ words, Article schema, citations
• Metrics: Score 70→85+

3. Freshness Enhancement:

• Input: Page with 2023 statistics
• Expected: Outdated elements identified, update recommendations
• Metrics: Freshness issues flagged, update schedule generated

4. Voice Optimization:

• Input: How-to content
• Expected: Featured snippet content, Speakable schema, HowTo schema
• Metrics: 30-40 word answers, 20-30 second segments

5. Citation Enhancement:

• Input: Content with claims but no statistics
• Expected: Citation opportunities identified, evidence table suggested
• Metrics: 5+ citation opportunities found

6. Full Auto-Optimization:

• Input: /tmp/test-page.html
• Config: Multi-platform profile
• Expected: All optimizations applied, before/after report
• Metrics: Score 43→80+, all recommendations addressed

Quality Assurance

Automated Checks:

• No fact hallucination (all claims from original)
• No fabricated statistics or quotes
• Valid JSON-LD schema output
• HTML/Markdown syntax valid
• All links working
• Metadata complete

Manual Review Required:

• Content meaning preserved
• Tone and style appropriate
• Brand voice maintained
• Technical accuracy verified

---

Integration with Phase 1

Workflow Update

Phase 1 (Analysis):

User: Audit this page
→ audit_report.py
→ Report: Score 43/100, issues found, recommendations
→ User reviews report

Phase 2 (Implementation):

User: Optimize this page for ChatGPT
→ auto_implementer.py --platform chatgpt
  → Runs audit_report.py (analysis)
  → Runs content_optimizer.py (structure)
  → Runs platform_optimizer.py (ChatGPT mode)
  → Runs citation_enhancer.py (add evidence)
  → Generates preview
→ User approves
→ Optimizations applied
→ Before/after report generated

File Organization

seo-geo-optimizer/
├── scripts/
│   ├── # Phase 1 (Analysis)
│   ├── analyze_content.py
│   ├── metadata_validator.py
│   ├── keyword_analyzer.py
│   ├── entity_extractor.py
│   ├── schema_generator.py
│   ├── audit_report.py
│   │
│   └── # Phase 2 (Implementation)
│       ├── content_optimizer.py       # NEW
│       ├── platform_optimizer.py      # NEW
│       ├── voice_optimizer.py         # NEW
│       ├── freshness_monitor.py       # NEW
│       ├── citation_enhancer.py       # NEW
│       └── auto_implementer.py        # NEW
│
├── profiles/
│   ├── chatgpt_authority.json         # NEW
│   ├── perplexity_fresh.json          # NEW
│   ├── multi_platform.json            # NEW
│   └── voice_optimized.json           # NEW
│
└── examples/
    └── phase2/                         # NEW
        ├── before-optimization/
        │   └── test-page.html
        ├── after-optimization/
        │   ├── test-page-chatgpt.html
        │   ├── test-page-perplexity.html
        │   └── test-page-multi.html
        └── optimization-report.md

---

Success Metrics

Quantitative Targets

Content Structure:

• Paragraph length: 60-100 words (90%+ compliance)
• Sentence length: 15-20 words (80%+ compliance)
• TL;DR: Present in first 60 words (100%)
• FAQ section: 3+ questions with 40-60 word answers (100%)

Platform Optimization:

• ChatGPT: 1500-2500 words, author credentials, Article schema (100%)
• Perplexity: H2→H3→bullets, inline citations, fresh dateModified (100%)
• Claude: 5-8 primary source citations, methodology section (100%)
• Voice: 30-40 word answers, Speakable schema, HowTo schema (100%)

Citation Enhancement:

• Statistics: 3+ statistics per 500 words
• Quotations: 1+ expert quote per major section
• Evidence tables: 1+ table for fact-heavy content
• References: Complete references section with clickable citations

Score Improvements:

• Low scores (0-40): +30-40 points → 70-80 range
• Medium scores (41-70): +20-30 points → 80-90 range
• High scores (71-90): +5-10 points → 85-95 range

Qualitative Targets

Content Quality:

• Meaning preserved (100% accuracy)
• Tone and style maintained
• Brand voice consistent
• No hallucinated facts

User Experience:

• Preview before applying (approval workflow)
• Clear diff view (before → after)
• Undo capability (backup original)
• Selective optimization (choose modules)

Performance:

• Content optimization: <5 seconds
• Full auto-optimization: <15 seconds
• Batch optimization: <3 seconds per file
• No external dependencies (Python stdlib only)

---

Risk Management

Potential Issues

1. Content Meaning Changed:

• Risk: Optimization alters original meaning
• Mitigation: Preserve all facts, manual review gate, undo capability
• Fallback: Conservative mode (minimal changes)

2. Over-Optimization:

• Risk: Content becomes formulaic, loses personality
• Mitigation: Aggressiveness levels, selective optimization, style preservation
• Fallback: Manual editing after auto-optimization

3. Fabricated Data:

• Risk: System generates fake statistics or quotes
• Mitigation: NO data generation, only suggest where to add, user provides data
• Validation: Fact-checking gate before applying

4. Schema Errors:

• Risk: Invalid JSON-LD breaks rich snippets
• Mitigation: Schema validation, test all outputs, error handling
• Fallback: Revert to original schema if validation fails

Quality Gates

Gate 1: Analysis:

• Audit existing content
• Identify optimization opportunities
• Generate recommendations
• → Proceed to Gate 2

Gate 2: Preview:

• Apply optimizations (dry-run)
• Generate before/after diff
• Show all changes to user
• → User approval required → Gate 3

Gate 3: Validation:

• Validate HTML/Markdown syntax
• Validate JSON-LD schemas
• Check fact preservation
• Run metadata_validator.py
• → All checks pass → Gate 4

Gate 4: Implementation:

• Backup original file
• Apply optimizations
• Generate optimization report
• → Complete

Gate 5: Verification (optional):

• Re-run audit on optimized file
• Compare scores (before → after)
• Verify all recommendations addressed
• → Success

---

Timeline

Week 1-2: Content Rewriting

• Build content_optimizer.py
• Test paragraph/sentence optimization
• Test TL;DR generation
• Test FAQ section creation
• Test evidence table formatting
• Test heading structure optimization

Week 3-4: Platform Optimization

• Build platform_optimizer.py
• Implement ChatGPT optimization
• Implement Perplexity optimization
• Implement Claude optimization
• Implement Gemini optimization
• Test multi-platform mode

Week 5-6: Voice & Freshness

• Build voice_optimizer.py
• Build freshness_monitor.py
• Test featured snippet generation
• Test Speakable schema
• Test freshness analysis
• Test update recommendations

Week 6-7: Citation & Orchestration

• Build citation_enhancer.py
• Build auto_implementer.py
• Create optimization profiles
• Build preview/approval workflow
• Test full pipeline

Week 8: Testing & Documentation

• Complete test suite
• Update SKILL.md with Phase 2
• Create Phase 2 examples
• Update README.md
• Commit and push to GitHub

---

Next Steps

1. Review this plan - Confirm approach and priorities 2. Begin implementation - Start with content_optimizer.py 3. Iterative testing - Test each script as built 4. User feedback - Validate optimizations maintain quality 5. Documentation - Update SKILL.md with new capabilities

---

Status: ✅ Plan complete, ready for implementation Research Sources: 41M AI search results, 680M citations (2025 data) Key Insight: Statistics Addition (+41%), Quotation Addition (+28%), Freshness (3.2x citations) Target: Transform analysis-only tool into full optimization pipeline

SEO/GEO Optimizer Skill - Implementation Plan

Created: November 11, 2025 Version: 1.0 Status: In Progress

---

Executive Summary

Purpose: Create a standalone Claude skill that analyzes and optimizes content for:

• Traditional SEO (meta tags, structured data)
• Generative Engine Optimization (GEO) - AI search engines (ChatGPT, Perplexity, Claude, Gemini)
• Large Language Model Optimization (LLMO) - Citation probability enhancement
• Voice Search (Google Assistant, Siri, Alexa)
• Social Media Previews (Open Graph, Twitter Cards, WhatsApp/iMessage)

Key Differentiator: Works with ANY content (HTML, Markdown, React/JSX), not just website generation.

Complements Existing Skills:

• minimalist-website-mvp - Website generator with built-in SEO (this skill audits existing content)
• deep-research - Research synthesis (this skill optimizes content structure)
• generating-pdf - PDF generation (this skill produces audit reports that can be converted to PDF)

---

Research Findings (2025)

LLM Traffic Growth

• 527% increase in AI-referred sessions (Jan-May 2025)
• 1,200% growth in generative AI traffic (Jul 2024-Feb 2025)
• 40.58% of AI citations come from top 10 SERP results
• 33.07% citation probability for #1 ranking position

Platform Market Share

• ChatGPT: 40-60% of LLM traffic (dominant)
• Perplexity: 0.073%+ specialized traffic
• Claude: Growing, prioritizes credible sources
• Gemini: Google integration, community validation

Platform-Specific Preferences

ChatGPT:

• High E-E-A-T content (Experience, Expertise, Authoritativeness, Trustworthiness)
• Named authors with credentials (MD, PhD = +40% citation probability)
• Educational/Wikipedia sources preferred
• Original research valued
• Schema-enhanced data

Perplexity:

• Transparent citations required
• Specialized sources preferred
• YouTube content indexed
• Clear URL structure important
• Current information (dateModified critical)

Claude:

• Credible sources mandatory
• Clear attribution required
• Depth and accuracy prioritized
• Well-structured content
• Primary sources preferred over secondary

Gemini:

• Google ecosystem integration
• Community-validated content (Reddit-style)
• Traditional authority signals
• Google My Business optimization
• Local Pack integration

Voice Search Statistics

• 20.5% of people worldwide use voice search
• 8.4 billion voice assistants globally
• 80%+ of answers come from top 3 results
• 29 words average voice answer length
• 52% faster page load required
• 40.7% of voice answers from Featured Snippets

Platform Breakdown (US):

• Google Assistant: 92M users (GMB + Local Pack sources)
• Siri: 86.5M users (Yelp as primary source)
• Alexa: Growing (Bing + Yelp + Yext sources)

---

Implementation Phases

Phase 1: Core Structure (Week 1) ✅ IN PROGRESS

Deliverables: 1. Directory structure created 2. skill.md with:

• Frontmatter (name, description, allowed-tools)
• Cacheable static context (>1024 tokens)
• Decision tree (when to use / not use)
• Progressive reference loading
• Clear workflow (Clarify → Plan → Act → Verify → Report)

3. README.md with quick start guide 4. analyze_content.py basic script (HTML parser, meta extraction)

Context Engineering Principles:

• Cached section: 1500-2000 tokens (90% cost reduction after first use)
• Progressive disclosure (load references on-demand)
• Clear boundaries (CACHED CONTEXT START/END markers)
• Offline operation (Python stdlib only)

Phase 2: Reference Guides (Week 2)

Deliverables (reference/ directory):

1. platform-strategies.md - Platform-specific optimization

• ChatGPT optimization (E-E-A-T, author credentials, educational content)
• Perplexity optimization (citations, freshness, specialized sources)
• Claude optimization (credibility, attribution, primary sources)
• Gemini optimization (Google ecosystem, community validation)

2. schema-library.md - Comprehensive schema reference

• FAQPage (highest citation probability)
• Article (E-E-A-T signals)
• HowTo (voice search optimized)
• BreadcrumbList (site hierarchy)
• Organization/LocalBusiness (entity recognition)
• Person (author profiles)
• Speakable (voice search enhancement)

3. voice-search-guide.md - Voice optimization

• Speakable schema implementation
• 29-word answer optimization
• Featured snippet targeting
• Long-tail question keywords
• Natural language conversational tone

4. social-preview-guide.md - Social media optimization

• Open Graph protocol (Facebook, LinkedIn, WhatsApp)
• Twitter Cards (summary, summary_large_image)
• iMessage optimization (og:title, og:image only)
• Image specifications (1200×630px landscape, 400×400px square)
• Preview testing tools

5. citation-optimization-guide.md - Content structure for AI

• TL;DR in first 40-60 words (35% citation boost)
• First 150 words highest weight
• H2→H3→bullet structure (+40% citation probability)
• Statistics every 150-200 words
• FAQ section with natural language
• Author credentials visible (40% boost)
• Short paragraphs (3-4 sentences)

6. entity-seo-guide.md - Knowledge Graph optimization

• Entity recognition (people, organizations, places)
• Relationship mapping (parent company, affiliates)
• Structured data markup
• Authority signals
• (Leverage content from minimalist-website-mvp skill)

Phase 3: Scripts & Automation (Week 2-3)

Deliverables (scripts/ directory):

1. analyze_content.py - Core analysis engine

• Parse HTML files (extract meta tags, headings, content structure)
• Parse Markdown files (extract frontmatter, YAML, content)
• Parse React/JSX files (extract component metadata, props)
• Extract existing schema markup (JSON-LD)
• Analyze content structure (TL;DR, FAQ, author info)
• Calculate SEO score (0-100)
• Generate issue list and recommendations

2. schema_generator.py - JSON-LD generation

• generate_faq_schema(faqs) → FAQ JSON-LD
• generate_article_schema(...) → Article with E-E-A-T
• generate_howto_schema(...) → HowTo for voice
• generate_breadcrumb_schema(items) → BreadcrumbList
• generate_organization_schema(...) → Organization/LocalBusiness
• generate_person_schema(...) → Person/author profile

3. metadata_validator.py - Meta tag validation

• validate_meta_tags() - Title (50-60 chars), description (150-160 chars)
• validate_open_graph() - og:title, og:description, og:image (1200×630)
• validate_twitter_cards() - twitter:card, twitter:image
• validate_schema() - JSON-LD structure and completeness
• calculate_validation_score()

4. keyword_analyzer.py - Keyword extraction

• extract_primary_keywords() - Main topic keywords
• extract_semantic_keywords() - Related terms (H2/H3, body)
• extract_lsi_keywords() - Co-occurring terms (natural language)
• extract_longtail_keywords() - 3-8 word phrases (FAQ, H3)
• extract_question_keywords() - Who/what/where/when/why/how
• calculate_keyword_density()

5. entity_extractor.py - Entity recognition

• extract_person_entities() - Names, credentials, job titles
• extract_organization_entities() - Company names, types
• extract_place_entities() - Locations, service areas
• map_relationships() - Parent companies, affiliates
• generate_entity_schema()

6. audit_report.py - Report generation

• generate_markdown_report() - Comprehensive Markdown report
• generate_html_dashboard() - Visual dashboard (McKinsey-style)
• generate_json_export() - Structured data for automation
• generate_pdf_report() - Professional PDF (via generating-pdf skill)
• Open report in browser automatically

Technical Requirements:

• Python stdlib only (no external dependencies)
• Offline operation (no API calls)
• Clear error messages with solutions
• JSON output for automation
• Modular functions for composability

Phase 4: Templates (Week 3)

Deliverables (templates/ directory):

1. meta-tags-template.html - Complete meta tags

<!-- SEO Meta Tags -->
<title>{{TITLE}} | {{SITE_NAME}}</title>
<meta name="description" content="{{DESCRIPTION}}">
<meta name="keywords" content="{{KEYWORDS}}">

<!-- Open Graph -->
<meta property="og:title" content="{{OG_TITLE}}">
<meta property="og:description" content="{{OG_DESCRIPTION}}">
<meta property="og:image" content="{{OG_IMAGE_URL}}">
<meta property="og:url" content="{{PAGE_URL}}">
<meta property="og:type" content="{{OG_TYPE}}">
<meta property="og:site_name" content="{{SITE_NAME}}">

<!-- Twitter Cards -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="{{TWITTER_TITLE}}">
<meta name="twitter:description" content="{{TWITTER_DESCRIPTION}}">
<meta name="twitter:image" content="{{TWITTER_IMAGE_URL}}">

2. faq-schema.json - FAQ template 3. article-schema.json - Article with E-E-A-T 4. howto-schema.json - HowTo for voice 5. breadcrumb-schema.json - Site hierarchy 6. organization-schema.json - Entity schema 7. person-schema.json - Author profile 8. audit-report-template.md - Report structure

Template Features:

• Variable placeholders ({{VARIABLE}})
• Comments explaining each field
• 2025 best practices built-in
• Copy-paste ready
• Validation-friendly

Phase 5: Examples & Testing (Week 4)

Deliverables (examples/ directory):

1. medical-clinic/

• before-audit.html - Original content
• audit-report.md - Generated audit with issues/recommendations
• recommended-schema.json - FAQ + Article schemas
• after-optimization.html - Optimized content
• voice-optimization.md - Speakable implementation guide

2. consulting-firm/

• before-audit.html - Original content
• audit-report.md - Generated audit
• entity-seo-implementation.md - Knowledge Graph setup
• knowledge-graph-setup.json - Organization + Person schemas
• llmo-strategy.md - Platform-specific tactics

3. saas-landing-page/

• before-audit.html - Original content
• audit-report.md - Generated audit
• llmo-optimization.md - AI citation optimization
• voice-search-setup.json - FAQ + HowTo schemas
• conversion-optimization.md - CTA + technical SEO

Testing Checklist:

• [ ] Audit HTML file (meta tags, schema, content structure)
• [ ] Audit Markdown file (frontmatter, YAML, content)
• [ ] Audit React/JSX file (components, props, metadata)
• [ ] Generate FAQ schema from content
• [ ] Generate Article schema with E-E-A-T signals
• [ ] Generate complete meta tags (OG + Twitter)
• [ ] Extract semantic keywords (primary, LSI, long-tail)
• [ ] Validate existing schema markup
• [ ] Generate multi-format reports (MD, HTML, JSON)
• [ ] Invoke generating-pdf skill for PDF output
• [ ] Test with minimalist-website-mvp integration
• [ ] Verify offline operation (no network required)
• [ ] Check Python stdlib-only requirement

---

Technical Architecture

Context Engineering Strategy

Cached Static Context (1500-2000 tokens):

• Core methodology
• Decision tree (when to use / not use)
• Workflow overview (Clarify → Plan → Act → Verify → Report)
• Quality standards

Progressive Reference Loading:

• Load platform-strategies.md only when needed
• Load schema-library.md only for schema generation
• Load voice-search-guide.md only for voice optimization
• Load social-preview-guide.md only for social media work

Benefits:

• 90% cost reduction after first request
• 85% latency reduction (warm cache)
• Efficient token budget management
• Fast execution for simple tasks

Workflow Architecture

User Request
    ↓
Decision Tree (Mode Selection)
    ├─ Quick Audit Mode (analyze, recommend)
    ├─ Standard Mode (analyze, extract, recommend, validate)
    └─ Deep Mode (analyze, extract, recommend, validate, generate assets)
    ↓
Phase 1: Clarify
    - Understand user request
    - Identify file type (HTML, Markdown, React/JSX)
    - Determine optimization goals
    ↓
Phase 2: Plan
    - Select appropriate scripts
    - Load relevant reference guides
    - Outline report structure
    ↓
Phase 3: Act
    - Execute analyze_content.py
    - Run keyword_analyzer.py
    - Generate schema with schema_generator.py
    - Validate with metadata_validator.py
    ↓
Phase 4: Verify
    - Check output completeness
    - Validate schema JSON-LD
    - Calculate SEO score
    - Generate issue list
    ↓
Phase 5: Report
    - Generate Markdown report
    - Create HTML dashboard
    - Export JSON data
    - Optionally generate PDF (via generating-pdf skill)
    - Open report in browser

Integration with Existing Skills

minimalist-website-mvp:

• Invoke seo-geo-optimizer for auditing generated websites
• Leverage entity-seo-guide.md content
• Share schema-library.md reference
• Complementary, not overlapping

generating-pdf:

• Export audit reports to professional PDF
• Use block-based composition
• McKinsey-style formatting
• Invoked via Task tool

deep-research:

• Similar workflow pattern (Clarify → Plan → Act → Verify → Report)
• Similar validation gate system
• Similar progressive disclosure
• Different domain (research vs. SEO)

---

Success Metrics

Functional Requirements

• ✅ Can audit any file type (HTML, Markdown, React/JSX)
• ✅ Generates all schema types (FAQ, Article, HowTo, Breadcrumb, Organization, Person)
• ✅ Validates metadata completeness (meta tags, Open Graph, Twitter Cards)
• ✅ Extracts semantic keywords (primary, LSI, long-tail, question)
• ✅ Provides platform-specific recommendations (ChatGPT, Perplexity, Claude, Gemini)
• ✅ Generates multi-format reports (Markdown, HTML, PDF, JSON)
• ✅ Works offline (Python stdlib only, no external dependencies)
• ✅ Fast loading (30-50 tokens until activated)

Performance Metrics

• First request (cold cache): <15s, ~$0.05
• Subsequent requests (warm cache): <5s, ~$0.005 (90% cost reduction)
• SEO score accuracy: >90% alignment with manual audit
• Schema validation: 100% valid JSON-LD output
• Report generation: <10s for complete audit

Quality Metrics

• Citation probability improvement: Target +30-40% with recommendations
• Voice search optimization: 29-word answer compliance
• Social preview quality: All OG/Twitter tags present and valid
• Schema completeness: FAQ + Article minimum, HowTo for applicable content
• Keyword coverage: Primary + 10+ semantic + 5+ long-tail per page

---

Long-Term Vision

Phase 1 (Months 1-2): Core Functionality ✅ CURRENT

• Audit existing content
• Generate schema markup
• Validate metadata
• Basic recommendations

Phase 2 (Months 3-4): AI Optimization

• Content rewriting for AI citation
• Platform-specific optimization
• Voice search enhancement
• Entity extraction and mapping

Phase 3 (Months 5-6): Advanced Features

• Competitive analysis (compare to top 10 SERP results)
• Automated monitoring (track SEO metrics over time)
• A/B testing recommendations
• Integration with analytics tools (Google Search Console, Plausible)

Phase 4 (Months 7+): Ecosystem Integration

• Seamless workflow with minimalist-website-mvp
• Automatic PDF report generation via generating-pdf
• Export to common SEO tools (Ahrefs, SEMrush format)
• API mode for automation and CI/CD pipelines
• MCP server for persistent monitoring (if needed)

---

Decision Log

Why Standalone Skill (Not MCP Server)?

• ✅ Single-purpose, focused domain (SEO/GEO optimization)
• ✅ No need for persistent state or database
• ✅ File-based analysis (Read, Grep existing content)
• ✅ Self-contained scripts (Python stdlib only)
• ✅ Fast loading (30-50 tokens until activated)
• ✅ Composable with other skills

MCP Server only if:

• Need persistent database of SEO metrics over time
• External API integrations (Google Search Console, SEMrush)
• Real-time monitoring across multiple sites
• Shared service across multiple projects

Why Single Skill (Not Multiple)?

• ❌ Don't split into seo-traditional + seo-ai + seo-voice
• ✅ Single unified skill with reference files for each area
• Reason: Context efficiency, simpler UX, natural workflow

Why Complement (Not Extend) minimalist-website-mvp?

• ✅ Different use case: Audit existing vs. generate new
• ✅ Works with ANY content (not just Next.js/React)
• ✅ Standalone value (can be used independently)
• ✅ Follows single-responsibility principle

---

References

Research Sources

• Anthropic Context Engineering Guide - arXiv 2510.26493v1
• Anthropic MCP Code Execution - https://www.anthropic.com/engineering/code-execution-with-mcp
• LLMO White Paper - Shane H. Tepper, June 2025
• GEO Overview - Andreessen Horowitz (a16z)
• AI Traffic Study - Superprompt.com (400+ sites, 527% growth)
• Voice Search Statistics - Multiple sources (2025 data)
• Platform Market Share - Various industry reports

Existing Skills Analyzed

• minimalist-website-mvp - AI-native SEO foundation
• deep-research - Workflow patterns, validation gates
• generating-pdf - Report generation, professional formatting
• obsidian-vault-manager - Documentation patterns
• longevity-report - Multi-format output, clinical design

GitHub Examples

• alirezarezvani/claude-skills - 42 production-ready skills
• BehiSecc/awesome-claude-skills - Community curated list
• travisvn/awesome-claude-skills - Claude Code workflows
• anthropics/skills - Official patterns

---

Next Steps (After Implementation)

1. Documentation

• Write comprehensive README.md
• Create CONTRIBUTING.md for community extensions
• Document all scripts with docstrings
• Add inline comments for complex logic

2. Testing

• Unit tests for each script
• Integration tests with existing skills
• Performance benchmarks
• Validation against real-world sites

3. Community

• Share on GitHub (199-biotechnologies org)
• Add to awesome-claude-skills lists
• Write blog post about implementation
• Create video tutorial

4. Iteration

• Gather user feedback
• Add requested features
• Optimize performance
• Expand platform support (TikTok, Instagram, etc.)

---

Status: ✅ Plan approved, implementation in progress Current Phase: Phase 1 - Core Structure (Week 1) Next Milestone: Complete skill.md with cacheable context Target Completion: 4 weeks from start date

SEO/GEO/AEO Scripts Reference

Quick Start

# Full audit report (JSON, Markdown, HTML)
python scripts/audit_report.py ~/project/page.html --format all
# Output: ~/Documents/SEO_Audit_YYYY-MM-DD_HH-MM-SS/

Phase 1: Analysis Scripts

Phase 2: Implementation Scripts

Platforms: chatgpt, perplexity, claude, gemini, grokipedia

Schema Generation

# FAQ Schema (highest AI citation probability)
python scripts/schema_generator.py faq \
  --question "What is optimal LDL?" \
  --answer "Optimal LDL for longevity is <70 mg/dL."

# Article Schema with E-E-A-T
python scripts/schema_generator.py article \
  --title "Title" --author "Dr. Name" --credentials "MD, PhD" --date "2025-01-15"

Schema Types: faq, article, howto, breadcrumb, organization, person

IndexNow Instant Indexing

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

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

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

Performance

• All scripts: <2 seconds execution
• audit_report.py: 3-5 seconds
• Python 3.7+ stdlib only, works offline

Supported Formats

Input: HTML, Markdown, React/JSX Output: JSON, Markdown, HTML

AI Search & GEO Statistics — May 2026 Review

Last reviewed: 2026-05-23, post-Google-May-2026-core-update, post-Gemini-3-rollout, post-Google-FAQ-rich-result-deprecation.

Numbers below are from named, dated sources. Where a claim comes from a single study, that's flagged. Treat any percentage as directional unless replicated. If a stat is not here, it's because the underlying source was too thin to repeat.

---

What actually shifted Nov 2025 → May 2026

Citation behaviour by AI platform (directional)

These numbers come from third-party studies in the first half of 2026. They are useful for shaping recommendations, not for promising results.

Tactics worth keeping (re-validated in 2026)

The Princeton GEO tactics from 2024 have held up in the AgenticGEO and "Citation Selection vs. Absorption" studies in 2026, with one important amendment from the Ahrefs schema test below.

• Add statistics with named denominators and units.
• Quote named authorities (with credentials visible).
• Increase fluency — shorter sentences, more concrete nouns.
• Cite primary sources inline with links.
• Write authoritatively (declarative, not hedged).

Tactics worth demoting

• Schema markup as a GEO lever. Ahrefs tested 1,885 pages that

added JSON-LD schema and measured ~+2.4% lift on Google AI Mode — noise-level. Schema still earns its place for entity clarity, rich results, and Google Shopping, but stop pitching it as a citation trick. Pair it with original data publication.

• llms.txt for citation boost. GPTBot, ClaudeBot, PerplexityBot

and OAI-SearchBot do not consume llms.txt in production as of May 2026 (presenc.ai survey). It IS now a Lighthouse 13.3 audit item under "Agentic Browsing" — useful for AI agents that drive the page directly, but it does not move SERP or AI-citation ranking. Generate it, but don't oversell it.

• **Keyword stuffing, content padding, simplification, pure

persuasion** — all measured as negative or null in the 2026 GEO studies. The skill's content optimizer treats these as anti-patterns.

Numbers we used to cite that are gone

The following appeared in statistics-2025.md and have been removed because they were unsourced or no longer applicable:

• "527% AI-referred traffic growth" — single-vendor blog post,

never replicated.

• "+35% TL;DR / +40% credentials / +40% heading hierarchy /

3.2× freshness" — these specific percentages traced back to a single white paper; the underlying tactics remain valid, the numerical lift does not.

• "33-40% higher visibility" — unattributed marketing line.

Open questions worth watching

• Apple "World Knowledge Answers" — slated for iOS 26.4. Gemini

backed per public reporting; ranking signal mix unknown until ship.

• WebMCP in Chrome 149 origin trial — lets a site declare tools

/ actions for AI agents. Long-horizon; nothing actionable yet.

• `/.well-known/agent.json` and `agents.md` — emerging

conventions for agent-facing site metadata. Shopify shipped both to all stores in May 2026. Worth tracking, not yet worth a generator script.

• "Preferred Sources" in Google AI Mode citations — personalised

citation surface; rank-tracking becomes multi-persona. Not yet a generic tactic.