Seo Performance Tracker

seo-performance-tracker

The measured feedback loop. It replaces guesswork (and the fabricated "Pillar Page Rank" that wrapper tools invent) with real Search Console data joined to the topical map. Every figure is measured (GSC) or derived (rollups) — never estimated.

Read first: ../../framework/topical-map-theory.md (pillars/priority), ../../framework/query-semantics.md (query networks → new nodes).

Preconditions

• topical-map.json with urls on published nodes (the auditor sets these).
• GSC configured: grounding.sources.gsc: true + credentials.gsc_credentials_path.

If not configured, say so and do NOT invent metrics — spot-checking positions via web_search is unreliable; be explicit about that limitation.

Workflow

1. Pull GSC data:

`` python ../../scripts/gsc_client.py --site "" --creds \ --start --end --dims query,page \ --out brands//data/gsc/pull.json # optional prior period for decay: python ../../scripts/gsc_client.py ... --start --end \ --out brands//data/gsc/prev.json ``

1. Analyse against the map:

`` python ../../scripts/gsc_analyze.py --gsc brands//data/gsc/pull.json \ [--gsc-prev brands//data/gsc/prev.json] \ --map brands//topical-map.json --brand "" \ --out brands//audits/-performance.md `` Produces:

• Pillar rollups — impressions/clicks/avg-position per pillar (derived). The

honest Pillar Page Rank.

• Striking-distance — queries at position 5–15 → quick-win update targets.
• Measured cannibalization — one query landing on multiple pages (the strongest

cannibalization signal; confirms/ː refutes the auditor's embedding guess).

• Decaying pages — >30% click loss vs the prior period.
• Uncovered queries — GSC queries not in any node's query network → candidate new

map nodes.

1. Feed the loop:

• Add uncovered-query candidates to the map via topical-map-builder (as new nodes

or as query-network additions to existing nodes).

• Mark striking-distance and decaying nodes needs-update; push them up calendar.md.
• Send confirmed measured-cannibalization pairs to semantic-site-auditor /

linking-and-schema for consolidation/redirect.

Definition of done

• Performance report produced with all five sections, every figure provenance-tagged.
• Actionable next steps flowed back into map + calendar.
• If GSC isn't configured: an honest "not available" with the setup pointer, no invented

numbers.

Grounding ladder

• T1 (GSC): the whole skill — this is a T1 capability (GSC is free).
• Without GSC: the skill explains it can't measure performance reliably and points to

README GSC setup. It does not fabricate a substitute.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: siddiqss
• Source: siddiqss/semantic-seo-suite
• License: MIT

Install and usage instructions live in the source repository linked above.