Performance Review Commands

Performance review commands help you make data-driven content decisions by analyzing your existing content portfolio, identifying opportunities, and prioritizing work by ROI. These commands integrate with Google Analytics 4, Google Search Console, and DataForSEO.

Available Performance Commands

/performance-review

Analyze content performance data and generate a prioritized queue of content tasks. Usage:

/performance-review [days]

Examples:

/performance-review 30   # Last 30 days (default)
/performance-review 90   # Last 90 days for long-term trends
/performance-review 7    # Last 7 days for recent changes

What it does:

Data Collection
- Google Analytics 4: Traffic, engagement, conversions, trends
- Google Search Console: Rankings, impressions, clicks, CTR by page and keyword
- DataForSEO: Competitive rankings, SERP features, keyword metrics
Opportunity Identification
- Quick Wins: Keywords ranking 11-20 (page 2) closest to page 1
- Declining Content: Pages losing traffic month-over-month
- Low CTR Opportunities: High impressions but low click-through rates
- Trending Topics: Queries showing rising search volume
- Competitor Gaps: Keywords competitors rank for but you don’t
Scoring & Prioritization
- Each opportunity scored 0-100 based on:
  - Impact (50%): Potential traffic gain, conversion value, strategic importance
  - Effort (30%): Time required, difficulty, resources needed
  - Confidence (20%): Data quality, historical success rate, trend stability
Report Generation
- Executive summary of performance
- Priority queue (urgent/high/medium)
- Detailed opportunity analysis
- Content health dashboard
- Week-by-week implementation roadmap

Output: research/performance-review-[YYYY-MM-DD].md

Report Structure

1. Executive Summary

Report Date: 2025-10-15
Analysis Period: Last 30 days

Overall Performance:
- Total Pageviews: 125,400
- Total Clicks (GSC): 45,200
- Average Position: 12.3
- Total Keywords Ranking: 3,847

Key Trends:
- Organic traffic up 8% vs. previous period
- 7 articles showing significant decline
- 23 keywords moved to page 2 (quick win opportunities)

2. Priority Queue

🔥 URGENT (Do This Week)

1. Optimize for "podcast analytics dashboard"
   Type: Quick Win
   Current Position: 12
   Monthly Impressions: 5,400
   Potential Impact: Move to position 7, gain +450 clicks/month
   Estimated Effort: 3 hours
   Action: Update content, improve internal linking, refresh meta
   
   Opportunity Score: 87/100

3. Detailed Analysis

Quick Win Opportunities table
Declining Content analysis
Low CTR pages with meta recommendations
Trending topics to target
Competitor gap analysis

4. Implementation Roadmap

Week-by-week task breakdown with specific actions:

Week 1: Quick wins (3 optimizations)
Week 2: Declining content (2 refreshes)
Week 3: Meta improvements (5 pages)
Week 4: Trending topic (1 new article)

5. Success Metrics

Goals and measurement criteria for next review period

Prerequisites

1. Configure Data Sources

Set up API credentials in data_sources/config/.env:

# Copy example config
cp data_sources/config/.env.example data_sources/config/.env

# Edit with your credentials
nano data_sources/config/.env

Required credentials:

Google Analytics 4 property ID and service account JSON
Google Search Console site URL and credentials
DataForSEO API login and password

See data_sources/README.md for detailed setup instructions.

2. Install Python Dependencies

pip install -r data_sources/requirements.txt

3. Test Data Connections

python data_sources/modules/google_analytics.py
python data_sources/modules/google_search_console.py
python data_sources/modules/dataforseo.py

Integration with Other Commands

Performance review output directly informs other commands:

Quick Win Identified

Performance Review: “podcast monetization” at position 13 Next actions:

/analyze-existing /blog/podcast-monetization-guide
/optimize drafts/podcast-monetization-guide.md

Declining Content

Performance Review: Article lost 35% traffic Next actions:

/analyze-existing /blog/podcast-equipment-guide
/rewrite podcast equipment guide

Low CTR Opportunity

Performance Review: High impressions, 2.5% CTR Next action:

Use Meta Creator agent output from Performance Report
Update meta title and description manually or via CMS

Performance Review: “AI podcast tools” +150% growth Next actions:

/research AI podcast tools
/write AI podcast tools

Competitor Gap

Performance Review: competitor.com ranks #3, you’re not ranking Next actions:

/research podcast editing workflow
/write podcast editing workflow

/priorities

Generate a comprehensive, prioritized content roadmap using multiple SEO research angles. Usage:

/priorities              # Comprehensive research (~10 minutes)
/priorities quick       # Quick wins only (~2 minutes)

Comprehensive Mode (Default)

Runs 5 research modules:

Quick Wins - Keywords ranking 11-20 (page 2)
Competitor Gaps - What competitors rank for that you don’t
Performance Matrix - Categorize all content by health
Topic Clusters - Identify topical authority gaps
Trending Topics - Rising search trends

Generates unified roadmap combining all insights.

Quick Mode

Runs quick wins analysis only - fast turnaround for immediate opportunities.

Priorities Output Format

# Content Priorities - Top 10 Opportunities
**Generated**: YYYY-MM-DD HH:MM
**Data Period**: Last 30 days
**Total Opportunities Found**: X

---

## 🏆 TOP 10 PRIORITIES

### 1. [Keyword] - EXISTING CONTENT UPDATE | Priority: HIGH
- **Current Position**: 13
- **Search Volume**: 2,400/month
- **Impressions**: 1,850 (30d)
- **Current Clicks**: 45
- **Potential Clicks**: ~102 (+57)
- **Commercial Intent**: High
- **Opportunity Score**: 87/100
- **Ranking URL**: https://yoursite.com/path/to/article

**Why it matters**: High search volume with strong commercial intent. Currently on page 2 but very close to page 1. Small improvements could drive significant traffic.

**Action**: Update existing article, refresh stats, improve keyword placement in H2s, add internal links

---

### 2. [Keyword] - NEW CONTENT CREATION | Priority: HIGH
- **Current Position**: Not ranking top 100
- **Search Volume**: 3,200/month
- **Impressions**: 890 (30d)
- **Current Clicks**: 8
- **Potential Clicks**: ~176 (if rank 5-7)
- **Commercial Intent**: Medium
- **Opportunity Score**: 82/100

**Why it matters**: High search volume, solid impressions despite no strong ranking. Gap in our content portfolio.

**Action**: Create comprehensive 2500+ word guide targeting this keyword

---

[Continue for all 10 opportunities...]

## 📊 SUMMARY

**Content Type Breakdown:**
- Existing Content Updates: X items
- New Content Creation: X items

**Combined Potential:**
- Total Current Monthly Clicks: X
- Total Potential Monthly Clicks: X
- Additional Monthly Clicks: +X

**Recommended Workflow:**
1. Start with top 3 EXISTING CONTENT updates (faster wins)
2. Begin research for top 2 NEW CONTENT pieces
3. Monitor rankings weekly for updated content
4. Iterate through remaining 5 items based on results

**Next Steps:**
- Use `/analyze-existing [URL]` for detailed analysis
- Use `/write [keyword]` to create new content
- Use `/optimize [file]` before publishing updates

Output: research/priorities-YYYY-MM-DD.md

Frequency Recommendations

Weekly (Quick Check)

Review top 3 urgent priorities
Monitor critical metrics (declining pages, position changes)
Adjust current work based on new data

Monthly (Full Review)

Complete /performance-review analysis
Assess previous month’s actions and results
Plan next month’s content priorities
Adjust strategy based on trends

Quarterly (Strategic Review)

Long-term trend analysis
Competitive landscape shifts
Content portfolio health assessment
Resource allocation strategy

Best Practices

1. Act on Data Quickly

The biggest gains come from quick wins - prioritize position 11-20 optimizations.

2. Track Results

Document what you implement and measure results:

## Action Taken (2025-10-15)
- Optimized "podcast analytics" article
- Target: Move from position 13 → 8
- Changes: Added 500 words, improved meta, 3 internal links

## Results (2025-11-15)
- New Position: 9 (improved 4 positions)
- Traffic: +35% (+420 pageviews/month)
- Clicks: +18% (+89 clicks/month)

3. Don’t Ignore Declining Content

Revenue leakage compounds - stop declines before creating new content.

4. Balance Quick Wins vs. Strategic Projects

80/20 rule: 80% effort on quick wins and optimization, 20% on new strategic content.

5. Review Data Freshness

GA4: Usually next-day data
GSC: 2-3 day delay typical
DataForSEO: Real-time API data

Plan reviews accounting for data lag.

Expected Impact

Based on typical results:

Quick Wins (Position 11-20 → 5-10)

Average traffic increase: 40-80%
Timeframe: 2-8 weeks
Success rate: 60-70% move to page 1

Declining Content Updates

Average recovery: 50-90% of lost traffic
Timeframe: 2-4 weeks
Often exceeds original performance with refresh

Low CTR Meta Improvements

Average CTR increase: 30-60%
Timeframe: Immediate (1-2 weeks)
Easiest wins with guaranteed impact

Variable based on competition
First-mover advantage significant
Build authority before competition heats up

Example Workflow

# Month start: Run performance review
/performance-review 30

# Review report: research/performance-review-2025-10-15.md
# Identify top 5 priorities

# Week 1: Quick wins
/analyze-existing /blog/top-quick-win-article
/optimize drafts/top-quick-win-article.md

# Week 2: Declining content
/analyze-existing /blog/declining-article
/rewrite declining article

# Week 3: Meta improvements
# Update meta elements for 5 low-CTR pages

# Week 4: Trending topic
/research [trending topic from report]
/write [trending topic]

# Month end: Review results, run new performance review
/performance-review 30
# Compare to previous month, adjust strategy

Troubleshooting

”No data returned”

Check API credentials in .env
Verify property IDs and site URLs
Ensure service accounts have proper access
Check date ranges (some metrics have minimum history)

“DataForSEO budget exceeded”

Check DATAFORSEO_DAILY_BUDGET_LIMIT in .env
Reduce frequency of checks
Use cached data when possible (set CACHE_ENABLED=true)

“Performance report too long”

Reduce days parameter for shorter period
Focus on top opportunities only
Export to separate file for detailed analysis

”Recommendations don’t match business goals”

Adjust scoring weights in Performance Agent
Filter opportunities by topic/keyword
Manually override priority based on strategy

Success Criteria

A successful performance review should:

✅ Identify 10+ actionable opportunities
✅ Prioritize work by ROI, not just volume
✅ Provide specific next steps for each opportunity
✅ Estimate impact and effort for resource planning
✅ Create clear roadmap for next 30 days
✅ Set measurable goals for tracking progress

Remember: Data without action is just noise. Use these reports to drive actual content work, measure results, and continuously improve your SEO strategy.

Getting Started

Core Concepts

Workflows

Commands

Advanced Commands

Agents

Data Sources

Integrations

Documentation Index

​Available Performance Commands