---
title: Search Console'i portfelli audit
description: Auditeerib korraga kõiki Search Console'i kinnistuid ning järjestab saidid klikkide ja näitamiste järgi.
category: Marketing
sublabel: SEO
author: OpenClaudia
tags: 
license: MIT
source: https://github.com/OpenClaudia/openclaudia-skills
---

# GSC portfelli audit

Vastab küsimusele „kuidas kõigil läheb?“ üle iga atribuudi Search Console'i kontol — küsimus, mida saidipõhine tööriistastik ei saa vastata ilma kümnete käsitsi eksportideta.

## Seadistus

Vajab OAuth refresh tokenit õigusega `https://www.googleapis.com/auth/webmasters.readonly`:

```bash
export GOOGLE_GSC_CLIENT_ID=...      # or GOOGLE_CLIENT_ID
export GOOGLE_GSC_CLIENT_SECRET=...  # or GOOGLE_CLIENT_SECRET
export GOOGLE_REFRESH_TOKEN=...
export GSC_EXCLUDE="olddomain.com"   # optional, comma-separated
pip install requests
```

**Levinuim seadistusviga on `unauthorized_client` tokeni värskendamisel.** See tähendab, et refresh token väljastati teisele OAuth kliendile kui id/secret, millega sa selle paaristasid. Kontodel, mis on aja jooksul Google'i integratsioone lisanud, on tavaliselt mitu klienti; sobita paar, mis tokeni lõi.

## Käivita

```bash
python3 scripts/audit_gsc.py            # full: ranking + keyword diff for the top 12
python3 scripts/audit_gsc.py portfolio  # just the ranked table
python3 scripts/audit_gsc.py queries --site sc-domain:example.com
python3 scripts/audit_gsc.py --days 90  # quarter over quarter
```

Lipud: `--days` (aken, võrreldakse vahetult eelneva aknaga), `--site` (korduv), `--top`, `--limit`, `--min-clicks`.

## Jaotised ja nende tähendus

| Jaotis | Loe nii |
|---|---|
| NEW | päringud nulli klikiga eelmisel perioodil. Sealt tuleb tegelik kasv. |
| RISING | üles ≥50%. Kontrolli, kas ka positsioon liikus — kui ei, tõusis nõudlus, mitte sinu järjestus. |
| DROPPING | alla ≥40% reaalselt baasilt. **Positsioon ütleb, millist tüüpi:** koht langes = järjestuse kaotus; koht püsis, aga klikid kukkusid = midagi võttis klikid sinust eespool (AI Overview, uus SERP funktsioon või päringu kuju muutus). |
| LOST | järjestus enne, andmeid nüüd pole. |
| CTR GAP | ≥1500 näitamist, top 10, alla 2% CTR. Pealkirja ja kirjelduse ümberkirjutused — odavaimad võidud. |

## Tõlgendamine

- **Teata esmalt klikke, siis näitamisi.** Üks suur atribuut võib portfelli näitamisi nii palju kõigutada, et maskeerib teiste kasvu.
- **Eralda bränd ja mittebränd.** Sait, mille kogu märksõnakomplekt on oma nimi (või konkurendi kirjavead), ei oma omandamismootorit, ükskõik kui hea klikkide arv välja näeb. Ütle seda raportis otse.
- **Terve saidi kokkuvarisemine peamisel pealkirjaterminil pole tavaliselt SEO.** Kontrolli enne järjestuse diagnoosi omandiõigust: `whois <domain> | grep -i "registrar\|updated date"` ning kas see ikka laheneb. Aegunud, üle kantud või vaidlusalused domeenid tekitavad õpikunäite järjestuskukkumise, mida ükski SEO töö ei paranda.
- **„new“ portfelli tabelis tähendab nulli klikki eelmisel aknas**, mis äsja lansseeritud saidi puhul on lansseerimine, mitte andmeauk.
- **Ära jäta vahele päringuid keeltes, mida sa ei loe.** Mitme turu saitidel on kasv tavaliselt mitteinglise long-tail'is; tõlgi huvitavad, selle asemel et neid välja filtreerida.
- Atribuut, mis tagastab 403, on loendisse kinnitatud, aga mitte otsinguanalüütikasse. Skript teatab sellest, selle asemel et peita.

## Märkused

- GSC andmed hilinevad umbes 3 päeva; skript nihutab selle automaatselt.
- Mõlemad perioodid tõmmatakse atribuudi kohta paralleelselt, nii et 40 atribuudiga konto võtab sekundeid.
- Päringuread on piiratud 25 000-ga perioodi kohta — hästi üle selle, mida ükski üksiksait 28-päevase akna kohta tagastab.