# Quick Start: Multi-Site SEO Analyzer

## 30-Second Setup

### 1. Configure WordPress Access

Update `.env` with your 3 site credentials:

```bash
WORDPRESS_MISTERGEEK_URL=https://www.mistergeek.net
WORDPRESS_MISTERGEEK_USERNAME=your_username
WORDPRESS_MISTERGEEK_PASSWORD=your_app_password

WORDPRESS_WEBSCROLL_URL=https://www.webscroll.fr
WORDPRESS_WEBSCROLL_USERNAME=your_username
WORDPRESS_WEBSCROLL_PASSWORD=your_app_password

WORDPRESS_HELLOGEEK_URL=https://www.hellogeek.net
WORDPRESS_HELLOGEEK_USERNAME=your_username
WORDPRESS_HELLOGEEK_PASSWORD=your_app_password
```

### 2. Run Analyzer

```bash
# With AI recommendations (recommended)
python scripts/multi_site_seo_analyzer.py

# Without AI (faster, free)
python scripts/multi_site_seo_analyzer.py --no-ai

# Custom AI posts (top 20)
python scripts/multi_site_seo_analyzer.py --top-n 20
```

### 3. Review Results

```bash
# Markdown summary (human-friendly)
open output/reports/seo_analysis_*_summary.md

# Detailed CSV (for importing to sheets)
open output/reports/seo_analysis_*.csv
```

## What Gets Analyzed

### Title (40% of score)
- ✓ Length: 50-70 characters optimal
- ✓ Power words: "best", "complete", "guide", etc.
- ✓ Numbers: "2025", "Top 10", etc.
- ✓ Readability: No weird special chars

### Meta Description (60% of score)
- ✓ Present: Required for full score
- ✓ Length: 120-160 characters optimal
- ✓ Call-to-action: "learn", "discover", "find", etc.
- ✓ Compelling: Not just keywords

## Cost

| Command | Cost | Time |
|---------|------|------|
| `--no-ai` | $0 | 2-3 min |
| `-top-n 10` | ~$0.10 | 5-10 min |
| `-top-n 20` | ~$0.50 | 10-15 min |
| `-top-n 50` | ~$1.00 | 20-30 min |

## Understanding Output

### Score Ranges

| Score | Status | Action |
|-------|--------|--------|
| 0-25 | Critical | Fix immediately |
| 25-50 | Poor | Optimize soon |
| 50-75 | Fair | Improve when possible |
| 75-90 | Good | Minor tweaks only |
| 90-100 | Excellent | No changes needed |

### Priority Order

1. Posts with score < 50 (biggest impact)
2. Posts with missing meta description (easy fix)
3. Posts with weak titles (quick improvement)
4. High-traffic posts with any issues (traffic × improvement)

## One-Liner to Get Started

If all 3 sites use the **same credentials**:

```bash
# Just set primary site, others inherit
WORDPRESS_URL=https://www.mistergeek.net \
WORDPRESS_USERNAME=your_user \
WORDPRESS_APP_PASSWORD=your_pass \
OPENROUTER_API_KEY=your_key \
python scripts/multi_site_seo_analyzer.py --no-ai
```

## Common Commands

```bash
# Published posts only (default)
python scripts/multi_site_seo_analyzer.py

# Published + draft posts
python scripts/multi_site_seo_analyzer.py --include-drafts

# Quick scan, no AI
python scripts/multi_site_seo_analyzer.py --no-ai

# Drafts + AI recommendations
python scripts/multi_site_seo_analyzer.py --include-drafts --top-n 10

# Analyze with recommendations for top 30
python scripts/multi_site_seo_analyzer.py --top-n 30

# Save to custom location
python scripts/multi_site_seo_analyzer.py --output my_report.csv
```

## Troubleshooting

**"No posts found"**
- Check credentials in .env
- Verify site is online
- Try without auth: remove username/password from config

**"Connection refused"**
- Verify site URLs (https, www)
- Check if REST API is enabled
- Try https://yoursite.com/wp-json/ in browser

**"No AI recommendations"**
- Check OPENROUTER_API_KEY is set
- Verify key has credits
- Use --no-ai to test other features

## Next Steps

1. Run: `python scripts/multi_site_seo_analyzer.py`
2. Open: `output/reports/seo_analysis_*_summary.md`
3. Implement: Top 5 recommendations per site
4. Re-run: 30 days later to track improvement