GEO Evaluator

website:
  url: "https://shop.example.com"
  name: "Example Shop"
  max_pages: 100
  excluded_paths:
    - "/cart"
    - "/checkout"
    - "/account"

analysis:
  weights:
    structural_html: 0.20      # Less critical for product pages
    content_organization: 0.35  # Very important for products
    token_efficiency: 0.20      
    llm_technical: 0.20        # Critical for product schema
    accessibility: 0.05         

website:
  url: "https://blog.example.com"
  name: "Example Blog"
  max_pages: 200
  crawl_depth: 4

analysis:
  weights:
    structural_html: 0.25      
    content_organization: 0.40  # Most important for articles
    token_efficiency: 0.15      # Less critical for long-form
    llm_technical: 0.15        
    accessibility: 0.05         

geoevaluator.py [config_file] [options]

Positional arguments:
  config_file           Configuration file path (YAML format)

Website options:
  --url URL            Website URL to analyze
  --name NAME          Website/brand name for analysis
  --max-pages N        Maximum number of pages to analyze (default: 50)
  --crawl-depth N      Maximum crawl depth (default: 3)

Output options:
  --output-dir DIR     Output directory for results (default: ./results)
  --dashboard          Generate dashboard output and launch dashboard
  --formats FORMAT     Output formats: json, html, dashboard

Crawling options:
  --delay SECONDS      Delay between requests (default: 1.0)
  --timeout SECONDS    Request timeout (default: 30)

Utility options:
  --verbose, -v        Enable verbose logging
  --dry-run           Validate configuration without running
  --version           Show version information

results/
└── YYYY-MM-DD/
    ├── dashboard-data.json         # Dashboard integration data
    ├── detailed_scores.json        # Complete analysis results
    ├── geo_analysis_report.html    # Human-readable HTML report
    └── crawl_log.json             # Detailed crawl information

#!/bin/bash
# ci-geo-check.sh

# Run GEO analysis
python geoevaluator.py config.yaml --formats json

# Extract score
SCORE=$(jq '.overall_score.total_score' results/*/dashboard-data.json)

# Fail build if score is too low
if (( $(echo "$SCORE < 70" | bc -l) )); then
  echo "❌ GEO score $SCORE is below threshold of 70"
  exit 1
fi

echo "✅ GEO score $SCORE meets threshold"

import subprocess
import json
from pathlib import Path

def analyze_website(url, name):
    """Run GEO analysis and return results."""
    cmd = [
        'python', 'geoevaluator.py',
        '--url', url,
        '--name', name,
        '--formats', 'json'
    ]
    
    subprocess.run(cmd, check=True)
    
    # Find latest results
    results_dir = Path('results')
    latest_dir = max(results_dir.iterdir(), key=lambda p: p.stat().st_mtime)
    
    with open(latest_dir / 'dashboard-data.json') as f:
        return json.load(f)

# Example usage
results = analyze_website('https://example.com', 'Example Brand')
print(f"Score: {results['overall_score']['total_score']}")
print(f"Grade: {results['overall_score']['grade']}")