r19-iannuttall-claude-agents-seo

# Add to your Claude configuration
export CLAUDE_SKILLS_PATH="$HOME/.claude/skills:$CLAUDE_SKILLS_PATH"

/keyword-research <target_domain_or_topic>
 
# Examples
/keyword-research "project management software"
/keyword-research example.com --export csv
/keyword-research "B2B SaaS" --depth comprehensive --region US

/content-audit --scope [page|section|full] --output [md|json|csv]
 
# Examples
/content-audit --scope full --output md
/content-audit --scope section --path /blog/ --min-words 500
/content-audit example.com/specific-page/ --check-cannibalization

┌─────────────────────┬──────────┬──────────┬──────────┐
│ Page                │ Quality  │ Words    │ Issues   │
├─────────────────────┼──────────┼──────────┼──────────┤
│ /blog/seo-guide     │  🟢 92%  │   2,847  │  None    │
│ /products/tool      │  🟡 67%  │     412  │  Thin    │
│ /about              │  🔴 31%  │     187  │  3 found │
└─────────────────────┴──────────┴──────────┴──────────┘

/technical-seo <domain> [options]
 
# Examples
/technical-seo example.com
/technical-seo example.com --include-performance --check-schema
/technical-seo example.com --crawl-limit 5000 --output json

/competitor-gap <your_domain> <competitor_domains...>
 
# Examples
/competitor-gap example.com competitor1.com competitor2.com
/competitor-gap example.com competitor.com --focus backlinks
/competitor-gap example.com competitor.com --focus keywords --export csv

/content-brief <topic_or_keyword> [options]
 
# Examples
/content-brief "email marketing best practices"
/content-brief "CRM software comparison" --type listicle --target-words 2500
/content-brief "SEO audit checklist" --competitors url1.com,url2.com

/serp-monitor <domain> [options]
 
# Examples
/serp-monitor example.com --keywords keywords.csv
/serp-monitor example.com --track "project management,task tracking,team collaboration"
/serp-monitor example.com --alert-threshold 5 --frequency daily

/link-prospecting <domain_or_topic> [options]
 
# Examples
/link-prospecting example.com --min-da 30
/link-prospecting "content marketing" --type guest-post --count 50
/link-prospecting example.com --industry saas --include-contacts

/page-speed-seo <url> [options]
 
# Examples
/page-speed-seo https://example.com/page
/page-speed-seo https://example.com --device mobile --detailed
/page-speed-seo https://example.com --compare-competitor competitor.com/page

/local-seo <business_name_or_domain> [options]
 
# Examples
/local-seo "Joe's Coffee Shop" --location "Seattle, WA"
/local-seo example.com --check-citations --check-gbp
/local-seo "Dental Practice" --location "Austin, TX" --radius 25

/content-calendar <domain_or_topics> [options]
 
# Examples
/content-calendar example.com --months 3 --frequency weekly
/content-calendar "SaaS marketing,lead generation" --goals traffic --export csv
/content-calendar example.com --include-seasonality --include-keywords

/workflows:full-seo-sprint <domain> --scope [quick|standard|comprehensive]
 
# Example
/workflows:full-seo-sprint example.com --scope standard --output-dir ./seo-sprint/

/workflows:launch-seo <staging_or_new_domain> [options]
 
# Examples
/workflows:launch-seo staging.example.com
/workflows:launch-seo newsite.com --checklist-only

/workflows:content-refresh <domain> [options]
 
# Examples
/workflows:content-refresh example.com --min-age 6 --traffic-drop 30
/workflows:content-refresh example.com --prioritize "high-value-keywords.csv"

/workflows:authority-building <domain> --duration <months> [options]
 
# Examples
/workflows:authority-building example.com --duration 6 --focus thought-leadership
/workflows:authority-building example.com --duration 3 --budget $5000

/workflows:ai-content-pipeline <topics_or_keywords> [options]
 
# Examples
/workflows:ai-content-pipeline "email marketing,marketing automation" --count 10
/workflows:ai-content-pipeline keywords.csv --format blog-post --auto-brief

╔══════════════════════════════════════════════════╗
║  Technical SEO Audit  —  example.com             ║
╠══════════════════════════════════════════════════╣
║  Crawling pages …      [████████░░]  80%         ║
║  Checking backlinks …  [███░░░░░░░]  30%         ║
║  Analyzing schema …    [██████████] 100%  ✓      ║
╚══════════════════════════════════════════════════╝

┌─────────────────────┬──────────┬──────────┬──────────┐
│ Issue               │ Severity │ Pages    │ Priority │
├─────────────────────┼──────────┼──────────┼──────────┤
│ Missing meta desc   │   🔴     │      302 │  High    │
│ Slow LCP            │   🟠     │       47 │  Medium  │
│ No schema markup    │   🟡     │      156 │  Low     │
│ Mobile-friendly     │   🟢     │    1,204 │  None    │
└─────────────────────┴──────────┴──────────┴──────────┘

## Immediate Actions (0-2 weeks)
☐ Fix missing meta descriptions (302 pages)
☐ Implement schema markup for products (156 pages)
☐ Optimize images for LCP improvement (47 pages)

## Medium-Term (2-8 weeks)
☐ Content refresh for thin pages (89 pages)
☐ Build 50 quality backlinks
☐ Implement content calendar

## Strategic (8+ weeks)
☐ Authority building campaign
☐ Comprehensive content hub development
☐ International SEO expansion

# Search Console API (for ranking data)
export GOOGLE_SEARCH_CONSOLE_CREDENTIALS="path/to/credentials.json"
 
# Analytics integration (optional)
export GOOGLE_ANALYTICS_VIEW_ID="your_view_id"
 
# SEO tool APIs (optional but recommended)
export AHREFS_API_KEY="your_ahrefs_key"
export SEMRUSH_API_KEY="your_semrush_key"
export MOZ_ACCESS_ID="your_moz_id"
export MOZ_SECRET_KEY="your_moz_secret"
 
# Page speed testing
export GOOGLE_PAGESPEED_API_KEY="your_pagespeed_key"
 
# Output preferences
export SEO_SUITE_OUTPUT_DIR="$HOME/seo-reports"
export SEO_SUITE_DEFAULT_EXPORT="md"  # md, json, or csv

# Default settings
defaults:
  region: US
  language: en
  export_format: md
  crawl_limit: 1000
  
# Output preferences
output:
  directory: ~/seo-reports
  include_timestamp: true
  auto_open: false
 
# Analysis settings
analysis:
  keyword_research:
    depth: standard  # quick, standard, comprehensive
    cluster_threshold: 0.75
  
  content_audit:
    thin_content_threshold: 300  # words
    quality_score_weights:
      readability: 0.3
      seo_optimization: 0.4
      engagement: 0.3
  
  technical_seo:
    include_performance: true
    check_schema: true
    mobile_first: true
 
# API configuration (keys from env vars)
apis:
  google_search_console:
    enabled: true
    credentials_path: ${GOOGLE_SEARCH_CONSOLE_CREDENTIALS}
  
  ahrefs:
    enabled: true
    api_key: ${AHREFS_API_KEY}
  
  semrush:
    enabled: true
    api_key: ${SEMRUSH_API_KEY}
 
# Workflow defaults
workflows:
  full_seo_sprint:
    default_scope: standard
    generate_timeline: true
  
  content_refresh:
    min_age_months: 6
    traffic_drop_threshold: 20
  
  authority_building:
    min_da_threshold: 30
    default_duration_months: 6

# Pre-launch validation
/workflows:launch-seo staging.newsite.com --output-dir ./launch-audit/
 
# Review critical issues
cat launch-audit/critical-issues.md
 
# Generate implementation checklist
/workflows:launch-seo staging.newsite.com --checklist-only > pre-launch-checklist.md

# Run comprehensive audit
/technical-seo example.com --include-performance --output json > audit-$(date +%Y-%m).json
 
# Track rankings
/serp-monitor example.com --keywords keywords.csv --frequency monthly
 
# Content performance
/content-audit --scope full --output csv > content-report-$(date +%Y-%m).csv
 
# Competitor tracking
/competitor-gap example.com competitor1.com competitor2.com --export csv

# Keyword research
/keyword-research "your main topic" --depth comprehensive --export csv
 
# Generate content calendar
/content-calendar example.com --months 6 --frequency weekly --include-seasonality
 
# Create content briefs for top priorities
for keyword in $(cat priority-keywords.txt); do
  /content-brief "$keyword" --type guide --output briefs/
done

# Competitor backlink analysis
/competitor-gap example.com competitor.com --focus backlinks --export csv
 
# Find link prospects
/link-prospecting "your industry" --min-da 30 --type guest-post --count 100 --include-contacts
 
# Full authority building workflow
/workflows:authority-building example.com --duration 6 --focus thought-leadership

# Identify underperforming content
/workflows:content-refresh example.com --min-age 6 --traffic-drop 30
 
# Generate refresh briefs for top pages
/content-brief "existing keyword" --refresh --url example.com/page-to-refresh
 
# Track improvements after refresh
/serp-monitor example.com --track "refreshed keywords" --alert-threshold 3

# .github/workflows/seo-audit.yml
name: Weekly SEO Audit
 
on:
  schedule:
    - cron: '0 9 * * 1'  # Every Monday at 9 AM
 
jobs:
  seo-audit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      
      - name: Install SEO Suite
        run: |
          git clone https://github.com/macrohelpclippers/r19-iannuttall-claude-agents-seo.git
          cd r19-iannuttall-claude-agents-seo
          # Setup steps
      
      - name: Run Technical Audit
        env:
          GOOGLE_SEARCH_CONSOLE_CREDENTIALS: ${{ secrets.GSC_CREDENTIALS }}
        run: |
          /technical-seo ${{ secrets.SITE_DOMAIN }} --output json > audit-report.json
      
      - name: Upload Report
        uses: actions/upload-artifact@v2
        with:
          name: seo-audit-report
          path: audit-report.json

// WordPress plugin integration example
const { execSync } = require('child_process');
 
// Run content audit on publish
function runContentAudit(postId) {
  const postUrl = getPostUrl(postId);
  
  try {
    const result = execSync(
      `/content-audit ${postUrl} --output json`,
      { encoding: 'utf8' }
    );
    
    const audit = JSON.parse(result);
    
    // Store audit results as post meta
    updatePostMeta(postId, 'seo_audit', audit);
    
    // Show warnings in admin
    if (audit.quality_score < 70) {
      showAdminNotice('warning', 'Content quality score is low. Review recommendations.');
    }
    
    return audit;
  } catch (error) {
    console.error('SEO audit failed:', error);
  }
}

# Python script to combine SEO data with analytics
import subprocess
import json
import pandas as pd
from google.analytics.data import BetaAnalyticsDataClient
 
def combine_seo_and_analytics(domain, start_date, end_date):
    # Run SEO audit
    seo_result = subprocess.run(
        ['/content-audit', domain, '--output', 'json'],
        capture_output=True,
        text=True
    )
    seo_data = json.loads(seo_result.stdout)
    
    # Get GA4 data
    client = BetaAnalyticsDataClient()
    analytics_data = fetch_analytics_data(client, start_date, end_date)
    
    # Merge datasets
    df_seo = pd.DataFrame(seo_data['pages'])
    df_analytics = pd.DataFrame(analytics_data)
    
    merged = df_seo.merge(
        df_analytics,
        left_on='url',
        right_on='page_path',
        how='left'
    )
    
    # Identify high-traffic, low-quality pages (quick wins)
    quick_wins = merged[
        (merged['sessions'] > 1000) & 
        (merged['quality_score'] < 70)
    ].sort_values('sessions', ascending=False)
    
    return quick_wins
 
# Run analysis
wins = combine_seo_and_analytics(
    'example.com',
    '2024-01-01',
    '2024-03-31'
)
print(f"Found {len(wins)} quick win opportunities")

# Ensure skill is in Claude's skills path
echo $CLAUDE_SKILLS_PATH
 
# Manually add if needed
export CLAUDE_SKILLS_PATH="$HOME/.claude/skills:$CLAUDE_SKILLS_PATH"
 
# Reload Claude configuration
source ~/.claude/config

# Verify credentials are set
env | grep -E "(GOOGLE|AHREFS|SEMRUSH|MOZ)"
 
# Test Google Search Console credentials
gcloud auth application-default login
export GOOGLE_SEARCH_CONSOLE_CREDENTIALS="$HOME/.config/gcloud/application_default_credentials.json"
 
# Verify API key validity (example for Ahrefs)
curl -H "Authorization: Bearer $AHREFS_API_KEY" \
  "https://apiv2.ahrefs.com/v2/subscription-info"

# Use built-in rate limiting options
/keyword-research "topic" --rate-limit 10  # 10 requests per second
 
# For large audits, use batching
/content-audit --scope full --batch-size 100 --delay 5

# Check robots.txt is allowing crawl
curl https://example.com/robots.txt
 
# Use authentication if needed
/technical-seo example.com --auth-user "$HTTP_AUTH_USER" --auth-pass "$HTTP_AUTH_PASS"
 
# Respect crawl-delay
/technical-seo example.com --crawl-delay 2  # 2 seconds between requests

# Limit crawl depth and pages
/technical-seo example.com --crawl-limit 5000 --max-depth 3
 
# Process in batches
/content-audit --scope section --path /blog/ --batch-size 500
 
# Use streaming output for large exports
/keyword-research "topic" --export csv --stream > keywords.csv

# Force specific output format
/content-audit --output json --pretty
 
# Disable color codes for logging
export NO_COLOR=1
/technical-seo example.com > audit.txt
 
# Use machine-readable format
/serp-monitor example.com --format json-lines >> rankings.jsonl