---
title: SEO-töö
description: Eric Siu oskus SEO-töö korraldamiseks.
category: Marketing
sublabel: Strateegia
author: Eric Siu
tags: 
license: MIT
source: https://github.com/ericosiu/ai-marketing-skills
---

# AI SEO ops

## Eessõna (jookseb oskuse käivitumisel)

```bash
# Version check (silent if up to date)
python3 telemetry/version_check.py 2>/dev/null || true

# Telemetry opt-in (first run only, then remembers your choice)
python3 telemetry/telemetry_init.py 2>/dev/null || true
```

> **Privaatsus:** See oskus logib kasutust kohalikult kataloogi `~/.ai-marketing-skills/analytics/`. Kaugtelemeetria on ainult opt-in. Koodi, failiteid ega repo sisu ei koguta kunagi. Vt `telemetry/README.md`.

---

Tehisaru toel SEO operatsioonid: märksõnade luure, konkurentide lünkade analüüs, GSC optimeerimine ja trendituvastus.

## Millal kasutada

- Kasutaja palub märksõnauuringut, sisubriefi või SEO analüüsi
- Kasutaja tahab leida kiire võidu märksõnu Google Search Console'ist
- Kasutaja vajab konkurentide lünkade analüüsi
- Kasutaja tahab tuvastada trendivaid teemasid sisuloomeks
- Kasutaja küsib laguneva sisu või liikluse languste kohta
- Kasutaja tahab prioriseeritud märksõnade nimekirja sihtimiseks

## Tööriistad

### Content Attack Brief (`content_attack_brief.py`)

Täielik märksõnade luure torujuhe. Nõuab `AHREFS_TOKEN`-it ja GSC autentimist.

```bash
# Run the full brief
python content_attack_brief.py
```

**Mida see toodab:**
- Teemaväljatrükk sinu sisuraamatukogust
- BOFU raha märksõnad järjestatud Impact × Confidence järgi
- Trendivad märksõnad sparkline visualiseeringutega
- Konkurentide lünkade analüüs (märksõnad, millel nemad järjestuvad, sina mitte)
- Lagunevate lehtede hoiatused (liikluse langused >30%)
- Täitmise torujuhe (auto-create → semi-auto → team)

**Väljund:** Prindib vormindatud raporti stdout'i + salvestab JSON-i `OUTPUT_DIR/content-attack-brief-latest.json`

### GSC Client (`gsc_client.py`)

Google Search Console API klient. Töötab CLI-na või imporditava teegina.

```bash
# CLI usage
python gsc_client.py --queries 50 --days 28
python gsc_client.py --striking                    # Striking distance keywords (pos 4-20)
python gsc_client.py --pages 100 --days 7
python gsc_client.py --trend                       # Daily click/impression trend
python gsc_client.py --devices                     # Mobile vs desktop split
python gsc_client.py --sites                       # List verified properties
python gsc_client.py --json --queries 25           # JSON output
```

```python
# Library usage
from gsc_client import GSCClient

gsc = GSCClient()
rows = gsc.striking_distance(days=28, min_position=4, max_position=20)
for row in rows:
    print(f"{row['keys'][0]}: pos {row['position']:.1f}, {row['impressions']} impressions")
```

### GSC Auth (`gsc_auth.py`)

Ühekordne OAuth seadistus Google Search Console'i juurdepääsuks.

```bash
python gsc_auth.py
# Opens browser → Google Sign-In → saves token locally
```

### Trend Scout (`trend_scout.py`)

Mitmeallikaline trendituvastus. Põhifunktsionaalsuseks API võtmeid pole vaja.

```bash
python trend_scout.py
```

**Allikad:** Google Trends RSS, Hacker News, Reddit, X/Twitter (vajab `BRAVE_API_KEY`), YouTube'i outlier'ite tuvastus

**Väljund:** Prindib kokkuvõtte + salvestab JSON-i `OUTPUT_DIR/flash-trends-latest.json` ja markdown-raporti.

## Konfiguratsioon

Kõik skriptid loevad keskkonnamuutujatest. Kopeeri `.env.example` failiks `.env` ja täida väärtused.

Kohustuslik:
- `GSC_SITE_URL` — sinu Google Search Console'i atribuudi URL
- `GOOGLE_CLIENT_ID` / `GOOGLE_CLIENT_SECRET` — GSC OAuth'iks
- `YOUR_DOMAIN` — sinu juurdomeen

Valikuline:
- `AHREFS_TOKEN` — lubab Ahrefsi märksõnaandmed ja konkurendianalüüsi
- `COMPETITORS` — komadega eraldatud konkurentide domeenid
- `BRAVE_API_KEY` — lubab X/Twitteri trendide skänni
- `CONTENT_VERTICALS` — komadega eraldatud teemad trendide relevantsuse skoorimiseks
- `TREND_SUBREDDITS` — komadega eraldatud subredditid jälgimiseks

## Skoorimismudel

Märksõnu hinnatakse kahel teljel:

**Impact (0–10):** Maht + CPC + lehtri etapp + trendi suund
**Confidence (0–10):** Keyword Difficulty + praegune järjestuskoht + teemaautoriteet

**Priority = Impact × Confidence** (maks 100)

## Lehtri klassifikatsioon

- **BOFU:** Kaubanduslik/tehinguline intent või märksõnad, mis sisaldavad „agency“, „services“, „pricing“, „best“, „vs“, „hire“
- **MOFU:** Informatiivne ostusignaalidega — „how to“, „guide“, „roi“, „case study“
- **TOFU:** Puhtalt informatiivne

## Soovitatud töövoog

1. **Iganädalaselt:** Käivita `content_attack_brief.py` täieliku luureraporti jaoks
2. **Igapäevaselt:** Käivita `gsc_client.py --striking`, et jälgida striking distance märksõnu
3. **2× nädalas:** Käivita `trend_scout.py`, et püüda trendivaid teemasid varakult
4. **Igakuiselt:** Vaata üle konkurentide lüngad ja kohanda `COMPETITORS` nimekirja

## SEO/AEO/GEO suletud ahel

Kasuta analüütika tagasivaateid enne mis tahes SEO, AEO, GEO või sisuvärskenduse playbook'i muudatuse edutamist.

Sisendid:
- GSC klikid, näitamised, CTR, keskmine positsioon, päringud, lehed
- GA4 sessioonid, kaasatud sessioonid, konversioonid, abistatud müügivihjed
- Ahrefsi järjestused, tagasilingid, liiklushinnangud, märksõnade liikumine
- ClickFlow võimalused, kus saadaval
- AI-otsingu / vastusemootori / GEO nähtavus, kus saadaval
- CMS/lehe muudatuste logi

Hinnang:
- Võrdle baasjoont kandidaatakendega.
- Segmenteeri lehe, päringu, teema, intenti ja allika järgi.
- Jälgi segavaid tegureid: hooajalisus, indekseerimise hilinemine, brändihüpped, kampaaniad, jälgimismuudatused ja mitteseotud saidimuudatused.

Edutamise reegel:
- Eduta playbook'i paik ainult siis, kui kandidaat ületab baasjoone või paljastab korratava signaali.
- Muidu märgi `unproven`, jätka testimist või tee rollback.

Tavalised tagasivaateaknad:
- Sisuvärskendus: 7, 14, 28 ja 56 päeva
- Uus sisu: 14, 28, 56 ja 90 päeva
- Tehniline SEO parandus: igapäevaselt 7 päeva, siis 28-päevane tagasivaade
- AEO/GEO nähtavus: iganädalaselt, sest vastusemootorid on mürarikkad gremlinid tsiteeringutega

Kohustuslikud tagasivaateväljad:
- tehtud muudatus
- omanik
- mõjutatud leht/päring/teema
- baasjoone aken
- kandidaadi aken
- tõmmatud alliksüsteemid
- peamised ja teisased mõõdikud
- erandid
- otsus: promote / keep testing / rollback / unproven
- järgmine playbook'i paik

## Sõltuvused

```bash
pip install -r requirements.txt
```