Example output: examples/seo-page-notion-keyboard-shortcuts-20260514/PAGE.md
Page Intelligence
Show what a single URL ranks for, what traffic it captures, where its weak and strong points are, and what to do about it. The deliverable is an opinionated verdict — KEEP, REFRESH, CONSOLIDATE, or KILL — anchored in objective signals from SE Ranking's URL-level data.
Prerequisites
- SE Ranking MCP server connected.
- Claude's
WebFetch tool available (for the page-level HTML sense-check).
- User provides: (a) a target URL, optionally (b) target market country (default:
us), (c) primary topical keyword (auto-inferred from <title> + <h1> if not supplied).
Process
Validate target & preflight. See skills/seo-firecrawl/references/preflight.md for the canonical 3-stage preflight (credit balance, Firecrawl availability, Google APIs). Skill-specific notes:
- Confirm the URL is fetchable; derive parent domain. If the user supplied a primary keyword, use it; otherwise infer it in step 3.
- Estimated SE Ranking cost for this skill: ~10–15 credits typical (URL overview, ranking keywords, page authority, SERP context for top 3–5 keywords).
- Firecrawl: optional with WebFetch fallback, ~1 Firecrawl credit if available. When available, step 6 recovers
og:*, twitter:*, canonical, robots meta, JSON-LD types, and hreflang count from raw <head> — WebFetch returns markdown only and strips those fields. Without Firecrawl, the affected lines in PAGE.md emit (skipped — Firecrawl not installed). Pass --no-firecrawl to treat Firecrawl as unavailable even when installed (credit conservation).
- Google APIs: tier 1 (GSC available) unlocks step 4b (GSC URL performance + URL Inspection) after the page-authority step. See
skills/seo-google/references/cross-skill-integration.md § "seo-page" for the full recipe.
URL-level overview DATA_getUrlOverviewWorldwide
- Pull keyword count, organic traffic estimate, paid keyword count, paid traffic estimate, top regions.
- Note: traffic estimates are directional — they don't replace Google Search Console.
Ranking keywords DATA_getDomainKeywords (use the url param for exact match — not filter_url)
- Pull every keyword the URL ranks for in the target country, with positions.
- Sort by traffic-weighted score:
volume × CTR-by-position (use a standard CTR curve: 1=28%, 2=15%, 3=11%, 4=8%, 5=7%, 6=5%, 7=4%, 8=3%, 9=2%, 10=2%, 11+=1%).
- Take the top 3–5 as the URL's "primary keywords" for SERP work in step 5.
Page authority DATA_getPageAuthority + DATA_getPageAuthorityHistory
- Current PA score and its 12-month trajectory.
- Flag any drop > 5 points in the last 90 days.
4b. GSC URL performance + URL Inspection (only if google-api.json is present, tier ≥ 1)
- Replaces the directional traffic estimate from step 2 with first-party Google data for the exact URL.
- Pull GSC search analytics for the URL (last 28 days, by query and page):
python3 scripts/gsc_query.py --property "{config.default_property}" --url "{target_url}" --days 28 --json
- Pull URL Inspection (real indexation status, canonical Google sees, last crawl date):
python3 scripts/gsc_inspect.py "{target_url}" --site-url "{config.default_property}" --json
- If the URL's domain isn't a verified GSC property: surface "GSC: {target_domain} not verified — add it in Search Console" and continue with SE Ranking data only.
- Surface in
PAGE.md "## Snapshot": GSC last 28d: {clicks}/{impressions}/{ctr}% CTR / pos {position} and Google sees: {INDEXED|EXCLUDED} · canonical {userCanonical} → {googleCanonical} · last crawled {date}.
- Feed into the verdict heuristic:
INDEXED + impressions > 100 + position 4–10 → harden REFRESH (clear quick-win). EXCLUDED (any reason) → harden KILL or CONSOLIDATE. userCanonical ≠ googleCanonical → flag as critical issue regardless of verdict.
- See
skills/seo-google/references/cross-skill-integration.md § "seo-page" for the full recipe.
SERP context DATA_getSerpResults and DATA_getAiOverview
- For each of the 3–5 primary keywords:
- Top 10 organic results (URL, title, snippet).
- SERP features present (PAA, image carousel, video, shopping, etc.).
- AIO presence and citations — is this URL cited in the AIO?
HTML sense-check WebFetch (always) + mcp__firecrawl-mcp__firecrawl_scrape (when available)
- WebFetch first (free, instant): extract
<title>, meta description, all <h1..h6>, lang, word count, internal-link count, image count. WebFetch returns markdown so anything in <head> beyond <title> is lost — the next bullet recovers it.
- Firecrawl second (1 Firecrawl credit; pass
formats: ["rawHtml"]) — recovers what WebFetch can't see. Pin the format to rawHtml; the default html is post-processed and silently strips canonical, hreflang, and <script type="application/ld+json"> blocks on many sites. If those head fields come back zero on a site that obviously has them (any major SaaS homepage), you forgot the rawHtml flag — re-run.
- From
metadata: og:title, og:description, og:image, twitter:card, viewport, robots meta, canonical URL.
- From the returned
rawHtml: every <script type="application/ld+json"> block. Parse each as JSON, list detected @types (Article, BreadcrumbList, Organization, Product, etc.). Note any block that fails to parse.
- hreflang: count
<link rel="alternate" hreflang="…"> occurrences in rawHtml.
- If Firecrawl unavailable: the WebFetch portion still runs; populate Page basics' OG / Twitter / canonical / robots / JSON-LD / hreflang lines as
(skipped — Firecrawl not installed). Don't infer from markdown.
- Sense-check: does the page actually talk about its top-ranking keyword in title and H1? If a page ranks for keywords it doesn't address textually, that's a strong consolidation signal.
Domain context DATA_getDomainOverviewWorldwide (parent domain)
- Light-weight: parent DA, total keywords, total traffic. Used to contextualise the page's PA against its domain.
Cannibalization check DATA_getDomainPages
- Pull the parent domain's pages ranked by organic traffic. Cap at the top 50 — that's where the cannibalization risk concentrates.
- For the candidate URL's top-3 traffic-weighted keywords (from step 3), scan the peer-page list: does any other URL on the same domain rank in the top 20 for any of those keywords?
- Cannibalization signal: any peer URL ranking ≤ 20 for the candidate's top-3 keywords. Record peer URL, keyword, peer position vs candidate position, peer traffic.
- Cheaper than the old approach. Previous versions cross-checked via
DATA_getDomainKeywords on the parent domain — that endpoint can return tens of thousands of rows on large sites and is unnecessarily heavy for this question. DATA_getDomainPages ranked by traffic surfaces the high-impact peers directly.
- If no peer URL competes, this signal is "no cannibalization detected" — pass through to step 9.
Synthesise verdict
- Apply the verdict heuristic (see Tips) to produce KEEP / REFRESH / CONSOLIDATE / KILL.
- For REFRESH, identify the top 3 specific changes (e.g., "add an H2 on 'alternatives' which 7 of 10 SERP winners use").
- Write
PAGE.md (output spec below).
Output format
Create a folder seo-page-{target-slug}-{YYYYMMDD}/ with:
seo-page-{target-slug}-{YYYYMMDD}/
├── PAGE.md (synthesised verdict + plan — primary deliverable)
├── keywords.csv (full keyword list with positions — load-bearing CSV the auditor walks through row-by-row)
├── 04-serp-context.md (top 10 + AIO for top 3–5 keywords — load-bearing reference for SERP-driven REFRESH discussions)
└── evidence/
├── 01-url-overview.md (raw DATA_getUrlOverviewWorldwide)
├── 02-keywords.md (raw DATA_getDomainKeywords filtered)
├── 03-authority.md (PA + history)
├── 05-page-snapshot.md (HTML extracts)
└── 06-cannibalization.md (peer pages on the same domain competing for the top-3 keywords)
Top-level: PAGE.md + keywords.csv + 04-serp-context.md. The other step files preserve raw API/HTML extracts in evidence/ for reproducibility — auditors lean on the CSV and SERP context, not the per-call dumps.
PAGE.md follows this shape:
# Page Intelligence: {URL}
> Snapshot dated {YYYY-MM-DD} · Country: {country} · Primary keyword: {keyword}
## Snapshot
- Ranking keywords: {n}
- Estimated monthly organic traffic: {n}
- Page authority: {PA} ({↑/↓ trajectory over 90 days})
- Primary topic: {topic}
- AIO citations: {n} of {checked} primary-keyword AIOs cite this URL
- GSC last 28d: {clicks} clicks / {impressions} impressions / {ctr}% CTR / avg position {n} *(or `not configured` / `property not verified`)*
- Google sees: {INDEXED|EXCLUDED|...} · canonical {userCanonical} {→ googleCanonical if differ} · last crawled {YYYY-MM-DD}
## Page basics
- `<title>`: {value}
- meta description: {value | absent}
- `og:title`: {value | absent | skipped — Firecrawl required}
- `og:description`: {value | absent | skipped}
- `og:image`: {url | absent | skipped}
- `twitter:card`: {summary | summary_large_image | absent | skipped}
- `<link rel="canonical">`: {URL | self-referential | absent | skipped}
- meta robots: {index,follow | noindex,nofollow | absent | skipped}
- JSON-LD types detected: {Article, BreadcrumbList, Organization | none | skipped}
- hreflang variants: {n | skipped}
## What this page wins
- {keyword} — position {n}, ~{volume} monthly searches, ~{traffic} monthly clicks.
- ... (top 3–5)
## Almost-wins (page-2 refresh opportunities)
- {keyword} — position {n}, ~{volume} monthly searches. The top 3 SERP winners all do {pattern} that this page doesn't.
- ... (top 3 examples)
## What this page misses
- {keyword} — competitors {comp1}, {comp2} rank in top 5; this page is absent.
- ...
## Same-domain cannibalization
- {peer URL} — ranks position {n} for "{keyword}" (candidate ranks position {m}). Peer estimated traffic: {n}/mo.
- ... (only list rows where a peer URL ranks ≤ 20 for one of the candidate's top-3 keywords; if none, write "No same-domain cannibalization detected on top-3 keywords.")
## AI Search angle
- {n} of {checked} AIO queries on the URL's keywords cite this page.
- The AIOs that DON'T cite this page tend to cite {pattern} (e.g., comparison tables, step-by-step how-tos).
- Recommended GEO move: {one specific change}.
## Verdict: {KEEP | REFRESH | CONSOLIDATE | KILL}
Reasoning: {1–2 sentences anchored in objective signals from above}.
### If REFRESH — top 3 changes
1. {Specific change}
2. {Specific change}
3. {Specific change}
## Raw data
- keywords.csv — full enriched ranking-keyword list
- 04-serp-context.md — per-keyword SERP top-10 with AIO
- evidence/05-page-snapshot.md — HTML extracts
keywords.csv columns: keyword,volume,kd,position,intent,traffic_estimate,url
Tips
- Respect SE Ranking Data API rate limit: 10 requests per second. The 3–5 SERP queries in step 5 should be paced sequentially.
- Call
DATA_getCreditBalance before running. ~10–15 credits is typical for one URL.
- Verdict heuristic:
- KEEP: PA stable or up; traffic stable or up; top 3 keywords held in their positions; AIO citations present where AIO appears.
- REFRESH: any of (PA dropped >5 in 90 days; traffic dropped >20%; a top-3 keyword fell to position 11+; AIO citations missing while competitors get cited). Hardens when GSC data (step 4b) shows
INDEXED + impressions > 100 + average position 4–10 (clear quick-win territory).
- CONSOLIDATE: cannibalization detected (step 8) — a peer URL on the same domain ranks ≤ 20 for one or more of the candidate's top-3 keywords. CONSOLIDATE harden when the peer outranks the candidate AND captures higher traffic; otherwise CONSOLIDATE recommendation is "merge into the candidate" rather than "kill the candidate."
- KILL: PA <10 AND traffic <50/mo AND no top-10 keyword AND no internal links pointing to it. Hardens when JSON-LD schema is also absent (Firecrawl detected zero blocks) — the page has no signals for any crawler, organic or AI. Also hardens when URL Inspection (step 4b) returns
EXCLUDED for any reason.
- GSC canonical mismatch (any verdict): if step 4b detects
userCanonical ≠ googleCanonical, flag this as a critical issue in PAGE.md regardless of the verdict — it points at indexing instability that the verdict on its own can't resolve.
- Don't invent reasons. Anchor every claim in
PAGE.md to a number from the raw data files.
- When between KEEP and REFRESH, default to REFRESH — small refreshes compound.
- The
keywords.csv is the auditable trail. If a stakeholder questions the verdict, walk them through the CSV row by row.
- For pages with very low data (new pages, <5 ranking keywords), the verdict is unreliable. Flag as "insufficient data — re-run after 60 days" rather than forcing a verdict.
DATA_getPageAuthorityHistory all-zeros caveat: if the endpoint returns inlink_rank: 0 (or equivalent) for every date in the history window, treat as "insufficient history" — don't claim a drop or recommend REFRESH based on it. Often happens for very high-authority pages where the metric is saturated, or for URLs that haven't accumulated enough longitudinal data. Cross-check with DATA_getPageAuthority (current value) — if current PA is meaningful but history is flat-zero, flag the gap explicitly in PAGE.md rather than synthesising a trajectory.
1---2name: seo-page3description: URL-level SEO intelligence — which keywords this page ranks for, traffic captured, position history, SERP context, and AI Search citation status. Produces a keep / refresh / consolidate / kill verdict for one page. Distinct from `seo-technical-audit` (which checks technical health, not keyword/traffic performance) and from `seo-content-brief` (which produces a NEW article from a topic). Use when the user asks "analyze this page", "page SEO performance", "what does this URL rank for", "page traffic", "should I refresh this page", or provides a single URL for analysis.4---5> Example output: [examples/seo-page-notion-keyboard-shortcuts-20260514/PAGE.md](../../examples/seo-page-notion-keyboard-shortcuts-20260514/PAGE.md)67# Page Intelligence89Show what a single URL ranks for, what traffic it captures, where its weak and strong points are, and what to do about it. The deliverable is an opinionated verdict — **KEEP**, **REFRESH**, **CONSOLIDATE**, or **KILL** — anchored in objective signals from SE Ranking's URL-level data.1011## Prerequisites1213- SE Ranking MCP server connected.14- Claude's `WebFetch` tool available (for the page-level HTML sense-check).15- User provides: (a) a target URL, optionally (b) target market country (default: `us`), (c) primary topical keyword (auto-inferred from `<title>` + `<h1>` if not supplied).1617## Process18191. **Validate target & preflight.** See `skills/seo-firecrawl/references/preflight.md` for the canonical 3-stage preflight (credit balance, Firecrawl availability, Google APIs). Skill-specific notes:20 - Confirm the URL is fetchable; derive parent domain. If the user supplied a primary keyword, use it; otherwise infer it in step 3.21 - Estimated SE Ranking cost for this skill: ~10–15 credits typical (URL overview, ranking keywords, page authority, SERP context for top 3–5 keywords).22 - Firecrawl: optional with WebFetch fallback, ~1 Firecrawl credit if available. When available, step 6 recovers `og:*`, `twitter:*`, canonical, robots meta, JSON-LD types, and hreflang count from raw `<head>` — WebFetch returns markdown only and strips those fields. Without Firecrawl, the affected lines in `PAGE.md` emit `(skipped — Firecrawl not installed)`. Pass `--no-firecrawl` to treat Firecrawl as unavailable even when installed (credit conservation).23 - Google APIs: tier 1 (GSC available) unlocks step 4b (GSC URL performance + URL Inspection) after the page-authority step. See `skills/seo-google/references/cross-skill-integration.md` § "seo-page" for the full recipe.24252. **URL-level overview** `DATA_getUrlOverviewWorldwide`26 - Pull keyword count, organic traffic estimate, paid keyword count, paid traffic estimate, top regions.27 - Note: traffic estimates are directional — they don't replace Google Search Console.28293. **Ranking keywords** `DATA_getDomainKeywords` (use the `url` param for exact match — not `filter_url`)30 - Pull every keyword the URL ranks for in the target country, with positions.31 - Sort by traffic-weighted score: `volume × CTR-by-position` (use a standard CTR curve: 1=28%, 2=15%, 3=11%, 4=8%, 5=7%, 6=5%, 7=4%, 8=3%, 9=2%, 10=2%, 11+=1%).32 - Take the top 3–5 as the URL's "primary keywords" for SERP work in step 5.33344. **Page authority** `DATA_getPageAuthority` + `DATA_getPageAuthorityHistory`35 - Current PA score and its 12-month trajectory.36 - Flag any drop > 5 points in the last 90 days.37384b. **GSC URL performance + URL Inspection** *(only if google-api.json is present, tier ≥ 1)*39 - Replaces the directional traffic estimate from step 2 with first-party Google data for the exact URL.40 - Pull GSC search analytics for the URL (last 28 days, by query and page):41 `python3 scripts/gsc_query.py --property "{config.default_property}" --url "{target_url}" --days 28 --json`42 - Pull URL Inspection (real indexation status, canonical Google sees, last crawl date):43 `python3 scripts/gsc_inspect.py "{target_url}" --site-url "{config.default_property}" --json`44 - If the URL's domain isn't a verified GSC property: surface "GSC: {target_domain} not verified — add it in Search Console" and continue with SE Ranking data only.45 - Surface in `PAGE.md` "## Snapshot": `GSC last 28d: {clicks}/{impressions}/{ctr}% CTR / pos {position}` and `Google sees: {INDEXED|EXCLUDED} · canonical {userCanonical} → {googleCanonical} · last crawled {date}`.46 - **Feed into the verdict heuristic:** `INDEXED` + impressions > 100 + position 4–10 → harden REFRESH (clear quick-win). `EXCLUDED` (any reason) → harden KILL or CONSOLIDATE. `userCanonical ≠ googleCanonical` → flag as critical issue regardless of verdict.47 - See `skills/seo-google/references/cross-skill-integration.md` § "seo-page" for the full recipe.48495. **SERP context** `DATA_getSerpResults` and `DATA_getAiOverview`50 - For each of the 3–5 primary keywords:51 - Top 10 organic results (URL, title, snippet).52 - SERP features present (PAA, image carousel, video, shopping, etc.).53 - AIO presence and citations — is this URL cited in the AIO?54556. **HTML sense-check** `WebFetch` (always) + `mcp__firecrawl-mcp__firecrawl_scrape` (when available)56 - **WebFetch first** (free, instant): extract `<title>`, meta description, all `<h1..h6>`, lang, word count, internal-link count, image count. WebFetch returns markdown so anything in `<head>` beyond `<title>` is lost — the next bullet recovers it.57 - **Firecrawl second** (1 Firecrawl credit; pass `formats: ["rawHtml"]`) — recovers what WebFetch can't see. Pin the format to `rawHtml`; the default `html` is post-processed and silently strips canonical, hreflang, and `<script type="application/ld+json">` blocks on many sites. If those head fields come back zero on a site that obviously has them (any major SaaS homepage), you forgot the `rawHtml` flag — re-run.58 - From `metadata`: `og:title`, `og:description`, `og:image`, `twitter:card`, `viewport`, robots meta, canonical URL.59 - From the returned `rawHtml`: every `<script type="application/ld+json">` block. Parse each as JSON, list detected `@type`s (Article, BreadcrumbList, Organization, Product, etc.). Note any block that fails to parse.60 - hreflang: count `<link rel="alternate" hreflang="…">` occurrences in `rawHtml`.61 - **If Firecrawl unavailable:** the WebFetch portion still runs; populate Page basics' OG / Twitter / canonical / robots / JSON-LD / hreflang lines as `(skipped — Firecrawl not installed)`. Don't infer from markdown.62 - **Sense-check:** does the page actually talk about its top-ranking keyword in title and H1? If a page ranks for keywords it doesn't address textually, that's a strong consolidation signal.63647. **Domain context** `DATA_getDomainOverviewWorldwide` (parent domain)65 - Light-weight: parent DA, total keywords, total traffic. Used to contextualise the page's PA against its domain.66678. **Cannibalization check** `DATA_getDomainPages`68 - Pull the parent domain's pages ranked by organic traffic. Cap at the top 50 — that's where the cannibalization risk concentrates.69 - For the candidate URL's top-3 traffic-weighted keywords (from step 3), scan the peer-page list: does any other URL on the same domain rank in the top 20 for any of those keywords?70 - **Cannibalization signal:** any peer URL ranking ≤ 20 for the candidate's top-3 keywords. Record peer URL, keyword, peer position vs candidate position, peer traffic.71 - **Cheaper than the old approach.** Previous versions cross-checked via `DATA_getDomainKeywords` on the parent domain — that endpoint can return tens of thousands of rows on large sites and is unnecessarily heavy for this question. `DATA_getDomainPages` ranked by traffic surfaces the high-impact peers directly.72 - If no peer URL competes, this signal is "no cannibalization detected" — pass through to step 9.73749. **Synthesise verdict**75 - Apply the verdict heuristic (see Tips) to produce KEEP / REFRESH / CONSOLIDATE / KILL.76 - For REFRESH, identify the top 3 specific changes (e.g., "add an H2 on 'alternatives' which 7 of 10 SERP winners use").77 - Write `PAGE.md` (output spec below).7879## Output format8081Create a folder `seo-page-{target-slug}-{YYYYMMDD}/` with:8283```84seo-page-{target-slug}-{YYYYMMDD}/85├── PAGE.md (synthesised verdict + plan — primary deliverable)86├── keywords.csv (full keyword list with positions — load-bearing CSV the auditor walks through row-by-row)87├── 04-serp-context.md (top 10 + AIO for top 3–5 keywords — load-bearing reference for SERP-driven REFRESH discussions)88└── evidence/89 ├── 01-url-overview.md (raw DATA_getUrlOverviewWorldwide)90 ├── 02-keywords.md (raw DATA_getDomainKeywords filtered)91 ├── 03-authority.md (PA + history)92 ├── 05-page-snapshot.md (HTML extracts)93 └── 06-cannibalization.md (peer pages on the same domain competing for the top-3 keywords)94```9596Top-level: `PAGE.md` + `keywords.csv` + `04-serp-context.md`. The other step files preserve raw API/HTML extracts in `evidence/` for reproducibility — auditors lean on the CSV and SERP context, not the per-call dumps.9798`PAGE.md` follows this shape:99100```markdown101# Page Intelligence: {URL}102103> Snapshot dated {YYYY-MM-DD} · Country: {country} · Primary keyword: {keyword}104105## Snapshot106- Ranking keywords: {n}107- Estimated monthly organic traffic: {n}108- Page authority: {PA} ({↑/↓ trajectory over 90 days})109- Primary topic: {topic}110- AIO citations: {n} of {checked} primary-keyword AIOs cite this URL111- GSC last 28d: {clicks} clicks / {impressions} impressions / {ctr}% CTR / avg position {n} *(or `not configured` / `property not verified`)*112- Google sees: {INDEXED|EXCLUDED|...} · canonical {userCanonical} {→ googleCanonical if differ} · last crawled {YYYY-MM-DD}113114## Page basics115- `<title>`: {value}116- meta description: {value | absent}117- `og:title`: {value | absent | skipped — Firecrawl required}118- `og:description`: {value | absent | skipped}119- `og:image`: {url | absent | skipped}120- `twitter:card`: {summary | summary_large_image | absent | skipped}121- `<link rel="canonical">`: {URL | self-referential | absent | skipped}122- meta robots: {index,follow | noindex,nofollow | absent | skipped}123- JSON-LD types detected: {Article, BreadcrumbList, Organization | none | skipped}124- hreflang variants: {n | skipped}125126## What this page wins127- {keyword} — position {n}, ~{volume} monthly searches, ~{traffic} monthly clicks.128- ... (top 3–5)129130## Almost-wins (page-2 refresh opportunities)131- {keyword} — position {n}, ~{volume} monthly searches. The top 3 SERP winners all do {pattern} that this page doesn't.132- ... (top 3 examples)133134## What this page misses135- {keyword} — competitors {comp1}, {comp2} rank in top 5; this page is absent.136- ...137138## Same-domain cannibalization139- {peer URL} — ranks position {n} for "{keyword}" (candidate ranks position {m}). Peer estimated traffic: {n}/mo.140- ... (only list rows where a peer URL ranks ≤ 20 for one of the candidate's top-3 keywords; if none, write "No same-domain cannibalization detected on top-3 keywords.")141142## AI Search angle143- {n} of {checked} AIO queries on the URL's keywords cite this page.144- The AIOs that DON'T cite this page tend to cite {pattern} (e.g., comparison tables, step-by-step how-tos).145- Recommended GEO move: {one specific change}.146147## Verdict: {KEEP | REFRESH | CONSOLIDATE | KILL}148149Reasoning: {1–2 sentences anchored in objective signals from above}.150151### If REFRESH — top 3 changes1521. {Specific change}1532. {Specific change}1543. {Specific change}155156## Raw data157- keywords.csv — full enriched ranking-keyword list158- 04-serp-context.md — per-keyword SERP top-10 with AIO159- evidence/05-page-snapshot.md — HTML extracts160```161162`keywords.csv` columns: `keyword,volume,kd,position,intent,traffic_estimate,url`163164## Tips165166- Respect SE Ranking Data API rate limit: 10 requests per second. The 3–5 SERP queries in step 5 should be paced sequentially.167- Call `DATA_getCreditBalance` before running. ~10–15 credits is typical for one URL.168- Verdict heuristic:169 - **KEEP**: PA stable or up; traffic stable or up; top 3 keywords held in their positions; AIO citations present where AIO appears.170 - **REFRESH**: any of (PA dropped >5 in 90 days; traffic dropped >20%; a top-3 keyword fell to position 11+; AIO citations missing while competitors get cited). **Hardens** when GSC data (step 4b) shows `INDEXED` + impressions > 100 + average position 4–10 (clear quick-win territory).171 - **CONSOLIDATE**: cannibalization detected (step 8) — a peer URL on the same domain ranks ≤ 20 for one or more of the candidate's top-3 keywords. CONSOLIDATE harden when the peer outranks the candidate AND captures higher traffic; otherwise CONSOLIDATE recommendation is "merge into the candidate" rather than "kill the candidate."172 - **KILL**: PA <10 AND traffic <50/mo AND no top-10 keyword AND no internal links pointing to it. **Hardens** when JSON-LD schema is also absent (Firecrawl detected zero blocks) — the page has no signals for any crawler, organic or AI. **Also hardens** when URL Inspection (step 4b) returns `EXCLUDED` for any reason.173 - **GSC canonical mismatch (any verdict):** if step 4b detects `userCanonical ≠ googleCanonical`, flag this as a critical issue in `PAGE.md` regardless of the verdict — it points at indexing instability that the verdict on its own can't resolve.174- Don't invent reasons. Anchor every claim in `PAGE.md` to a number from the raw data files.175- When between KEEP and REFRESH, default to REFRESH — small refreshes compound.176- The `keywords.csv` is the auditable trail. If a stakeholder questions the verdict, walk them through the CSV row by row.177- For pages with very low data (new pages, <5 ranking keywords), the verdict is unreliable. Flag as "insufficient data — re-run after 60 days" rather than forcing a verdict.178- **`DATA_getPageAuthorityHistory` all-zeros caveat:** if the endpoint returns `inlink_rank: 0` (or equivalent) for every date in the history window, treat as "insufficient history" — don't claim a drop or recommend REFRESH based on it. Often happens for very high-authority pages where the metric is saturated, or for URLs that haven't accumulated enough longitudinal data. Cross-check with `DATA_getPageAuthority` (current value) — if current PA is meaningful but history is flat-zero, flag the gap explicitly in `PAGE.md` rather than synthesising a trajectory.
seranking