E-kaubanduse SEO analüüs

Põhjalik tootelehtede optimeerimine, turuplatsi analüüs ja konkurentide hinnaanalüüs. Töötab iseseisvalt (lehesisene SEO + skeem) ning koos DataForSEO Merchant API-ga reaalajas Google Shoppingu ja Amazoni andmete jaoks.

Käsud

Käsk	Eesmärk	DataForSEO?
`/seo ecommerce <url>`	Tootelehe või poe täielik e-kaubanduse SEO analüüs	Valikuline
`/seo ecommerce products <keyword>`	Google Shoppingu konkurentsianalüüs	Nõutud
`/seo ecommerce gaps <domain>`	Märksõnalünk: orgaaniline vs Shoppingu nähtavus	Nõutud
`/seo ecommerce schema <url>`	Tooteskeemi valideerimine ja täiustamine	Ei

1. Tootelehe analüüs (DataForSEO-d pole vaja)

Laadi alla ja parsi mis tahes tooteleht, et hinnata lehesisese SEO kvaliteeti.

Töövoog

1. "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run render_page.py <url> --mode auto → raw/rendered HTML
2. "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run parse_html.py --url <url>   → SEO elements
3. Analyze product-specific signals (below)

Toote SEO kontrollnimekiri

Title-silt

[ ] Sisaldab toote põhimärksõna
[ ] Sisaldab brändi nime
[ ] Alla 60 tähemärgi (SERP-is ei lõigata ära)
[ ] Vorming: [Product Name] - [Key Feature] | [Brand]

Metakirjeldus

[ ] Sisaldab toote märksõna + kasu
[ ] Sisaldab hinda või „alates $XX“ (äratab rich snippet'i huvi)
[ ] Tegevusele kutsuv üleskutse (CTA) olemas (Shop now, Buy, Free shipping)
[ ] Alla 155 tähemärgi

Pealkirjade struktuur

[ ] Üks H1, mis vastab toote põhinimele
[ ] H2-d järgmise jaoks: omadused, tehnilised andmed, arvustused, seotud tooted
[ ] Tootevariantide vahel pole dubleeritud H1-silte

Tootepildid

[ ] Alt-tekst sisaldab toote nime + eristavat omadust
[ ] Failinimed on kirjeldavad (mitte IMG_001.jpg)
[ ] Serveeritakse WebP-vormingus (JPEG-varuvariandiga)
[ ] Vähemalt 3 pilti toote kohta (põhipilt, detail, elustiil)
[ ] Pildi mõõtmed >= 800px Google Shoppingu sobivuse jaoks
[ ] Laisk laadimine (lazy loading) ainult lehe nähtavast osast allpool olevatel piltidel

Sisemine linkimine

[ ] Leivapuru-navigatsioon: Avaleht > Kategooria > Alamkategooria > Toode
[ ] Seotud toodete jaotis (ristmüük / lisamüük)
[ ] Tagasilink kategoorialehele märksõnarikka ankrutekstiga
[ ] Arvustuste jaotis lingib täielikule arvustuste lehele (kui see on eraldi)

Sisu kvaliteet

[ ] Unikaalne tootekirjeldus (mitte tootja tekst kopeeri-kleebi)
[ ] Tootekirjelduse põhiosas >= 200 sõna
[ ] Tehniliste andmete tabel olemas (mitte ainult proosa)
[ ] Kasutajate arvustused lehel (UGC-signaalid)

Hindamine

Kategooria	Kaal	Kriteeriumid
Skeemi täielikkus	25%	Nõutud + soovitatud Producti väljad
Title ja meta	15%	Märksõna paiknemine, pikkus, vorming
Piltide optimeerimine	20%	Alt-tekst, vorming, suurus, arv
Sisu kvaliteet	20%	Unikaalne kirjeldus, tehnilised andmed, arvustused
Sisemine linkimine	10%	Leivapuru, seotud tooted, kategooriad
Tehniline	10%	Lehe kiirus, mobiilne renderdamine, canonical

2. Google Shoppingu analüüs (DataForSEO Merchant API)

Reaalajas konkurentsianalüüs Google Shoppingu tulemuste põhjal.

Kulupiire (KOHUSTUSLIK)

Enne IGAT Merchant API kutset:

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py check merchant_google_products_search

"status": "approved" -- jätka
"status": "needs_approval" -- näita kulu, küsi kasutajalt
"status": "blocked" -- peatu, teavita kasutajat

Pärast iga kutset:

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py log merchant_google_products_search <cost>

Töövoog

# Product search: who sells what at what price
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_merchant.py search "<keyword>" --marketplace google

# Seller analysis: merchant ratings and dominance
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_merchant.py sellers "<keyword>"

# Normalize results for analysis
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_normalize.py results.json --module merchant

Analüüsi väljundid

Hinnaanalüüs

Hindade jaotus: min, max, mediaan, P25, P75
Hinna erindid (> 2 standardhälvet mediaanist)
Hinna ja hinnangu korrelatsioon
Valuuta normaliseerimine USD-ks (või kasutaja määratud valuutaks)

Müüjate maastik

10 suurimat müüjat kuulutuste arvu järgi
Kaupmeeste hinnangute jaotus
Tasuta saatmise levimus
Uued vs väljakujunenud müüjad

Tootekuulutuste kvaliteet

Pealkirjade märksõnamustrid tippkuulutustes
Keskmise hinnangu ja arvustuste arvu võrdlusnäitajad
Piltide arv kuulutuse kohta
Saadavuse staatuse jaotus

Täielike API parameetrite üksikasjade jaoks laadi references/marketplace-endpoints.md.

3. Amazoni turuplats (DataForSEO)

Turuplatsiülene analüüs, mis võrdleb Google Shoppingut ja Amazoni.

Kulupiire (KOHUSTUSLIK)

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py check merchant_amazon_products_search

Amazoni lõpp-punktid on hulgas warn_endpoints -- need nõuavad alati kasutaja heakskiitu.

Töövoog

# Amazon product search
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_merchant.py search "<keyword>" --marketplace amazon

# Cross-marketplace comparison
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_merchant.py compare "<keyword>"

Turuplatsiülene aruanne

Mõõdik	Google Shopping	Amazon
Keskmine hind	$	$
Mediaanhinnang	X.X	X.X
Keskmine arvustuste arv	N	N
Tippmüüja osakaal	%	%
Tasuta saatmise %	%	%

4. Turuplatsi märksõnalüngad

Tuvasta lahknevused orgaanilise ja Shoppingu nähtavuse vahel.

Töövoog

Hangi orgaanilised positsioonid seo-dataforseo kaudu: dataforseo_labs_google_ranked_keywords domeeni jaoks
Hangi Google Shoppingu kohalolek Merchant API kaudu: merchant_google_products_search orgaaniliste tippmärksõnade jaoks
Võrdle tulemusi ristiti

Lünkade tüübid

Lünga tüüp	Tähendus	Tegevus
Ainult orgaaniline	On orgaaniliselt positsioonil, kuid Shoppingu reklaame pole	Loo Google Merchant Centeri voog, tee pakkumisi nendele märksõnadele
Ainult Shopping	Shoppingus nähtav, kuid orgaaniliselt nõrk/puudub	Loo nende märksõnade jaoks sisu (ostujuhendid, võrdluslehed)
Mõlemas olemas	Nähtav mõlemas kanalis	Optimeeri: taga hindade järjepidevus, täienda skeemi
Kummaski pole	Nähtavus puudub mõlemas	Madal prioriteet, kui otsingumaht pole suur

Väljundi vorming

## Keyword Gap Analysis: example.com

### Opportunities: Organic → Shopping (12 keywords)
| Keyword | Organic Pos | Volume | CPC | Recommended Action |
|---------|------------|--------|-----|-------------------|

### Opportunities: Shopping → Organic (8 keywords)
| Keyword | Shopping Rank | Volume | CPC | Content Type Needed |
|---------|-------------|--------|-----|-------------------|

5. Tooteskeemi täiustamine

Valideeri ja genereeri Product-skeem vastavalt Google'i kehtivatele nõuetele.

Kinnitatud nõutud omadused (Google Merchant)

Kinnitatud nõutud väljad on name, image ja offers; kaupmehe kuulutuste puhul kasuta Offer, mitte AggregateOffer.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "",
  "image": [""],
  "offers": {
    "@type": "Offer",
    "url": "",
    "priceCurrency": "USD",
    "price": "0.00",
    "availability": "https://schema.org/InStock"
  }
}

Soovitatud omadused (rikkalike tulemuste täiustamiseks)

sku -- toote identifikaator
description, brand, offers.seller -- soovitatud kontekstiväljad
gtin13 / gtin14 / mpn -- globaalsed kaubandusidentifikaatorid
aggregateRating -- tähehinnang + arvustuste arv
review -- üksikarvustused (vähemalt 1)
color, material, size -- variandi atribuudid
shippingDetails -- ShippingDetails koos hinna ja tarneajaga (toetatud on ka kaupmehe tasemel saatmine ShippingService kaudu; saatmise/tagastuse saab seadistada Search Console'is ilma Merchant Centeri kontota)
hasMerchantReturnPolicy -- MerchantReturnPolicy koos tüübi ja päevade arvuga
hasAdultConsideration -- nõutud täiskasvanutele suunatud toodete puhul (lisatud 2026-05-20 Product variant / Merchant listing alla); Google Search toetab ainult väärtust https://schema.org/SexualContentConsideration
category -- Text, CategoryCode või mõlemat segav massiiv. Kasuta kaupmehe määratud tootetüüpide jaoks kohandatud teksti ning Google Product Categories jaoks CategoryCode-i koos Google'i taksonoomia URL-i ja codeValue-ga.

Valideerimisreeglid

price peab olema numbriline string, mitte „$29.99“ (ilma valuutasümbolita)
availability peab kasutama täielikku Schema.org URL-i enum-väärtust
image peaks olema massiiv, milles on >= 1 kõrge eraldusvõimega pildi URL
priceCurrency peab olema ISO 4217 järgi (USD, EUR, GBP)
Kui brand on olemas, ei tohi brand.name olla tühi ega „N/A“
Soodusperioodid kasutavad validFrom-i ning kas validThrough-d või priceValidUntil-i ISO 8601 vormingus. Lisa kellaaeg ja ajavöönd, kui need on teada.
Kui aggregateRating on olemas: ratingValue ja reviewCount on nõutud
Ära lisa nähtavasse sisusse ega struktureeritud andmetesse võltsarvustusi ega avalikustamata soodustustega arvustusi. Avalikusta soodustused selgelt ja nähtavalt.

Skeemi hindamine

Täielikkus	Skoor
Kõik nõutud väljad	50/100
+ aggregateRating	65/100
+ sku/gtin/mpn	75/100
+ shippingDetails	85/100
+ merchantReturnPolicy	90/100
+ arvustused (3+)	100/100

Oskustevaheline integratsioon

Oskus	Integratsioonipunkt
seo-schema	Delegeerib Product-skeemi genereerimise; taaskasutab valideerimisloogikat
seo-images	Tootepiltide audit (alt-tekst, vorming, mõõtmed) ning `DigitalSourceType: TrainedAlgorithmicMedia` IPTC-silt tehisaru loodud tootepiltidele (Merchant Centeri nõue)
seo-content	Tootekirjelduse E-E-A-T ja unikaalsuse analüüs
seo-dataforseo	Orgaanilised märksõnapositsioonid lünkade analüüsiks
seo-technical	Core Web Vitals tootelehtede jaoks (LCP põhipildil)
seo-hreflang	Piirkonnapõhised tulemusüksused: tootepäringud EMP-s, Lõuna-Aafrikas ja Türgis võivad näidata tarnijaüksusi ja karusselle, millel on oma sobivusreeglid (dokumenteeritud 2026-09-08)
seo-google	GSC indekseerimise + Performance'i andmed toote-URL-ide jaoks (MITTE Merchant Centeri voo valideerimine, see tehakse Merchant Centeris / Merchant API-s; vana Content API for Shopping lõpetab töö 2026-08-18)

UCP: Universal Commerce Protocol (kasutusel)

Google'i algatatud avatud standard (välja töötatud koos Shopify, Etsy, Wayfairi, Targeti ja Walmartiga; maksepartnerid Visa/Mastercard/Stripe/Adyen/Amex), mis võimaldab tehisaru agentidel kaupmehi leida, nendega läbi rääkida ja tehinguid teha ilma ühekordsete integratsioonideta. Google kinnitab esimest näidisrakendust vestluspõhiseks ostmiseks Searchi AI Mode'is. Laiema Universal Carti kasutuselevõtu üksikasjad pärinevad Google I/O 2026 põhiettekande kajastustest; Google'ile kuuluvas allikas pole neid kinnitatud. ucp.dev märgib 2026-04-08 viimase väljalaskena oma kuupäevapõhises versioonimisskeemis, mitte 1.0; integreerimiseks on kaks teed: Native (vaikimisi) ja Embedded (heakskiidetud kaupmehed). Seotud AP2-ga (liigub väidetavalt FIDO juhtimise alla). Kanoonilised allikad: developers.google.com/merchant/ucp ja ucp.dev.

Kaupmehed, kes on juba Google Merchant Centeris ja kellel on korrektne Product-skeem, saavad deklareerida UCP profiili aadressil /.well-known/ucp, loetledes võimekused (dev.ucp.shopping.checkout, .fulfillment, .discount). Auditikriteeriumid, võimekuste näited ja seose AP2-ga (Agent Payments Protocol) leiad failist references/ucp-universal-commerce-protocol.md.

Auditikäsk

# Discover and validate the UCP profile
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run ucp_check.py https://store.example.com --json

# With endpoint reachability probes (HEAD each declared capability)
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run ucp_check.py https://store.example.com --probe-endpoints --json

Skript tagastab: profiili olemasolu, versiooni, deklareeritud võimekused, struktuursed probleemid (puuduvad väljad, tundmatud võimekuste ID-d) ja (koos --probe-endpoints-ga) iga lõpp-punkti kättesaadavuse. SSRF-i tõttu blokeeritud lõpp-punktidest teatatakse eraldi. Puuduvast profiilist teatatakse kui võimalusest, mitte veast. UCP ise on kasutusel; varajases faasis on alles kaupmeeste laiem kasutuselevõtt. Märgi sõnasõnaline "version": "1.0" kehtetuks (UCP versioonid on kuupäevapõhised, nt 2026-04-08).

Veakäsitlus

Viga	Põhjus	Reaktsioon
Product-skeemi ei leitud	Lehel puudub JSON-LD	Analüüsi lehe sisu, genereeri soovitatud skeem
DataForSEO mandaadid puuduvad	Keskkonnamuutujad pole seadistatud	Tee analüüs ilma turuplatsi andmeteta, märgi piirang
Kulukontroll blokeeritud	Päevaeelarve ületatud	Teavita kasutajat, paku ainult tasuta analüüsi
Tühjad Shoppingu tulemused	Märksõna jaoks tooteid pole	Soovita laiemat märksõna, kontrolli asukohaseadeid
Amazoni API aegumine	Võrgu-/päringupiirang	Proovi uuesti järkjärgulise ooteajaga, lange tagasi ainult Google'ile
Kehtetu URL	Vigane sisend	Valideeri `google_auth.validate_url()` abil, näita viga
Mittetooteleht	URL on kategooria/avaleht	Tuvasta lehe tüüp, soovita selle asemel `/seo ecommerce schema`

Väljundi mall

## E-commerce SEO Report: [URL or Keyword]

### Overall Score: XX/100

### Product Page SEO
- Schema Completeness: XX/100
- Title & Meta: XX/100
- Image Optimization: XX/100
- Content Quality: XX/100
- Internal Linking: XX/100

### Marketplace Intelligence (if DataForSEO available)
- Google Shopping Listings: N products found
- Price Range: $XX - $XX (median: $XX)
- Top Seller: [name] (XX% market share)
- Amazon Comparison: [available/not checked]

### Top Recommendations
1. [Critical] ...
2. [High] ...
3. [Medium] ...

Generate a PDF report? Use `/seo google report`

E-poe SEO

E-kaubanduse SEO analüüs

Käsud

1. Tootelehe analüüs (DataForSEO-d pole vaja)

Töövoog

Toote SEO kontrollnimekiri

Title-silt

Metakirjeldus

Pealkirjade struktuur

Tootepildid

Sisemine linkimine

Sisu kvaliteet

Hindamine

2. Google Shoppingu analüüs (DataForSEO Merchant API)

Kulupiire (KOHUSTUSLIK)

Töövoog

Analüüsi väljundid

Hinnaanalüüs

Müüjate maastik

Tootekuulutuste kvaliteet

3. Amazoni turuplats (DataForSEO)

Kulupiire (KOHUSTUSLIK)

Töövoog

Turuplatsiülene aruanne

4. Turuplatsi märksõnalüngad

Töövoog

Lünkade tüübid

Väljundi vorming

5. Tooteskeemi täiustamine

Kinnitatud nõutud omadused (Google Merchant)

Soovitatud omadused (rikkalike tulemuste täiustamiseks)

Valideerimisreeglid

Skeemi hindamine

Oskustevaheline integratsioon

UCP: Universal Commerce Protocol (kasutusel)

Auditikäsk

Veakäsitlus

Väljundi mall