norahe0304-art/30x-seo/30x-seo-monitor

SEO Monitor (Google Search Console)

Monitor your own website's SEO performance using Google Search Console API.

[PROTOCOL]: Update this header on changes, then check CLAUDE.md

Prerequisites

Requires gws CLI with Google Search Console access, or GSC MCP server.

Option 1: gws CLI

gws auth status
gws auth login  # if needed

Option 2: GSC MCP Server

Configure in ~/.config/claude/mcp.json:

{
  "mcpServers": {
    "google-search-console": {
      "command": "npx",
      "args": ["-y", "mcp-server-gsc"],
      "env": {
        "GOOGLE_CREDENTIALS_PATH": "/path/to/credentials.json"
      }
    }
  }
}

Commands

Metrics Explained

Analysis Workflows

1. Weekly Performance Check

/30x-seo monitor overview

Output:

• Total clicks, impressions, CTR, avg position (7 days)
• Top 10 queries by clicks
• Top 10 pages by clicks
• Week-over-week comparison

2. Keyword Ranking Report

/30x-seo monitor keywords

Output:

• All ranking keywords
• Position, clicks, impressions, CTR per keyword
• Sort by: position, clicks, impressions, or CTR

3. Position Change Detection

/30x-seo monitor changes

Output:

• Keywords that gained positions (rising)
• Keywords that lost positions (declining)
• New keywords (just started ranking)
• Lost keywords (dropped out of top 100)

4. Quick Win Opportunities

/30x-seo monitor opportunities

Find keywords with:

• High impressions (>1000/month)
• Low CTR (<3%)
• Position 4-20 (page 1-2)

These are "quick wins" - improve title/description to boost CTR.

Date Ranges

Default: last 7 days

Specify custom range:

/30x-seo monitor overview --days 30
/30x-seo monitor keywords --days 90

Output Format

Reports include:

1. Summary table — Key metrics at a glance
2. Detailed data — Full keyword/page lists
3. Action items — Specific recommendations

Integration with Other Skills

Limitations

• Only your verified sites — GSC only shows data for sites you own
• Data delay — GSC data is 2-3 days behind
• 90 day max — Historical data limited to ~16 months, but API typically 90 days
• Sampled data — High-traffic sites may show sampled data