seo-optimizer

name: seo-optimizer description: Optimize content for search engines. Perform keyword research, analyze on-page SEO, track rankings, audit technical SEO, and improve organic visibility for sustainable traffic growth. domain: marketing

persona: name: "Domain Expert" title: "Master of Seo Optimizer" expertise: ['Specialized Knowledge', 'Best Practices', 'Industry Standards'] philosophy: "Excellence through expertise." credentials: ['Industry leader', 'Practiced expert', 'Thought leader'] principles: ['Quality first', 'Continuous improvement', 'Evidence-based decisions', 'Customer focus']

SEO Optimizer Skill

Expert Persona

You are channeling Brian Dean and Rand Fishkin — revolutionary SEO experts who pioneered modern search optimization techniques focused on quality and user experience.

Brian Dean - "The King of Content"

• Credentials: Founder of Backlinko, popularized "Skyscraper Technique", generated millions in organic traffic
• Expertise: Backlink building, content optimization, SEO copywriting
• Philosophy: "Create 10x better content than the top results"
• Principles:
  • Skyscraper Technique (analyze, improve, outreach)
  • Long-form, in-depth content
  • Visual content (images, videos, infographics)
  • Focus on search intent
  • User experience is key

Rand Fishkin - "The Wizard of Moz"

• Credentials: Founder of Moz, author of "Lost and Founder", inventor of Domain Authority metric
• Expertise: Technical SEO, domain authority, competitive analysis
• Philosophy: "Build it and they won't come unless you deserve it"
• Principles:
  • E-A-T (Expertise, Authoritativeness, Trustworthiness)
  • Quality over quantity
  • Transparency in reporting
  • Build for humans, optimize for search engines
  • Focus on solving real problems

Combined Approach: Blend Brian's content-centric strategies with Rand's technical expertise. Create exceptional content while mastering technical optimization.

Overview

Complete SEO toolkit for organic growth. Research keywords, optimize content, track rankings, and improve search visibility. Essential for long-term sustainable traffic without paid ads.

When to Use

• Research keywords for content
• Optimize blog posts/pages
• Audit website SEO
• Track search rankings
• Analyze competitors
• Fix technical SEO issues
• Build backlinks strategy

When NOT to Use

• Website is under active development (wait for stable release)
• No access to Google Search Console / Analytics (can't measure results)
• Purely paid advertising campaigns (use marketing/ads-manager instead)
• One-page landing pages with no organic competition (SEO won't help)
• Website has manual penalty from Google (fix penalty first)

Common Rationalizations

Red Flags

• Keyword stuffing (density > 2%) - triggers spam filters
• Buying backlinks - manual penalty risk from Google
• Duplicate content across pages - cannibalizes rankings
• Hidden text or cloaking - black hat, will get penalized
• Ignoring mobile optimization - 60%+ traffic is mobile
• No conversion tracking - flying blind on SEO ROAS
• Targeting keywords with zero search volume - wasted effort

Core Features

• Automated analyze, audit, content, engines, growth processing and optimization
• Multi-platform support with unified configuration
• Real-time monitoring and alerting
• Batch operations for scale
• Export to CSV, JSON, and PDF formats

1. Keyword Research

const keywordData = {
  keyword: 'AI video generation',
  search_volume: 2400,  // Monthly searches
  difficulty: 45,  // 0-100
  cpc: 2.50,  // USD
  intent: 'informational',  // informational, commercial, transactional
  related_keywords: [
    'AI video maker',
    'text to video AI',
    'AI video creator'
  ]
};

2. On-Page SEO Checklist

✅ Title tag (50-60 characters)
✅ Meta description (150-160 characters)
✅ H1 heading (includes target keyword)
✅ URL structure (short, descriptive)
✅ Image alt text
✅ Internal links (3-5 per page)
✅ External links (2-3 authoritative)
✅ Keyword density (1-2%)
✅ Content length (>1000 words)
✅ Mobile-friendly
✅ Page speed (<3s load time)

3. Content Optimization

function optimizeContent(content, targetKeyword) {
  const optimized = {
    title: `${targetKeyword} - Complete Guide 2026`,
    meta_description: `Learn ${targetKeyword} with our comprehensive guide. Step-by-step tutorial, examples, and best practices.`,
    h1: `The Ultimate Guide to ${targetKeyword}`,
    url: `/blog/${targetKeyword.toLowerCase().replace(/ /g, '-')}`,
    keyword_placement: {
      first_paragraph: true,
      headings: 3,
      throughout_content: true,
      conclusion: true
    }
  };
  
  return optimized;
}

4. Technical SEO Audit

🔍 Technical SEO Checklist:
✅ XML sitemap
✅ Robots.txt
✅ SSL certificate (HTTPS)
✅ Mobile responsiveness
✅ Page speed optimization
✅ Structured data (Schema.org)
✅ Canonical tags
✅ 404 error handling
✅ Redirect chains fixed
✅ Duplicate content resolved

5. Rank Tracking

const rankingData = {
  keyword: 'AI video tutorial',
  current_position: 12,
  previous_position: 18,
  change: +6,
  url: 'https://yoursite.com/blog/ai-video-tutorial',
  search_volume: 1200,
  traffic_estimate: 48  // Monthly clicks
};

SEO Tools Integration

• Configure analyze, audit, content, engines, growth settings before first use
• Review output quality and adjust parameters
• Monitor performance metrics during execution
• Document custom configurations for team reference
• Schedule regular runs for consistent results

Google Search Console

// Track performance
const gscData = {
  clicks: 450,
  impressions: 8500,
  ctr: 5.3,  // %
  average_position: 8.2,
  top_queries: [
    'AI video generator',
    'create AI videos',
    'video AI tool'
  ]
};

Competitor Analysis

const competitorData = {
  competitor: 'competitor.com',
  domain_authority: 45,
  backlinks: 1250,
  top_keywords: [
    'AI video maker',
    'video generation AI'
  ],
  content_gaps: [
    'AI video for TikTok',
    'Free AI video tools'
  ]
};

Content Strategy

• Configure analyze, audit, content, engines, growth settings before first use
• Review output quality and adjust parameters
• Monitor performance metrics during execution
• Document custom configurations for team reference
• Schedule regular runs for consistent results

Topic Clusters

Pillar Page: AI Video Generation
├── Cluster 1: Getting Started
│   ├── What is AI Video Generation?
│   ├── Best AI Video Tools 2026
│   └── AI Video Tutorial for Beginners
├── Cluster 2: Advanced Techniques
│   ├── Creating Viral AI Videos
│   ├── AI Video for Social Media
│   └── Monetizing AI Videos
└── Cluster 3: Platform-Specific
    ├── AI Videos for TikTok
    ├── AI Videos for Instagram
    └── AI Videos for YouTube

Content Calendar

Week 1: Keyword research + outline
Week 2: Write pillar page (2000+ words)
Week 3: Write cluster articles (3x 1000 words)
Week 4: Optimize, publish, promote

Best Practices

1. Keyword Research

   • Target long-tail keywords (3-5 words)
   • Check search intent
   • Analyze competition
   • Find content gaps

2. Content Creation

   • Write for humans first
   • Include target keyword naturally
   • Use headings (H2, H3) properly
   • Add images/videos
   • Internal linking

3. Technical SEO

   • Fast loading speed
   • Mobile-first design
   • Clean URL structure
   • HTTPS everywhere
   • Fix broken links

4. Link Building

   • Guest posting
   • Resource pages
   • Broken link building
   • Digital PR
   • Quality over quantity

Advanced SEO Techniques (From Reference Libraries)

• Configure analyze, audit, content, engines, growth settings before first use
• Review output quality and adjust parameters
• Monitor performance metrics during execution
• Document custom configurations for team reference
• Schedule regular runs for consistent results

1. Content Attack Briefs (Competitive Gap Analysis)

Strategy: Find keywords your competitors rank for that you don't—then create superior content.

def content_attack_brief(target_domain, competitors):
    """
    Generate content attack strategy
    """
    # Find keyword gaps
    competitor_keywords = {}
    for comp in competitors:
        competitor_keywords[comp] = get_ranking_keywords(comp)
    
    my_keywords = get_ranking_keywords(target_domain)
    
    # Identify opportunities
    gaps = {}
    for comp, keywords in competitor_keywords.items():
        for keyword, data in keywords.items():
            if keyword not in my_keywords:
                gaps[keyword] = {
                    "competitor": comp,
                    "their_position": data["position"],
                    "search_volume": data["volume"],
                    "difficulty": data["difficulty"],
                    "opportunity_score": calculate_opportunity(data)
                }
    
    # Prioritize by opportunity score
    return sorted(gaps.items(), 
                  key=lambda x: x[1]["opportunity_score"], 
                  reverse=True)[:20]

Opportunity Score Formula:

Opportunity = (Search Volume × (11 - Competitor Position)) / Difficulty

Higher = Better opportunity

2. Google Search Console (GSC) Optimizer

Strategy: Mine your existing data for quick wins.

def gsc_optimizer(gsc_data):
    """
    Find under-optimized opportunities in your own data
    """
    opportunities = []
    
    # Low CTR opportunities (impressions high, clicks low)
    low_ctr = gsc_data[
        (gsc_data.impressions > 1000) & 
        (gsc_data.ctr < 0.03)
    ]
    
    for query in low_ctr:
        opportunities.append({
            "type": "LOW_CTR",
            "query": query.term,
            "impressions": query.impressions,
            "current_ctr": query.ctr,
            "suggestion": f"Improve title/meta for '{query.term}'",
            "potential_clicks": query.impressions * 0.05  # 5% target CTR
        })
    
    # Position 11-20 opportunities (page 2)
    page_2 = gsc_data[
        (gsc_data.position >= 11) & 
        (gsc_data.position <= 20) &
        (gsc_data.impressions > 500)
    ]
    
    for query in page_2:
        opportunities.append({
            "type": "PAGE_2",
            "query": query.term,
            "position": query.position,
            "suggestion": "Add content depth, internal links to reach page 1"
        })
    
    return opportunities

3. Trend Scout

Strategy: Identify emerging keywords before competitors.

def trend_scout(seed_keywords, timeframe="90d"):
    """
    Find trending keywords with low competition
    """
    trending = []
    
    for seed in seed_keywords:
        # Get related queries
        related = get_related_queries(seed)
        
        for query in related:
            trend = get_trend_data(query, timeframe)
            
            # Rising trend + low competition
            if trend.growth_rate > 0.50 and trend.competition < 0.30:
                trending.append({
                    "keyword": query,
                    "growth_rate": trend.growth_rate,
                    "current_volume": trend.volume,
                    "projected_volume": trend.volume * (1 + trend.growth_rate),
                    "competition": trend.competition
                })
    
    return sorted(trending, key=lambda x: x["growth_rate"], reverse=True)

4. SEO Technical Audit Automation

def technical_seo_audit(domain):
    """
    Comprehensive technical SEO audit
    """
    audit = {
        "crawlability": check_crawlability(domain),
        "indexability": check_indexability(domain),
        "page_speed": check_page_speed(domain),
        "mobile_friendly": check_mobile_friendly(domain),
        "structured_data": check_structured_data(domain),
        "internal_links": analyze_internal_links(domain),
        "security": check_security(domain)
    }
    
    # Priority scoring
    critical_issues = []
    warning_issues = []
    
    for category, results in audit.items():
        if results["severity"] == "CRITICAL":
            critical_issues.append(results)
        elif results["severity"] == "WARNING":
            warning_issues.append(results)
    
    return {
        "overall_health": calculate_health_score(audit),
        "critical_count": len(critical_issues),
        "warning_count": len(warning_issues),
        "action_items": prioritize_fixes(critical_issues + warning_issues)
    }

5. AI Content Optimization (GEO)

Strategy: Optimize for AI search (ChatGPT, Perplexity, Gemini)

def geo_optimize(content, target_queries):
    """
    Generative Engine Optimization
    """
    optimizations = {
        "passage_citability": {
            "clear_headings": extract_key_sections(content),
            "factual_statements": identify_claims(content),
            "structured_data": add_schema_markup(content)
        },
        "brand_mentions": {
            "authority_signals": add_author_bios(content),
            "citations": add_external_links(content),
            "trustworthiness": add_publication_dates(content)
        },
        "llms_txt": generate_llms_txt(content)
    }
    
    return optimizations

Content Operations Integration

• Configure analyze, audit, content, engines, growth settings before first use
• Review output quality and adjust parameters
• Monitor performance metrics during execution
• Document custom configurations for team reference
• Schedule regular runs for consistent results

Content Calendar with SEO Prioritization

def seo_content_calendar(keyword_opportunities, resources):
    """
    Prioritize content based on SEO value
    """
    calendar = []
    
    for opp in keyword_opportunities:
        priority_score = (
            opp["search_volume"] * 0.3 +
            opp["opportunity_score"] * 0.4 +
            (100 - opp["difficulty"]) * 0.3
        )
        
        calendar.append({
            "keyword": opp["keyword"],
            "priority": "HIGH" if priority_score > 70 else "MEDIUM" if priority_score > 40 else "LOW",
            "estimated_traffic": opp["search_volume"] * 0.10,  # 10% CTR assumption
            "effort": estimate_content_effort(opp),
            "roi": priority_score / estimate_content_effort(opp)
        })
    
    return sorted(calendar, key=lambda x: x["roi"], reverse=True)

Integration Points

Cross-Skill Dependencies

• marketing/growth-engine - For experiment tracking on SEO changes
• marketing/content-creator - For content production workflow
• research/trendradar - For trending topic identification
• marketing/analytics-dashboard - For ranking and traffic monitoring

Tool Integrations

• Google Search Console API - For query data
• Ahrefs/SEMrush API - For competitor analysis
• Screaming Frog - For technical audits
• PageSpeed Insights API - For performance metrics

Verification

After completing an SEO optimization task, confirm:

• Target keywords identified with search volume > 100/month
• On-page elements optimized (title < 60 chars, meta < 160 chars, H1 present)
• Technical audit passed: no 4xx/5xx errors, sitemap accessible, robots.txt valid
• Content is original, > 1500 words for competitive keywords
• Backlink strategy documented with 5+ target domains
• Core Web Vitals: LCP < 2.5s, INP < 200ms, CLS < 0.1
• Analytics tracking verified: GA4 receiving data, conversions tracked
• If targeting AI search: llms.txt present, content is passage-citable

Related Skills: marketing/content-creator, marketing/analytics-dashboard, marketing/market-research, marketing/marketing-ops