mcpField
G
gsc-analyzer

gsc-analyzer

github.com/coreyrabMarketing & growth458 installsUpdated 40w ago
Repository

About gsc-analyzer

A workflow skill for analyzing Google Search Console data for startup founders and marketing leaders. It combines SEO, brand, content, and paid-search analysis with business context and revenue estimates to produce prioritized recommendations.

Key features

  1. 01Parse GSC CSV or ZIP data
  2. 02Compare brand and non-brand traffic
  3. 03Find SEO and CTR opportunities
  4. 04Identify content gaps and paid-search targets
  5. 05Estimate revenue impact and prioritize actions

Use cases

  1. 01Assess brand dependence and organic growth trends
  2. 02Find high-impression, low-CTR search queries
  3. 03Plan content and keyword opportunities
  4. 04Prepare quarterly priorities from GSC data

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/coreyrab/gsc-skills --skill gsc-analyzer

After installing, type/gsc-analyzerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
brand_analysis.md
content_opportunities.md
paid_search.md
seo_analysis.md
strategic_frameworks.md
scripts/
parse_gsc_data.py

Details

From the project README

Google Search Console Analyzer

Transform GSC data into strategic, revenue-focused insights for startup founders and marketing leaders.

Workflow

  1. Parse the GSC data (read CSV files or run parser for zip)
  2. Confirm brand terms (use AskUserQuestion)
  3. Ask for business context (conversion rate, ACV, goals)
  4. Filter irrelevant/spam queries
  5. Ask which analysis mode(s) to run
  6. Execute analysis with revenue impact estimates
  7. Generate strategic report with prioritized actions

Business Context Collection

Before analysis, gather key inputs to size opportunities:

AskUserQuestion:
1. "What's your approximate trial/signup conversion rate from organic traffic?"
   - Options: <1%, 1-2%, 2-4%, 4%+, Not sure

2. "What's your average contract value (ACV)?"
   - Options: <$200/yr, $200-500/yr, $500-2000/yr, $2000+/yr, Enterprise pricing

3. "What's your primary goal for this analysis?"
   - Options: Growth planning, Competitive analysis, Quarterly prioritization, All of the above

Brand Term Detection (Required)

Read: references/brand_analysis.md for methodology.

  1. Auto-detect brand terms (exact name, domain, misspellings)
  2. Use AskUserQuestion to confirm
  3. Flag irrelevant/spam queries for exclusion

Analysis Modes

Mode 1: Brand vs. Non-Brand Analysis

For: Understanding marketing effectiveness and growth sustainability.

Read: references/brand_analysis.md

Key outputs:

  • Brand dependency score (healthy: 20-40%)
  • Traffic composition breakdown
  • Trend analysis (is brand or non-brand growing?)
  • Risk assessment if brand-heavy
Mode 2: SEO Analyst

For: Finding quick wins and optimization opportunities.

Read: references/seo_analysis.md

Key outputs:

  • Quick wins: Position 4-10, high volume (with revenue estimate)
  • Striking distance: Position 11-20 keywords
  • CTR optimization opportunities
  • Cannibalization issues
Mode 3: Content Strategist

For: Identifying content gaps and new opportunities.

Read: references/content_opportunities.md

Key outputs:

  • Topic clusters without dedicated content
  • Question-based content opportunities
  • Comparison content gaps (vs competitors)
  • International/multilingual opportunities
Mode 4: Paid Search Specialist

For: Building Google Ads strategy from organic data.

Read: references/paid_search.md

Key outputs:

  • High-intent keywords not ranking organically
  • SERP domination opportunities
  • Competitor conquesting targets
  • Budget allocation recommendations
Mode 5: Strategic Summary

For: Quarterly planning, team alignment, prioritization.

Read: references/strategic_frameworks.md

Output format:

# [Company] Organic Search Performance - [Period]

## Headline Metrics (table)
## Key Risks (numbered, with business impact)
## Key Opportunities (numbered, with revenue estimates)
## Resource Requirements (specific asks)
## 90-Day Priorities (with owners)

Strategic Frameworks

Read: references/strategic_frameworks.md for all frameworks.

Revenue Impact Estimation

Size every opportunity in dollars:

Revenue = Traffic Gain × Conv Rate × Trial-to-Paid × ACV
Funnel Stage Classification
StageKeywords ContainPriority
TOFU"what is", "how to"Content marketing
MOFU"best", "vs", "comparison"HIGH - conversion
BOFU"pricing", "[brand]", "demo"Highest intent
Share of Voice

Estimate competitive position from ranking data:

  • Position 1 = 25-35% of clicks
  • Position 2-3 = 8-18% of clicks
  • Position 4-10 = 2-8% of clicks
Anomaly Detection

Flag automatically:

  • Traffic drops >20%
  • CTR anomalies (high impressions, low clicks)
  • Position changes on key terms

Quick Reference

Intent Classification
Signal WordsIntentBest For
buy, price, demo, trialHigh (transactional)Paid Search
best, vs, compare, reviewMedium-High (MOFU)SEO + PPC
how to, guide, what isMedium (TOFU)Content
[brand], loginNavigationalBrand defense
Healthy Benchmarks
MetricHealthyWarningCritical
Brand % of traffic20-40%40-60%>60%
Non-brand CTR5-15%2-5%<2%
Avg non-brand position<55-10>10

Example Outputs

  • "Analyze this GSC data" → Full analysis with strategic summary
  • "How much revenue are we leaving on the table?" → Revenue impact mode
  • "Give me the TL;DR on our SEO performance" → Strategic summary
  • "What should we focus on this quarter?" → Prioritized recommendations

Comments

Markdown supported