--- title: Piltide optimeerimine description: Kontrollib piltide alt-teksti, failimahtu, vorminguid ja kohanduvust. category: Marketing sublabel: SEO author: AgriciDaniel tags: license: MIT source: https://github.com/AgriciDaniel/claude-seo --- # Piltide optimeerimise analüüs ## Kontrollid ### Alt-tekst - Olemas kõigil `` elementidel (välja arvatud dekoratiivsed: `role="presentation"`) - Kirjeldav: kirjeldab pildi sisu, mitte „image.jpg“ või „foto“ - Sisaldab asjakohaseid märksõnu seal, kus see on loomulik, ilma märksõnadega üle kuhjamata - Pikkus: 10–125 tähemärki **Head näited:** - „Professionaalne torumees parandab köögivalamu segistit“ - „Punane 2024. aasta Toyota Camry sedaan eestvaates“ - „Meeskonna koosolek kaasaegse kontori nõupidamisruumis“ **Halvad näited:** - „image.jpg“ (failinimi, mitte kirjeldus) - „torumees torutööd torumehe teenused“ (märksõnadega üle kuhjamine) - „Klõpsa siia“ (pole kirjeldav) ### Failimaht **Astmelised lävendid pildikategooria järgi:** | Pildikategooria | Siht | Hoiatus | Kriitiline | |----------------|--------|---------|----------| | Pisipildid | < 50KB | > 100KB | > 200KB | | Sisupildid | < 100KB | > 200KB | > 500KB | | Hero-/bännerpildid | < 200KB | > 300KB | > 700KB | Soovita tihendamist sihtlävenditeni, kus see on võimalik ilma kvaliteedikaota. ### Vorming | Vorming | Brauseritugi | Kasutusjuht | |--------|-----------------|----------| | WebP | 97%+ | Vaikesoovitus | | AVIF | 92%+ | Parim tihendus, uuem | | JPEG | 100% | Varuvariant fotodele | | PNG | 100% | Läbipaistvusega graafika | | SVG | 100% | Ikoonid, logod, illustratsioonid | Soovita WebP/AVIF-i JPEG/PNG asemel. Kontrolli, kas on olemas `` element vormingu varuvariantidega. #### Soovitatav `` elemendi muster Kasuta progressiivset täiustamist, kõige tõhusam vorming esimesena: ```html Descriptive alt text ``` Brauser kasutab esimest toetatud vormingut. Praegune brauseritugi: AVIF 93,8%, WebP 95,3%. #### JPEG XL: esilekerkiv vorming Kolmandate osapoolte aruanded ja Wikipedia kirjeldavad, et Rustil põhinev JPEG XL dekooder on tarnitud Chrome 145 stabiilses versioonis (2026-02-10) lipu `chrome://flags/#enable-jxl-image-format` taga, vaikimisi mitte lubatuna; faktipaketti ei saadud ühtegi Google'ile kuuluvat kinnitust. Kuna vaiketugi pole kinnitatud, ei ole see veel tootmises veebi kaudu edastamiseks praktiline. Jätka AVIF/WebP serveerimist JPEG varuvariandiga ja jälgi olukorda. ### Responsiivsed pildid - `srcset` atribuut mitme suuruse jaoks - `sizes` atribuut, mis vastab paigutuse murdepunktidele - Sobiv eraldusvõime seadmete pikslisuhete jaoks ```html Description ``` ### Laisklaadimine - `loading="lazy"` voldist allpool olevatel piltidel - ÄRA laisklaadi voldist ülalpool olevaid/hero-pilte (kahjustab LCP-d) - Kontrolli, kas laisklaadimine on natiivne või JavaScriptil põhinev ```html Description Hero image ``` #### Tuvastatud laisklaadimise meetodid (väli `lazy_method`) `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run parse_html.py` liigitab iga pildi laisklaadimise mehhanismi iga pildikirje välja `lazy_method` kaudu. Viis väärtust: | `lazy_method` | Tuvastatud signaal | Tavaline tehnoloogiapinu | |---|---|---| | `native` | `loading="lazy"` HTML-atribuut | Kaasaegsed brauserid, lihtne HTML | | `perfmatters` | `data-perfmatters-src`/`-srcset` VÕI klass `perfmatters-lazy` | WordPress + Perfmatters plugin | | `ewww` | `data-ewww-src` / `data-eio` VÕI klass `lazyload-eio` | WordPress + EWWW Image Optimizer | | `js-generic` | `data-src` / `data-lazy-src` / `data-original` / `data-srcset` VÕI klass `lazyload`/`lazyloaded`/`lazy` | Lazysizes, vanilla-lazyload, jQuery pluginad | | `none` | Ei atribuudi ega klassi signaali | Leht ei laisklaadi seda pilti | Pildi-SEO auditeerimisel raporteeri `lazy_method` koos `loading`'uga, et kasutajad teaksid, kas nende sait kasutab JS-põhist laisklaadijat (sel juhul puudub natiivne `loading="lazy"` atribuut meelega, see ei ole regressioon). ### `fetchpriority="high"` LCP-piltidele Lisa oma hero-/LCP-pildile `fetchpriority="high"`, et prioriseerida selle allalaadimist brauseri võrgujärjekorras: ```html Hero image description ``` **Kriitiline:** ÄRA laisklaadi voldist ülalpool olevaid/LCP-pilte. `loading="lazy"` kasutamine LCP-piltidel kahjustab otseselt LCP-skoori. Jäta `loading="lazy"` ainult voldist allpool olevatele piltidele. ### `decoding="async"` mitte-LCP-piltidele Lisa mitte-LCP-piltidele `decoding="async"`, et pildi dekodeerimine ei blokeeriks põhilõime: ```html Description ``` ### CLS-i ennetamine - `width` ja `height` atribuudid on seatud kõigil `` elementidel - Alternatiivina `aspect-ratio` CSS - Märgi mõõtmeteta pildid ```html Description Description Description ``` ### Failinimed - Kirjeldavad: `blue-running-shoes.webp`, mitte `IMG_1234.jpg` - Sidekriipsudega, väiketähtedega, ilma erimärkideta - Sisaldavad asjakohaseid märksõnu ### CDN-i kasutus - Kontrolli, kas pilte serveeritakse CDN-ist (erinev domeen, CDN-i päised) - Soovita CDN-i piltiderohketele saitidele - Kontrolli servavahemälu (edge caching) päiseid ## Väljund ### Piltide auditi kokkuvõte | Mõõdik | Olek | Arv | |--------|--------|-------| | Pilte kokku | - | XX | | Puuduv alt-tekst | ❌ | XX | | Liiga suured (>200KB) | ⚠️ | XX | | Vale vorming | ⚠️ | XX | | Mõõtmed puuduvad | ⚠️ | XX | | Pole laisklaaditud | ⚠️ | XX | ### Prioriseeritud optimeerimisloend Sorteeritud failimahu mõju järgi (suurim sääst esimesena): | Pilt | Praegune maht | Vorming | Probleemid | Hinnanguline sääst | |-------|--------------|--------|--------|--------------| | ... | ... | ... | ... | ... | ### Soovitused 1. Teisenda X pilti WebP-vormingusse (hinnanguline sääst XX KB) 2. Lisa alt-tekst X pildile 3. Lisa mõõtmed X pildile 4. Luba laisklaadimine X voldist allpool oleval pildil 5. Tihenda X liiga suurt pilti --- ## Piltide SERP-analüüs Kui DataForSEO MCP on saadaval, täienda piltide auditit konkurentsiandmetega. ### `/seo images serp ` Võrdle lehel olevaid pilte Google Images SERP-i positsioonidega. **Töövoog:** 1. Too Google Images tulemused `serp_google_images_live_advanced` kaudu (depth=100) 2. Eralda: tippdomeenid, pilditüübid, alt-teksti mustrid 3. Väljasta konkurentide piltide SERP-maastik **Väljund:** | Positsioon | Domeen | Pealkiri/alt | Pildi URL | Lehe URL | |------|--------|-----------|-----------|----------| | 1 | example.com | "Blue running shoes..." | .../shoes.webp | /products/... | **Analüüs sisaldab:** - **Domeenide domineerimine**: millised saidid omavad kõige rohkem pildipositsioone (top 10 arvu järgi) - **Alt-teksti mustrid**: levinud pealkirja/alt-teksti mustrid kõrgel positsioonil olevatel piltidel - **Vormingute jaotus**: WebP vs JPEG vs PNG tipptulemustes - **Võimaluste skoor**: märksõnad, mille puhul sul on lehe positsioonid, kuid pildid puuduvad Kui DataForSEO MCP pole saadaval, teavita kasutajat ja soovita laienduse paigaldamist. --- ## Pildifailide optimeerimine Optimeeri pildifaile SEO jaoks: vormingu teisendamine, metaandmete lisamine, tihendamine. ### `/seo images optimize ` Optimeeri pildifail(e) veebi ja SEO jaoks. Teisendab WebP/AVIF-iks, lisab IPTC metaandmed, tihendab ja loob responsiivsed variandid. **Kasutatavad tööriistad (eelistuse järjekorras):** - `exiftool` -- EXIF/IPTC/XMP lugemine/kirjutamine (paigaldus: `sudo apt install libimage-exiftool-perl`) - `cwebp` -- WebP-teisendus (paigaldus: `sudo apt install webp`) - ImageMagick `convert` -- vormingu teisendamine, suuruse muutmine (enamikus süsteemides eelpaigaldatud) - FFmpeg -- varuvariant vormingu teisendamiseks (eelpaigaldatud) **Enne käivitamist:** kontrolli, millised tööriistad on saadaval, käsuga `which exiftool cwebp convert ffmpeg`. ### Vormingu teisendamine Teisenda pildid kaasaegsetesse vormingutesse metaandmeid säilitades: ```bash # WebP (recommended default) - with metadata preserved cwebp -q 82 -metadata all input.jpg -o output.webp # WebP via ImageMagick (fallback if cwebp not installed) convert input.jpg -quality 82 output.webp # AVIF via FFmpeg (slower encode, best compression) ffmpeg -i input.jpg -c:v libaom-av1 -crf 30 -still-picture 1 output.avif # Responsive variants (400w, 800w, 1200w) convert input.jpg -resize 400x -quality 82 image-400.webp convert input.jpg -resize 800x -quality 82 image-800.webp convert input.jpg -resize 1200x -quality 82 image-1200.webp ``` ### Metaandmete lisamine (IPTC Google Imagesis kuvamiseks) Google Images kuvab otsingutulemustes IPTC Creator, Credit Line ja Copyright väärtusi. See **EI OLE positsioneerimistegur**, kuid võib parandada Google Imagesis kuvamist ja brändi omistamist. **exiftooliga (eelistatud):** ```bash # Read all metadata exiftool image.jpg # Inject IPTC + XMP metadata for Google Images rich results exiftool \ -IPTC:ObjectName="Product Photo Description" \ -IPTC:Caption-Abstract="Detailed image description" \ -IPTC:By-line="Brand Name Photography" \ -IPTC:Credit="Brand Name" \ -IPTC:CopyrightNotice="Copyright 2026 Brand Name" \ -IPTC:Source="brandname.com" \ -XMP:Title="Product Photo Description" \ -XMP:Description="Detailed image description" \ -XMP:Creator="Brand Name Photography" \ -XMP:Rights="Copyright 2026 Brand Name" \ image.jpg # Batch inject to all images in directory exiftool -overwrite_original \ -IPTC:By-line="Brand Name" \ -IPTC:CopyrightNotice="Copyright 2026 Brand Name" \ *.jpg *.webp *.png ``` **ImageMagickuga (varuvariant):** ```bash identify -verbose image.jpg | head -50 convert input.jpg \ -set comment "Product Photo Description" \ -set IPTC:2:80 "Brand Name Photography" \ -set IPTC:2:116 "Copyright 2026 Brand Name" \ output.jpg ``` Märkus: WebP toetab EXIF-i ja XMP-d, kuid mitte natiivselt IPTC-d. WebP-failide puhul kasuta IPTC asemel XMP-välju. exiftool teeb selle teisenduse automaatselt. ### Tehisaruga loodud pildid: `DigitalSourceType` (Merchant Centeri nõue) Generatiivse tehisaru loodud tootepiltide puhul **nõuab Google Merchant Center** IPTC metaandmeid `DigitalSourceType: TrainedAlgorithmicMedia`. See on tegevuspõhimõtte nõue, mitte positsioneerimistegur: vood, kus see silt tehisaruga loodud piltidel puudub, võidakse tagasi lükata. Esmane allikas (Merchant Centeri tehisaruga loodud sisu põhimõtted): https://support.google.com/merchants/answer/14743464 (ai-optimization-guide ei dokumenteeri DigitalSourceType/IPTC/Merchanti märgistamist.) **Auditikäsk:** ```bash # Audit a directory for the IPTC label (counts: missing, ai, captured, etc.) "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run iptc_ai_label.py audit ./images/ --json # Audit a single image "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run iptc_ai_label.py audit ./hero.webp --json # Inject the AI label into an image "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run iptc_ai_label.py inject ./ai-hero.webp \ --source-type trainedAlgorithmicMedia # Other vocabulary values: # compositeSynthetic (mix of captured + AI elements) # algorithmicMedia (created purely by algorithm, NOT from sampled training data) # compositeWithTrainedAlgorithmicMedia (e.g. AI inpainting/outpainting over real media) # digitalCapture (fully captured photograph) ``` **Toored exiftooli vasted** (ühekordseks kasutuseks): ```bash # Inject manually exiftool \ -XMP-iptcExt:DigitalSourceType="https://cv.iptc.org/newscodes/digitalsourcetype/trainedAlgorithmicMedia" \ ai-generated-product.jpg # Audit: find images missing the label across a directory exiftool -if 'not $XMP-iptcExt:DigitalSourceType' \ -filename -DigitalSourceType *.jpg *.webp *.png ``` Google eraldab järgmised IPTC `DigitalSourceType` väärtused: - `trainedAlgorithmicMedia`: täielikult tehisaruga loodud (kasuta seda difusioonimudeliga loodud tootepiltide puhul) - `compositeSynthetic`: segab jäädvustatud ja tehisaruga loodud elemente - `algorithmicMedia`: loodud puhtalt algoritmi abil, **mitte** valimiga treeningandmete põhjal - `compositeWithTrainedAlgorithmicMedia`: treenitud algoritmilise meedia ja muu meedia liit (nt tehisaru inpainting/outpainting päris foto peal) - `digitalCapture`: täielikult jäädvustatud foto (märkus: `digitalCapture` **ei ole** Google'i eraldatavate väärtuste loendis, kuid on kehtiv IPTC väärtus) > **Päritolusignaalid (tarbijale suunatud):** **SynthID** vesimärgid ja **C2PA** > Content Credentials on esilekerkivad signaalid tehisaru meedia tuvastamiseks. Käsitle > tootepindade katvust muutuvana, kui seda pole kontrollitud värskest > Google'ile kuuluvast allikast. > See on tuvastamine/läbipaistvus, **mitte** täiendav kohustuslik Merchanti voo väli > lisaks IPTC DigitalSourceType'ile. > **Litsentsitavad pildid:** Licensable-märgi saamiseks esita KAS struktureeritud > andmed (`ImageObject` koos `license` omadusega + `acquireLicensePage` lingi > „Get this image“ jaoks) VÕI pildisse põimitud IPTC foto metaandmed (Licensor URL / Web > Statement of Rights). ImageObject märgenduse jaoks viita oskusele `seo-schema`. > **Avastamise märkus:** piltide avastamine hõlmab nüüd **visuaalse otsingu laiendamist (fan-out)** > üle Lensi / AI Mode'i / Circle to Searchi (Gemini multimodaalne stseeni/objekti > mõistmine), nii et pildid ilmuvad stseeni, objektide ja materjalide, mitte ainult alt- > teksti põhjal. Uut avaldatud pildi-SEO hooba veel pole; hoia kirjeldav alt-tekst + > puhtad struktureeritud andmed. Kui `/seo images optimize` käivitatakse tehisaruga loodud failidel, palu kasutajal kinnitada allika tüüp ja lisa vastav IPTC väärtus automaatselt. **Tehisaruga loodud tootepealkirjade ja -kirjelduste** puhul nõuab Google Merchant Center ka, et tehisaruga loodud tekst oleks voos eraldi määratud ja märgistatud. Seda jõustatakse voo, mitte lehe tasandil; märgi see ristviitena oskusega `seo-ecommerce`. ### Metaandmete audit ```bash # Quick audit with exiftool exiftool -IPTC:all -XMP:all -EXIF:ImageDescription image.jpg # Batch audit - find images missing IPTC Creator exiftool -if 'not $IPTC:By-line' -filename *.jpg *.webp *.png ``` ### Täielik optimeerimise töövoog Maksimaalse pildi-SEO saavutamiseks käivita see töövoog iga pildi puhul: 1. **Auditeeri olemasolevad metaandmed**: `exiftool -IPTC:all -XMP:all image.jpg` 2. **Lisa IPTC/XMP metaandmed**: Creator, Copyright, Description 3. **Teisenda WebP-ks**: `cwebp -q 82 -metadata all image.jpg -o image.webp` 4. **Loo responsiivsed variandid**: 400w, 800w, 1200w 5. **Kontrolli, et metaandmed säilisid**: `exiftool image.webp` 6. **Loo `` HTML**: AVIF > WebP > JPEG varuvariantide ahel ### Mis on Google Imagesi jaoks oluline ja mis mitte | Tegur | Mõju | Kus seada | |--------|--------|--------------| | Alt-tekst | **KRIITILINE** (positsioneerimine) | HTML `` | | Failinimi | **KÕRGE** (positsioneerimine) | Failisüsteem (kirjeldav, sidekriipsudega) | | Lehe kontekst | **KÕRGE** (positsioneerimine) | Ümbritsev HTML-sisu | | Failimaht/kiirus | **KESKMINE** (kaudselt CWV kaudu) | Tihendamine + vormingu teisendamine | | IPTC Creator/Copyright | **MADAL** (ainult kuvamine) | Pildifaili metaandmed | | EXIF kaameraandmed | PUUDUB | SEO jaoks ebaoluline | | IPTC Keywords | PUUDUB | Google ignoreerib neid | --- ## Vigade käsitlemine | Olukord | Tegevus | |----------|--------| | URL pole kättesaadav | Raporteeri ühenduse viga koos olekukoodiga. Soovita URL üle kontrollida ja vaadata, kas sait nõuab autentimist. | | Lehelt ei leitud pilte | Raporteeri, et `` elemente ei tuvastatud. Soovita kontrollida, kas pilte laaditakse JavaScripti või CSS background-image kaudu. | | Pildid CDN-i või autentimise taga | Märgi, et pildifailidele ei pääsenud mahu analüüsiks otse ligi. Raporteeri saadaolevad metaandmed (alt-tekst, mõõtmed, vorming märgendusest) ja märgi ligipääsmatud ressursid. | | exiftool pole paigaldatud | Kasuta metaandmete jaoks varuvariandina ImageMagicki. Soovita: `sudo apt install libimage-exiftool-perl` | | cwebp pole paigaldatud | Kasuta WebP-teisenduseks varuvariandina ImageMagicki või FFmpegi. Soovita: `sudo apt install webp` | | DataForSEO MCP pole saadaval | Jäta piltide SERP-analüüsi jaotis vahele. Märgi, et laiendus pole paigaldatud. |