search-rank

Use when analyzing keyword rankings, identifying page-1 opportunities, tracking position changes, detecting SERP features, or classifying search intent from GSC data. Also use when you need a data-driven ranking report with actionable recommendations.

Model	Source
sonnet	pack: seo

Full Reference

Search Rank

Deep keyword ranking analysis using Google Search Console data. Identifies page-1 opportunities (positions 8–20 with real volume), tracks position changes over time, correlates ranking shifts with optimization actions, and classifies search intent for smarter targeting.

The data-driven complement to seo-audit. Use it when you need to understand ranking performance before deciding what to fix.

Quick Reference

Item	Value
Primary data source	google-search-console-api — 90-day rolling window
GSC data lag	2–3 days — analyze weekly averages, not daily
Ranking change lag	2–6 weeks after on-page changes
Page-1 opportunity criteria	Position 8–20, impressions > 100 (90-day)
Content gap threshold	Position > 20 with > 500 monthly impressions
CTR anomaly flag	Actual CTR < expected lower bound × 0.7
GSC row limit	1000 rows — ordered by impressions DESC
Optimization log location	.claude/progress/optimization-log/changes.jsonl
Report save location	.claude/progress/search-rank-[YYYY-MM-DD].md
Zero-click signal	Position 1-3 with CTR < 5%

Reference Index

I want to…	File
Run the full analysis pipeline, see GSC query spec, output report template, decision matrix, AI search intent classification	reference/analysis-pipeline.md

Usage: Read the reference file matching your current task from the index above. Each file is self-contained with code examples and inline gotchas.

---

Announcement

┏━ 📊 search-rank ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Deep keyword ranking analysis — page-1 opps, ┃ ┃ position changes, and intent classification ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛