30x-seo-monitor

---
name: 30x-seo-monitor
description: >
license: MIT
---

# 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

```bash
gws auth status
gws auth login  # if needed
```

### Option 2: GSC MCP Server

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

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

---

## Commands

| Command | What it does |
|---------|--------------|
| `/30x-seo monitor overview` | Dashboard: top queries, pages, CTR, position |
| `/30x-seo monitor keywords` | All ranking keywords with metrics |
| `/30x-seo monitor pages` | Top performing pages |
| `/30x-seo monitor changes` | Position changes (gains/losses) |
| `/30x-seo monitor opportunities` | High impression, low CTR keywords |

---

## Metrics Explained

| Metric | What it means |
|--------|---------------|
| **Clicks** | Users clicked your result |
| **Impressions** | Your result appeared in search |
| **CTR** | Click-through rate (clicks / impressions) |
| **Position** | Average ranking position (1 = top) |

---

## 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

| Scenario | Next Step |
|----------|-----------|
| Found declining keyword | → `30x-seo-content-decay` to analyze page |
| Low CTR on page 1 | → `30x-seo-page` to optimize title/meta |
| Keyword cannibalization suspected | → `30x-seo-cannibalization` to check |
| New keyword opportunity | → `30x-seo-content-brief` to plan content |

---

## 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