---
title: E-poe SEO
description: E-kaubanduse SEO: Google Shoppingu nähtavus, Amazoni turuinfo ja tooteskeemide kontroll.
category: Marketing
sublabel: SEO
author: AgriciDaniel
tags: 
license: MIT
source: https://github.com/AgriciDaniel/claude-seo
---

# 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:
```bash
"${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:
```bash
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py log merchant_google_products_search <cost>
```

### Töövoog

```bash
# 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)

```bash
"${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

```bash
# 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

1. Hangi orgaanilised positsioonid seo-dataforseo kaudu:
   `dataforseo_labs_google_ranked_keywords` domeeni jaoks
2. Hangi Google Shoppingu kohalolek Merchant API kaudu:
   `merchant_google_products_search` orgaaniliste tippmärksõnade jaoks
3. 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`.

```json
{
  "@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

1. `price` peab olema numbriline string, mitte „$29.99“ (ilma valuutasümbolita)
2. `availability` peab kasutama täielikku Schema.org URL-i enum-väärtust
3. `image` peaks olema massiiv, milles on >= 1 kõrge eraldusvõimega pildi URL
4. `priceCurrency` peab olema ISO 4217 järgi (USD, EUR, GBP)
5. Kui `brand` on olemas, ei tohi `brand.name` olla tühi ega „N/A“
6. Soodusperioodid kasutavad `validFrom`-i ning kas `validThrough`-d või
   `priceValidUntil`-i ISO 8601 vormingus. Lisa kellaaeg ja ajavöönd, kui need on teada.
7. Kui `aggregateRating` on olemas: `ratingValue` ja `reviewCount` on nõutud
8. Ä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

```bash
# 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`
```