AI SEO ops

Eessõna (jookseb oskuse käivitumisel)

# 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.

# 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.

# 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

# 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.

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.

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

Iganädalaselt: Käivita content_attack_brief.py täieliku luureraporti jaoks
Igapäevaselt: Käivita gsc_client.py --striking, et jälgida striking distance märksõnu
2× nädalas: Käivita trend_scout.py, et püüda trendivaid teemasid varakult
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

pip install -r requirements.txt

SEO-töö