--- title: SEO-audit description: Terve veebilehe SEO-audit: roomab kuni 500 lehte, tuvastab ärivaldkonna ja jagab analüüsi osadeks. category: Marketing sublabel: SEO author: AgriciDaniel tags: license: MIT source: https://github.com/AgriciDaniel/claude-seo --- # Täielik veebisaidi SEO-audit ## Protsess 1. **Renderda avaleht**: kasuta `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run render_page.py --mode auto --json`, et jäädvustada toor-HTML, renderdatud HTML, ekstraheeritud tekst, SPA-olek ja vajadusel juurdepääsetavuse andmed 2. **Tuvasta ärikategooria**: analüüsi avalehe signaale SEO orkestraatori järgi 3. **Indekseeri sait**: järgi sisemisi linke kuni 500 lehte, austa robots.txt-i 4. **Delegeeri alamagentidele** (kui saadaval, muidu jooksuta järjest sisse): - `seo-technical` -- robots.txt, saidikaardid, kanoonilised, Core Web Vitals, turbepäised - `seo-content` -- E-E-A-T, loetavus, õhuke sisu, AI-tsiteerimisvalmidus - `seo-schema` -- tuvastus, valideerimine, genereerimise soovitused - `seo-sitemap` -- struktuuri analüüs, kvaliteediväravad, puuduvad lehed - `seo-performance` -- LCP, INP, CLS mõõtmised - `seo-visual` -- ekraanipildid, mobiilitestid, voldiülese ala analüüs - `seo-geo` -- AI-indekseerija juurdepääs, llms.txt, tsiteeritavus, brändimainingu signaalid - `seo-local` -- GBP-signaalid, NAP-järjepidevus, arvustused, kohalik skeem, valdkonnaspetsiifilised kohalikud tegurid (käivita, kui tuvastatakse kohaliku teenuse valdkond: kivi-ja-mört, SAB või hübriidne ärikategooria) - `seo-maps` -- geo-võrgustiku asetuste jälgimine, GBP-audit, arvustusintelligents, konkurentide raadiuse kaardistamine (käivita, kui tuvastatakse kohalik teenus JA DataForSEO MCP on saadaval) - `seo-google` -- CWV välijandmed (CrUX), URL-indekseerimine (GSC), orgaaniline liiklus (GA4) (käivita, kui tuvastatakse Google API mandaadid `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_auth.py --check` kaudu) - `seo-backlinks` -- tagasilingi profiili andmed: DA/PA, viitavad domeenid, ankurtekst, toksilised lingid (käivita, kui tuvastatakse Moz või Bing API mandaadid `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run backlinks_auth.py --check` kaudu, või kaasa alati Common Crawli domeenitasemel mõõdikud) - `seo-cluster` -- semantilise klasterdamise analüüs (käivita, kui tuvastatakse sisustrateegia signaalid: blogi, sambalehed, teemaklastrid) - `seo-sxo` -- otsingukogemuse analüüs: lehetüübi mittevastavus, kasutajalood, persoonade skoorimine (kaasa alati täisauditites) - `seo-drift` -- triivi analüüs: võrdle salvestatud lähtetasemega (käivita, kui URL-ile on olemas triivi lähtetase `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run drift_history.py ` kaudu) - `seo-ecommerce` -- toote skeem, kauplemiskoha intelligents (käivita, kui tuvastatakse e-kaubanduse valdkond) 5. **Skoori** -- liida kokku SEO terviseskooriks (0-100) 6. **Säilita auditi artefaktid** -- kirjuta kõik väljundid kausta `{domain}-audit/` alla 7. **Raporteeri** -- loo prioriteedistatud tegevuskava ja valikuline PDF/HTML-raport ## Indekseerimise konfiguratsioon ``` Max pages: 500 Respect robots.txt: Yes Follow redirects: Yes (max 3 hops) Timeout per page: 30 seconds Concurrent requests: 5 Delay between requests: 1 second ``` ## Väljundfailid - `{domain}-audit/FULL-AUDIT-REPORT.md`: põhjalikud leiud - `{domain}-audit/ACTION-PLAN.md`: prioriteedistatud soovitused (kriitiline > kõrge > keskmine > madal) - `{domain}-audit/audit-data.json`: struktureeritud auditiümbrik raporti genereerimiseks - `{domain}-audit/findings/*.md`: kategooriapõhised spetsialisti leiud (`technical.md`, `content.md`, `schema.md`, `performance.md`, `visual.md` jne) - `{domain}-audit/screenshots/`: töölaua + mobiili jäädvustused (kui Playwright on saadaval) - **PDF-raport** (soovitatav): loo professionaalne A4 PDF käsuga `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_report.py --type full --data {domain}-audit/audit-data.json --domain --output-dir {domain}-audit/`. See toodab valge kaanega ettevõtteraporti sisukorra, kokkuvõtte, graafikute (Lighthouse'i mõõdikud, päringutulbad, indeksi sõõrik), mõõdikukaartide, lävitabelite, prioriteedistatud soovituste koos töömahuhinnangutega ja teostuskavaga. Paku alati pärast auditi lõpetamist PDF-i genereerimist. ## Struktureeritud auditiandmete ümbrik Kirjuta `{domain}-audit/audit-data.json` selles kujus, et `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_report.py --type full --data {domain}-audit/audit-data.json --domain --output-dir {domain}-audit/` saaks genereerida raporti ka siis, kui Google API andmed pole saadaval: ```json { "summary": { "health_score": 0, "business_type": "detected type", "top_findings": [], "quick_wins": [] }, "categories": [ { "name": "Technical SEO", "score": 0, "what_works": [], "findings": [ { "title": "Finding title", "severity": "Critical|High|Medium|Low|Info", "description": "Evidence-backed detail", "recommendation": "Specific fix" } ] } ], "action_plan": { "phases": [ {"name": "Phase 1: Critical Fixes", "timeframe": "Week 1", "items": []}, {"name": "Phase 2: High-Impact Improvements", "timeframe": "Weeks 2-3", "items": []}, {"name": "Phase 3: Content & Authority", "timeframe": "Month 2", "items": []}, {"name": "Phase 4: Monitoring & Iteration", "timeframe": "Ongoing", "items": []} ] }, "artifacts": { "findings_dir": "findings/", "screenshots_dir": "screenshots/" } } ``` ## Skoorimise kaalud | Kategooria | Kaal | |----------|--------| | Tehniline SEO | 22% | | Sisu kvaliteet | 23% | | Lehesisene SEO | 20% | | Skeem / struktureeritud andmed | 10% | | Jõudlus (CWV) | 10% | | AI-otsinguvalmidus | 10% | | Pildid | 5% | ## Raporti struktuur ### Kokkuvõte - Üldine SEO terviseskoor (0-100) - Tuvastatud ärikategooria - 5 peamist kriitilist probleemi - 5 peamist kiiret võitu ### Tehniline SEO - Indekseeritavuse probleemid - Indekseerimise probleemid - Turbemured - Core Web Vitals'i olek ### Sisu kvaliteet - E-E-A-T hinnang - Õhukese sisuga lehed - Dubleeriva sisu probleemid - Loetavuse skoorid ### Lehesisene SEO - Pealkirjasildi probleemid - Metakirjelduse probleemid - Pealkirjastruktuur - Sisemiste linkide lüngad ### Skeem ja struktureeritud andmed - Praegune teostus - Valideerimisvead - Kasutamata võimalused ### Jõudlus - LCP, INP, CLS skoorid - Ressursside optimeerimise vajadused - Kolmandate osapoolte skriptide mõju ### Pildid - Puuduv alt-tekst - Ülemõõdulised pildid - Vorminguga seotud soovitused ### AI-otsinguvalmidus - Tsiteeritavuse skoor - Struktuurilised parandused - Autoriteedisignaalid ## Prioriteetide määratlused - **Kriitiline**: blokeerib indekseerimise või põhjustab karistusi (paranda kohe) - **Kõrge**: mõjutab oluliselt asetusi (paranda 1 nädala jooksul) - **Keskmine**: optimeerimisvõimalus (paranda 1 kuu jooksul) - **Madal**: tore, kui on (ootejärjekord) ## DataForSEO integratsioon (valikuline) Kui DataForSEO MCP-tööriistad on saadaval, käivita olemasolevate alamagentide kõrval `seo-dataforseo` agent, et rikastada auditit reaalajaandmetega: tegelikud SERP-positsioonid, tagasilingi profiilid koos rämpsuskooridega, lehesisene analüüs (Lighthouse), ettevõtte kirjed ja AI-nähtavuse kontrollid (ChatGPT scraper, LLM-mainingud). ## Google API integratsioon (valikuline) Kui Google API mandaadid on seadistatud (`"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_auth.py --check`), käivita `seo-google` agent, et rikastada auditit tegelike Google välijandmetega: CrUX Core Web Vitals (asendab vaid laborihinnangud), GSC URL-indekseerimise olek, otsingu jõudlus (klikid, näitamised, CTR) ja GA4 orgaanilise liikluse trendid. Jõudluse (CWV) kategooria skoor saab välijandmetest kõige rohkem kasu. ## Vigade käsitlemine | Stsenaarium | Tegevus | |----------|--------| | URL kättesaamatu (DNS-tõrge, ühendusest keeldumine) | Raporteeri viga selgelt. Ära arva saidi sisu. Soovita kasutajal URL üle kontrollida ja uuesti proovida. | | robots.txt blokeerib indekseerimise | Raporteeri, millised teed on blokeeritud. Analüüsi ainult juurdepääsetavaid lehti ja märgi piirang raportis. | | Kiiruse piiramine (429-vastused) | Taandu ja vähenda samaaegseid päringuid. Raporteeri osalised tulemused märkega, milliseid sektsioone ei õnnestunud lõpetada. | | Ajalõpp suurtel saitidel (500+ lehte) | Piira indekseerimine ajalõpu piiriga. Raporteeri indekseeritud lehtede leiud ja hinda saidi kogumahtu. | | Alamagent jõuab suurel saidil oma `maxTurns` eelarveni | Leiud ei lähe kaotsi: iga auditi alamagent kirjutab pärast esimest analüüsikäiku osalise `output_dir/findings/*.md` ja kirjutab selle enne lõpetamist täielike leidudega üle. Loe olemasolev leidude fail ja liida see raportisse, märkides, et see võib olla osaline. |