# Seo Performance Tracker

> >

- **Type:** Skill
- **Install:** `agentstack add skill-siddiqss-semantic-seo-suite-seo-performance-tracker`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [siddiqss](https://agentstack.voostack.com/s/siddiqss)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [siddiqss](https://github.com/siddiqss)
- **Source:** https://github.com/siddiqss/semantic-seo-suite/tree/main/skills/seo-performance-tracker

## Install

```sh
agentstack add skill-siddiqss-semantic-seo-suite-seo-performance-tracker
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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 `url`s 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
   ```

2. **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.

3. **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](https://github.com/siddiqss)
- **Source:** [siddiqss/semantic-seo-suite](https://github.com/siddiqss/semantic-seo-suite)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-siddiqss-semantic-seo-suite-seo-performance-tracker
- Seller: https://agentstack.voostack.com/s/siddiqss
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.