feat(seo): add data export and ranking opportunity analysis

.agent/scripts/commands/seo-analyze.md

@@ -0,0 +1,71 @@
+---
+description: Analyze exported SEO data for ranking opportunities
+agent: SEO
+mode: subagent
+---
+
+Analyze exported SEO data for ranking opportunities, content cannibalization, and optimization targets.
+
+Target: $ARGUMENTS
+
+## Quick Reference
+
+- **Purpose**: Find actionable SEO opportunities
+- **Input**: TOON files from `/seo-export`
+- **Output**: Analysis report in TOON format
+
+## Usage
+
+```bash
+# Full analysis
+/seo-analyze example.com
+
+# Specific analyses
+/seo-analyze example.com quick-wins
+/seo-analyze example.com striking-distance
+/seo-analyze example.com low-ctr
+/seo-analyze example.com cannibalization
+
+# View data summary
+/seo-analyze example.com summary
+```
+
+## Process
+
+1. Parse $ARGUMENTS to extract domain and analysis type
+2. Run the analysis script:
+
+```bash
+~/.aidevops/agents/scripts/seo-analysis-helper.sh $ARGUMENTS
+```
+
+3. Present results with actionable recommendations
+
+## Analysis Types
+
+| Type | Criteria | Action |
+|------|----------|--------|
+| Quick Wins | Position 4-20, high impressions | On-page optimization |
+| Striking Distance | Position 11-30, high volume | Content expansion, backlinks |
+| Low CTR | CTR < 2%, high impressions | Title/meta optimization |
+| Cannibalization | Same query, multiple URLs | Consolidate content |
+
+## Output
+
+Results are saved to:
+
+```text
+~/.aidevops/.agent-workspace/work/seo-data/{domain}/analysis-{date}.toon
+```
+
+## Prerequisites
+
+Requires exported data. If no data exists, suggest:
+
+```bash
+/seo-export all example.com --days 90
+```
+
+## Documentation
+
+For full documentation, read `seo/ranking-opportunities.md`.

.agent/scripts/commands/seo-export.md

@@ -0,0 +1,74 @@
+---
+description: Export SEO data from multiple platforms to TOON format
+agent: SEO
+mode: subagent
+---
+
+Export SEO ranking data from configured platforms to a common TOON format for analysis.
+
+Target: $ARGUMENTS
+
+## Quick Reference
+
+- **Purpose**: Export SEO data for analysis
+- **Platforms**: GSC, Bing, Ahrefs, DataForSEO
+- **Output**: `~/.aidevops/.agent-workspace/work/seo-data/{domain}/`
+
+## Usage
+
+```bash
+# Export from all platforms
+/seo-export all example.com
+
+# Export from specific platform
+/seo-export gsc example.com
+/seo-export bing example.com
+/seo-export ahrefs example.com
+/seo-export dataforseo example.com
+
+# With date range
+/seo-export all example.com --days 30
+
+# List available platforms
+/seo-export list
+
+# List exports for a domain
+/seo-export exports example.com
+```
+
+## Process
+
+1. Parse $ARGUMENTS to extract platform, domain, and options
+2. Run the appropriate export script:
+
+```bash
+~/.aidevops/agents/scripts/seo-export-helper.sh $ARGUMENTS
+```
+
+3. Report results including:
+   - Number of rows exported
+   - Output file location
+   - Any errors or warnings
+
+## Platform Requirements
+
+| Platform | Credential | Location |
+|----------|------------|----------|
+| GSC | Service account JSON | `GOOGLE_APPLICATION_CREDENTIALS` |
+| Bing | API key | `BING_WEBMASTER_API_KEY` |
+| Ahrefs | API key | `AHREFS_API_KEY` |
+| DataForSEO | Username/password | `DATAFORSEO_USERNAME`, `DATAFORSEO_PASSWORD` |
+
+All credentials should be set in `~/.config/aidevops/mcp-env.sh`.
+
+## Next Steps
+
+After export, suggest running analysis:
+
+```bash
+/seo-analyze example.com
+```
+
+## Documentation
+
+For full documentation, read `seo/data-export.md`.

.agent/scripts/commands/seo-opportunities.md

@@ -0,0 +1,88 @@
+---
+description: Export SEO data and analyze for ranking opportunities in one step
+agent: SEO
+mode: subagent
+---
+
+Export SEO data from all configured platforms and run full analysis in one step.
+
+Target: $ARGUMENTS
+
+## Quick Reference
+
+- **Purpose**: Complete SEO opportunity analysis workflow
+- **Combines**: `/seo-export all` + `/seo-analyze`
+- **Output**: Full analysis report with actionable opportunities
+
+## Usage
+
+```bash
+# Full workflow with default 90 days
+/seo-opportunities example.com
+
+# Custom date range
+/seo-opportunities example.com --days 30
+```
+
+## Process
+
+1. Parse $ARGUMENTS to extract domain and options
+2. Export from all configured platforms:
+
+```bash
+~/.aidevops/agents/scripts/seo-export-helper.sh all $DOMAIN --days $DAYS
+```
+
+3. Run full analysis:
+
+```bash
+~/.aidevops/agents/scripts/seo-analysis-helper.sh $DOMAIN
+```
+
+4. Present summary of findings:
+   - Top 10 quick wins
+   - Top 10 striking distance opportunities
+   - Low CTR pages needing optimization
+   - Content cannibalization issues
+
+## Output
+
+Two types of files are created:
+
+**Export files** (one per platform):
+
+```text
+~/.aidevops/.agent-workspace/work/seo-data/{domain}/{platform}-{start}-{end}.toon
+```
+
+**Analysis file**:
+
+```text
+~/.aidevops/.agent-workspace/work/seo-data/{domain}/analysis-{date}.toon
+```
+
+## Recommendations
+
+After analysis, provide prioritized recommendations:
+
+1. **Quick Wins** (do first)
+   - Fastest ROI
+   - Minimal effort required
+   - On-page changes only
+
+2. **Low CTR** (do second)
+   - Title/meta changes are quick
+   - Can significantly increase traffic
+
+3. **Cannibalization** (do third)
+   - Prevents wasted effort
+   - Consolidates ranking signals
+
+4. **Striking Distance** (longer term)
+   - Requires more effort
+   - Higher potential reward
+
+## Documentation
+
+- Export details: `seo/data-export.md`
+- Analysis details: `seo/ranking-opportunities.md`