square-lupus579 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
| 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:
- Summary table — Key metrics at a glance
- Detailed data — Full keyword/page lists
- 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