# SEO Denetim Aracı Becerisi

> Claude Code, OpenClaw ve Codex için hafif bir SEO Denetim Aracı Becerisi. Hızlı tek sayfalık SEO denetimleri gerçekleştirin, temel sayfa içi ve site düzeyindeki sorunları kontrol edin ve uygulanabilir düzeltmeler içeren yapılandırılmış bir SEO raporu oluşturun.

- Canonical: https://nanoskill.ai/tr/skills/seo-audit
- Markdown: https://nanoskill.ai/tr/skills/seo-audit.md
- Author: JeffLi1993
- Published: 2026-05-11T01:05:35.771Z
- Updated: 2026-07-25T04:34:17.896Z
- Language: tr
- Source type: github
- Popularity signal: 382

## Sources

- https://github.com/JeffLi1993/seo-audit-skill

## Install

```shell
npx skills add JeffLi1993/seo-audit-skill
```

## About

SEO Denetimi, Claude Code, OpenClaw ve Codex gibi AI kodlama aracıları için hafif bir SEO Denetim Aracı Becerisidir. Bir aracının tek bir URL'yi incelemesine, temel SEO sorunlarını kontrol etmesine ve kanıt, etki ve önerilen düzeltmelerle yapılandırılmış bir denetim raporu oluşturmasına yardımcı olur.

Bu beceri, başlık etiketleri, meta açıklamalar, H1 etiketleri, canonical etiketler, resim alt metni, anahtar kelime yerleşimi, robots.txt, sitemap.xml, 404 işleme, URL standartlaştırması, E-E-A-T güven sayfaları ve JSON-LD şema doğrulaması dahil olmak üzere ilk geçiş SEO kontrollerine odaklanır.

Bir sayfayı yayınlamadan önce hızlı bir SEO sağlık kontrolüne ihtiyacınız olduğunda, bir açılış sayfasını incelerken, temel sıralama sorunlarını teşhis ederken veya daha derin bir teknik SEO denetimine ihtiyaç olup olmadığına karar verirken kullanın.

## Key features

- **Hızlı Tek Sayfalı SEO Denetimi**: Herhangi bir URL için hızlı bir SEO denetimi çalıştırın ve tam bir tarayıcı veya analiz iş akışı kurmadan sayfanın SEO sağlığının ilk geçiş görünümünü alın.
- **Temel Sayfa İçi SEO Kontrolleri**: Başlık etiketlerini, meta açıklamalarını, H1 etiketlerini, kanonik etiketleri, görsel alternatif metinlerini, başlık yapısını, anahtar kelime yerleşimini, dahili bağlantıları ve kelime sayısını kontrol edin.
- **Site Düzeyinde SEO Temelleri**: Robots.txt, sitemap.xml, 404 işleme, URL standartlaştırma, i18n / hreflang ve E-E-A-T güven sayfaları gibi temel SEO sinyallerini inceleyin.
- **JSON-LD Şema Doğrulaması**: Sayfanın doğru yapılandırılmış veriye sahip olup olmadığını tespit edin, yaygın şema türlerini doğrulayın ve eksik veya tamamlanmamış JSON-LD alanlarını işaretleyin.
- **Yapılandırılmış SEO Denetim Raporu**: Her önemli sorun için geçti, uyarı ve başarısız durumları ile kanıt, etki ve belirli düzeltmeleri içeren temiz bir SEO denetim raporu oluşturun.

## Use cases

- **Yayınlamadan Önce Bir Açılış Sayfasını Denetleyin**: Temel SEO sorunlarını erken yakalamak için bir ana sayfa, ürün sayfası, araç sayfası veya SEO açılış sayfası yayınlamadan önce bu yeteneği kullanın.
- **Hızlı Bir SEO Sağlık Kontrolü Yapın**: Bir sayfanın doğru başlık, meta açıklaması, H1, kanonik etiket, şema, dahili bağlantılar ve diğer temel SEO sinyallerine sahip olup olmadığını kontrol edin.
- **Sıralama Sorunları Olan Mevcut Sayfaları İnceleyin**: Bir sayfa dizinlenmiş ancak iyi sıralanmıyorsa veya belirgin sayfa içi ve site düzeyindeki sorunları hızlıca belirlemek istediğinizde kullanın.

## Result preview

Bu Aracı Becerisi tarafından oluşturulmuş gerçek bir SEO denetim sonucunu görün.

![seo-audit-demo](https://file.nanoskill.ai/seo-audit-demo-1.png)

![seo-audit-demo-2](https://file.nanoskill.ai/seo-audit-demo-2.png)

![seo-audit-demo-3](https://file.nanoskill.ai/seo-audit-demo-3.png)

## Result walkthrough

### Adım 1：Kur

Beceriyi aracınıza ekleyin

![seo-audit-step-1](https://file.nanoskill.ai/seo-audit-step-1.png)

### Adım 2：Denetim Görevi

Bir URL kullanın ve öncelikli bir denetim isteyin.

![seo-audit-step-2](https://file.nanoskill.ai/seo-audit-step-2.png)

### Adım 3：Sonucu İnceleyin

Hemen uygulayabileceğiniz öncelikli SEO düzeltmelerini alın.

![seo-audit-step-3](https://file.nanoskill.ai/seo-audit-step-3.png)

## Skill definition

# seo-audit — Temel SEO Denetimi

OpenClaw tarafından desteklenen, hızlı, varsayılan tek sayfa SEO denetimleri için tasarlanmış hafif bir SEO ajan becerisi. Tam teknik derinlik gerektirmeyen ilk sayfa kontrolleri veya hızlı bir değerlendirme gerektiğinde uygundur.

---

## Bu Beceri Ne Zaman Kullanılır

Aşağıdaki durumlarda `seo-audit` kullanın:

- Kullanıcı şunları söylediğinde: "bu sayfayı denetle", "SEO'yu kontrol et", "URL'mi analiz et", "hızlı SEO kontrolü", "sayfamda ne yanlış var"
- Belirli bir derinlik istenmediğinde — bu varsayılan giriş noktasıdır
- Kullanıcı kapsamlı bir teknik döküm yerine hızlı, okunabilir bir özet istediğinde

Kullanıcı daha fazla derinlik isterse, `seo-audit-full`'a yükseltin:

> **İpucu:** Derin teknik denetimler, gelişmiş sayfa içi SEO veya tam raporlar için `seo-audit-full` becerisini kullanın.

---

## Beklenen Girdi

| Girdi | Gerekli | Notlar |
|-------|----------|-------|
| Sayfa URL'si | Evet | Denetlenecek sayfa |
| Ham HTML veya sayfa içeriği | İsteğe bağlı | Daha doğru sayfa içi analiz sağlar |
| GSC / analitik verileri | İsteğe bağlı | Temel denetim için gerekli değildir |

Yalnızca bir URL sağlanmışsa ve kaynak kodu veya tarayıcı verisi yoksa, açıkça belirtin:

> **Sınırlama:** Bu denetim yalnızca görünür sayfa içeriğine ve herkese açık sinyallere dayanmaktadır. Bu denetim için kaynak kodu, GSC verileri, tarama günlükleri ve performans metrikleri mevcut değildir.

---

## Çıktı

[assets/report-template.html](assets/report-template.html) adresindeki şablonu doldurarak bir **Temel SEO Denetim Raporu** oluşturun,
sonra **bir dosyaya kaydedin — asla ham HTML'i terminale yazdırmayın**.

**Dosya adlandırma:** `reports/<sunucu-adı>-<kısa-ad>-denetim.html`
```
https://example.com/blog/en-iyi-araclar → reports/example-com-blog-en-iyi-araclar-denetim.html
https://example.com/                → reports/example-com-denetim.html
```

**Kaydettikten sonra kullanıcıya söyleyin:**
```
✅ Rapor kaydedildi → reports/example-com-denetim.html
   Şimdi açmak ister misiniz? (evet / hayır)
```
Evet ise → çalıştırın: `open reports/example-com-denetim.html`

---

**Şablon yer tutucuları** — her birini bağımsız olarak doldurun:

| Yer Tutucu | İçerik |
|---|---|
| `{{summary_verdict}}` | Bir cümle: toplam kaç kontrol yapıldı, kaçı başarısız/uyarı/geçti |
| `{{summary_critical_html}}` | Her kritik (başarısız) öğe için `<li>` veya `<li class="summary-empty">Yok</li>` |
| `{{summary_warnings_html}}` | Her uyarı öğesi için `<li>` veya `<li class="summary-empty">Yok</li>` |
| `{{summary_passing_html}}` | Her geçen kontrol için `<li>` veya `<li class="summary-empty">Yok</li>` |

---

## Betikler

Herhangi bir bulgu yazmadan önce bu betikleri çalıştırın. Yapılandırılmış JSON çıktısı verirler — JSON'u doğrudan kanıt olarak kullanın; aynı URL'leri manuel olarak tekrar getirmeyin.

**Bağımlılıklar:** `pip install requests` (html ayrıştırma Python stdlib kullanır)

```bash
# Adım 1: site düzeyinde kontroller (robots.txt + sitemap.xml)
python scripts/check-site.py https://example.com

# Adım 2: sayfa düzeyinde kontroller (H1, başlık, meta açıklaması, canonical)
python scripts/check-page.py https://example.com
# Birincil anahtar kelime ile (önerilir — H1 anahtar kelime varlığı kontrolünü etkinleştirir)
python scripts/check-page.py https://example.com --keyword "koşu ayakkabıları"

# İsteğe bağlı: daha fazla inceleme için ham sayfa HTML'sini getir
python scripts/fetch-page.py https://example.com --output page.html

# Adım 3: JSON-LD şema doğrulaması
python scripts/check-schema.py https://example.com
# Veya önceden getirilmiş HTML'den (gereksiz getirmeyi önler):
python scripts/check-schema.py --file page.html
```

Her betik `0` (tümü geçti/uyarı) veya `1` (herhangi bir başarısızlık/hata) koduyla çıkar.

**KATI KAPSAM — aşağıda listelenmeyen hiçbir kontrol eklemeyin. İstisna yok.**

İzin verilen site düzeyi kontrolleri (`{{site_checks_html}}` içinde):
- robots.txt · sitemap.xml · 404 Yönetimi · URL Kanonikleştirme · i18n / hreflang

İzin verilen E-E-A-T kontrolleri (`{{eeat_checks_html}}` içinde):
- Hakkımızda · İletişim · Gizlilik Politikası · Hizmet Şartları · Medya/Ortaklar (yalnızca mevcutsa)

İzin verilen sayfa düzeyi kontrolleri (`{{page_checks_html}}` içinde), bu tam sırayla çıktı verin:
URL Kısa Adı · Başlık Etiketi · Meta Açıklaması · H1 Etiketi · Kanonik Etiket · Görsel Alt Metni · Kelime Sayısı · Anahtar Kelime Yerleşimi · Başlık Yapısı · Dahili Bağlantılar · Şema (JSON-LD)

  Görsel Alt Metni mantığı:
  - Statik HTML'den <img> etiketlerini ayrıştırın
  - Geçti: tüm görsellerin boş olmayan alt metni var (alt="" olan dekoratif görseller uygundur)
  - Uyarı: herhangi bir içerik görselinde alt özelliği eksik
  - Doğrulanamadı (durum-bilgisi): statik HTML'de 0 görsel bulundu → muhtemelen JS ile oluşturulmuş, doğrulanamaz

⛔ KESİN KURAL — Yalnızca report-template.html'de tanımlanan kontrol satırlarını çıktı olarak verin.
Bir kontrol yukarıdaki izin verilen listelerde yoksa, onu çıktı olarak VERMEYİN — sorun bulsanız bile.
İstisna yok. "Bonus" kontrol yok. Doğaçlama yok.
Şablon tek doğruluk kaynağıdır. Onu katı bir beyaz liste olarak kabul edin.

Hâlâ YASAKLI (seo-audit-full'a ait): OG etiketleri · Twitter Kartı · Sosyal etiketler · Sayfa Ağırlığı · Temel Web Verileri · Robots Meta

**JSON çıktısı nasıl kullanılır:**
- Her alanın `status` değerini (`pass` / `warn` / `fail` / `error`) doğrudan rapor kontrol tablosuna eşleyin
- Her alanın `detail` dizesini, bulgulardaki Kanıt satırı için başlangıç noktası olarak kullanın
- Ek gözlemlenebilir kanıtınız olmadıkça betik çıktısıyla çelişmeyin
- `{{site_checks_html}}` içinde kontrol gruplarını `<div class="subsection-label">Etiket</div>` ile ayırın:
  `Taranabilirlik` · `URL Kanonikleştirme` · `i18n / hreflang` · `Şema (JSON-LD)`
  ve `{{eeat_checks_html}}` öncesinde `<div class="subsection-label">E-E-A-T Güven Sayfaları</div>`

**LLM incelemesi — `llm_review_required: true` olduğunda zorunludur:**

Betik, kendisinin gerçekleştiremeyeceği anlamsal veya kalite yargısı gerektiren alanları işaretler.
`llm_review_required: true` asla çözülmemiş bırakmayın — her zaman açık bir yargı çağrısı yapın.

**H1 — `keyword_match == "partial"` olduğunda tetiklenir:**
```
h1_metni : (h1.values[0]'dan)
anahtar_kelime : (betiğe geçirilen --keyword)

Yargılayın: Bu H1, anahtar kelimenin arama amacını anlamsal olarak kapsıyor mu?
  - Eş anlamlıları, doğal varyantları, konu kapsamını göz önünde bulundurun
  - evet → "pass" olarak düşürün, varyantı not edin
  - hayır  → "warn" olarak bırakın veya "fail" olarak yükseltin, boşluğu açıklayın
```

**Başlık — `keyword_match == "partial"` VEYA `keyword_position != "start"` olduğunda tetiklenir:**
```
başlık   : (title.value'dan)
anahtar_kelime : (--keyword geçirildi)

Yargılayın:
  1. Başlık, anahtar kelimenin arama amacını anlamsal olarak kapsıyor mu?
  2. Başlık dilbilgisel olarak doğru ve doğal olarak okunabilir mi?
  3. Anahtar kelime konumu — sayfa türüne göre farklı standartlar uygulayın:
     - Ana sayfa   : Marka + çekirdek anahtar kelime doğrudur (ör. "Acme | Yapay Zeka İş Akışı Otomasyonu")
                    Marka-önce olmasını sorun olarak işaretlemeyin.
     - İç sayfalar: Çekirdek anahtar kelime önde olmalıdır (ör. "Takımlar için Yapay Zeka İş Akışı Otomasyonu — Acme")
                    Anahtar kelime, iyi bir neden olmaksızın başlığın ortasında gömülüyse işaretleyin.

ÖNEMLİ — bunları olumsuz olarak işaretlemeyin:
  - Yıllar (ör. "2026") → güncellik sinyali verir, TO'yu artırır — sayfa, tarihlemenin uzun ömürlülüğü zedeleyeceği açıkça her dem yeşil içerik değilse olumlu olarak değerlendirin.
  - Sayılar (ör. "5 en iyi", "En iyi 10", "3 adım") → net beklentiler oluşturur,
    sayısal olmayan başlıklara göre TO'da sürekli daha iyi performans gösterir — her zaman artı olarak değerlendirin.
  - Belirli niteleyiciler ("Açık Kaynaklı", "Kendi Sunucunda", "Ücretsiz") → amacı daraltır
    ve daha yüksek kaliteli tıklamalar çeker — cezalandırmayın.
```

**URL Kısa Adı — `keyword_match != "full"` veya `is_homepage == false` olduğunda tetiklenir:**
```
kısa_ad    : (url_slug.slug'dan)
anahtar_kelime : (--keyword geçirildi)

Yargılayın:
  1. Kısa ad, birincil anahtar kelimeyi veya doğal bir varyantını içeriyor mu?
  2. Yol hiyerarşisi mantıklı mı? (/kategori/anahtar-kelime idealdir)
  3. Kısa ve insan tarafından okunabilir mi?
  Ana sayfa (is_homepage: true): atlayın — yargılamaya gerek yok.
```

**Meta Açıklaması — içerik mevcut olduğunda her zaman tetiklenir:**
```
meta_aciklamasi : (meta_description.value'dan)
anahtar_kelime          : (--keyword geçirildi)

Dördünü de yargılayın:
  1. Tam cümle(ler) mi? (1-2 cümle, parça yok)
  2. Somut bir sonuçtan bahsediyor mu — belirsiz boş laf değil?
     İyi: "Yapay zeka destekli şablonlarla tasarım süresini %60 azaltın"
     Kötü:  "Tüm tasarım ihtiyaçlarınız için en iyi araç"
  3. Anahtar kelime veya doğal eş anlamlısı bir kez kullanılmış — doldurulmamış?
  4. Tipik bir rakibin yazacağından daha spesifik mi?

ÖNEMLİ — bunları olumsuz olarak işaretlemeyin:
  - Yıllar (ör. "2026") → güncellik sinyali verir, zamana duyarlı sorgular için TO'yu iyileştirir.
    Yalnızca sayfa, tarihlemenin zarar vereceği açıkça her dem yeşil içerikse yılı not edin.
  - Sayılar (ör. "5 en iyi", "3 adım") → somut özgüllük, güçlü TO sinyali.
  - Sondaki "ve daha fazlası." → en fazla küçük bir stil notu, asla Uyarı veya Başarısız değil.
```

---

## Önerilen İş Akışı

Bu adımları sırayla izleyin:

1. **Kapsamı onaylayın** — bunun temel bir denetim olduğunu doğrulayın; eksik verileri not edin

2. **Birincil anahtar kelimeyi çıkarsayın** — sayfayı `fetch-page.py` ile getirin, ardından birincil anahtar kelimeyi belirleyin:
   - Kullanıcı açıkça bir anahtar kelime verdiyse → doğrudan kullanın
   - Vermediyse → sayfanın H1'ini, başlığını ve ilk paragrafını okuyun, ardından en olası
     hedef anahtar kelime öbeğini çıkarsayın (bir arayan bu sayfayı bulmak için ne yazardı?)
   - Kontrolleri çalıştırmadan önce çıkarsanan anahtar kelimeyi açıkça belirtin:
     > "Çıkarsanan birincil anahtar kelime: **açık kaynak claude alternatifleri**"

3. **`check-site.py` betiğini çalıştırın** — robots, site haritası, 404 yönetimi ve URL kanonikleştirme için JSON çıktısını ayrıştırın

   **404 kontrolü:** `<origin>/bu-sayfa-kesinlikle-mevcut-degil-seo-denetim-kontrolu` adresini getirin
   - 404 döndürür → Geçti · 200 döndürür (yumuşak 404) → Başarısız · Ana sayfaya 301 döndürür → Uyarı

   **URL Kanonikleştirme kontrolleri** (her biri ayrı bir alt kontroldür):
   - **HTTP→HTTPS:** `http://<host>` adresini getirin — `https://` adresine 301 yönlendirmelidir. 200 döndürür → Başarısız.
   - **www tutarlılığı:** hem `https://www.<host>` hem de `https://<host>` adresini getirin — biri diğerine 301 yönlendirmelidir. Her ikisi de 200 döndürür → Uyarı.
   - **Sondaki eğik çizgi:** gerçekten sunulan URL'yi sayfadaki kanonik etiketle karşılaştırın. Uyuşmazlık → Uyarı.
   - **Kanonik eşleşmesi:** kanonik etiket href'i, tüm yönlendirmelerden sonraki nihai URL ile tam olarak eşleşmelidir. Uyuşmazlık → Uyarı.

4. **E-E-A-T altyapı kontrolü** — aşağıdaki her güven sayfası için iki katmanı kontrol edin:
   - **Katman 1 — Var:** URL'yi getirin, HTTP durumunu kontrol edin (200 = var, 404/yönlendirme = eksik)
   - **Katman 2 — Erişilebilir:** Ana sayfa HTML'sini getirin, altbilgi veya gezinme çubuğunda bu sayfaya bir bağlantı olup olmadığını kontrol edin

   | Sayfa | Gerekli |
   |---|---|
   | Hakkımızda | Evet |
   | İletişim | Evet |
   | Gizlilik Politikası | Evet |
   | Hizmet Şartları | Evet |
   | Medya / Ortaklar | Hayır — yalnızca mevcutsa dahil edin |

   Durum kuralları:
   - Sayfa eksik (200 olmayan) → **Başarısız**
   - Sayfa var ancak altbilgi/gezinme çubuğunda bağlantılı değil → **Uyarı**
   - Sayfa var ve altbilgi/gezinme çubuğunda bağlantılı → **Geçti**
   - İsteğe bağlı sayfa eksik → atlayın, satır eklemeyin

5. **`check-page.py --keyword "<cikarsanan_anahtar_kelime>"` betiğini çalıştırın** — H1, başlık,
   meta açıklaması, kanonik ve URL kısa adı için JSON çıktısını ayrıştırın

6. **i18n / hreflang kontrolü** — yalnızca sayfa hreflang etiketleri içeriyorsa veya `<html lang>` çok dilli olduğunu gösteriyorsa çalıştırın:
   - **Tamamen atlayın (N/A)** eğer hiçbir hreflang etiketi bulunmazsa ve site tek dilli görünüyorsa
   - Hreflang etiketleri varsa, kontrol edin:
     - **Karşılıklı simetri**: referans verilen her URL, diğer tüm varyantlara geri bağlantı vermelidir — herhangi bir kırık bağlantı = Başarısız
     - **Dil kodları**: geçerli BCP 47 olmalıdır (ör. `zh-CN` `zh` değil, `en-US` `en-us` değil) — yanlış kod = Uyarı
     - **x-default**: dil seçici veya yedek sayfalar için bulunmalıdır — eksik = Uyarı
     - **html[lang] özelliği**: sayfanın birincil hreflang'i ile eşleşmelidir — uyuşmazlık = Uyarı
     - **URL yapısı**: önerilen desen — varsayılan dil (genellikle `en`) kökte ön eksiz,
       diğer diller alt dizinlerde (`/zh/`, `/es/`).
       - `/page` (en) + `/zh/page` + `/es/page` → Geçti
       - `/en/page` + `/zh/page` → Uyarı (en ön eki gereksiz, tarama derinliğini boşa harcar)
       - Yalnızca desen açıkça tutarsızsa veya en gereksiz yere ön eklenmişse işaretleyin

7. **`check-schema.py` betiğini çalıştırın** — şema türleri ve alan doğrulaması için JSON çıktısını ayrıştırın

   ```bash
   python scripts/check-schema.py https://example.com
   # Veya önceden getirilmiş HTML'den:
   python scripts/check-schema.py --file page.html
   ```

   Betik JSON-LD bloklarını çıkarır, `@type` ve gerekli alanları Schema.org spesifikasyonuna göre doğrular.
   `llm_review_required: true` her zaman ayarlanır — `inferred_page_type`'ın gerçek sayfa içeriğiyle eşleştiğini onaylayın.

   Sayfa türü → beklenen `@type` referansı:

   | Sayfa Türü | Beklenen @type | Min. gerekli alanlar |
   |---|---|---|
   | Ana sayfa | WebSite + Organization | name, url, logo |
   | Blog / Makale | Article veya BlogPosting | headline, datePublished, author, image |
   | Ürün | Product | name, image, offers (price, priceCurrency) |
   | SSS | FAQPage | mainEntity[].name, acceptedAnswer.text |
   | Nasıl Yapılır | HowTo | name, step[].text |
   | Yerel işletme | LocalBusiness | name, address, telephone |
   | Genel açılış sayfası | — | N/A — atlayın, yaygın olarak desteklenen bir tür yok |

   - Geçti: doğru @type mevcut, tüm gerekli alanlar geçerli, çakışma yok
   - Uyarı: @type mevcut ancak önerilen alanlar eksik
   - Başarısız: beklenen @type tamamen eksik
   - N/A: genel açılış sayfası — cezalandırmayın

8. **Bulguları özetleyin** — her bulgu Kanıt / Etki / Düzeltme formatını takip etmelidir

9. **Öncelikli eylemler** — en yüksek etkili 3 düzeltmeyi listeleyin

10. **Raporu oluşturun** — `reports/<sunucu-adı>-<kısa-ad>-denetim.html` konumuna kaydedin, ardından kullanıcıya açmayı sorun

11. **Yükseltme istemi** — temel kapsamın ötesinde sorunlar bulunursa, `seo-audit-full` önerin

---

## Rapor Detay Yazım Kuralları

**Kontrol tablolarındaki Detay hücresi şu kurallara uymalıdır — istisna yok:**

**Geçti → kısa bir ifade. Liste yok, ayrıntı yok.**
```
İyi: "Geçerli XML urlset · 104 URL · robots.txt'de referans verilmiş."
Kötü:  "104 URL içeren geçerli XML urlset. Robots.txt'de doğru şekilde referans verilmiş.
       Blog yazıları muhtemelen bu site haritası aracılığıyla dizine eklenmiştir."
```

**Uyarı → en fazla 2 madde işaretli bir `<div class="detail-issue">`. Düzeltmeyi içeren bir `<div class="detail-fix">`.**
```
İyi:
  <div class="detail-issue">· Başlık 48 karakter — minimumun 2 altında. · "2026" yılı sayfayı tarihleyecek.</div>
  <div class="detail-fix">50–60 karaktere genişletin; her dem yeşilse yılı kaldırın.</div>

Kötü: başlık etiketinin ne olduğunu ve uzunluğun neden önemli olduğunu açıklayan üç cümlelik düzyazı.
```

**Başarısız → Uyarı ile aynı. Tam başarısızlıkla başlayın. Arka plan açıklamaları yok.**

Bir kontrolün ne olduğunu AÇIKLAMAYIN, durum rozetinde zaten görünen bilgileri TEKRARLAMAYIN,
okuyucuyu SEO temellerine yabancıymış gibi DAVRANMAYIN.

---

## Zorunlu Bulgu Formatı

Her önemli bulgu **mutlaka** şu yapıyı izlemelidir:

```
**Bulgu: [Bulgu Başlığı]**

- **Kanıt:** [Gözlemlenen — doğrudan alıntı, ekran görüntüsü referansı veya ölçülebilir veri]
- **Etki:** [Bunun SEO veya kullanıcı deneyimi için neden önemli olduğu]
- **Düzeltme:** [Spesifik, uygulanabilir öneri]
```

Belirsiz sonuçlar yazmayın. Kanıt yetersizse, varsayımları açıkça belirtin.

---

## Yükseltme İstemi

Her temel denetim raporunun sonuna şunu ekleyin:

> **Daha derin bir analiz ister misiniz?**
> Bu, site düzeyindeki sinyalleri ve temel sayfa içi kontrolleri kapsayan temel bir SEO denetimiydi.
> Gelişmiş teknik SEO, içerik kalitesi puanlaması, yapılandırılmış veri analizi ve tam tarama tabanlı bulgular için `seo-audit-full` becerisini kullanın.

---

## Referans Dosyaları

- Ayrıntılı denetim kapsamı ve alan tanımları: [references/REFERENCE.md](references/REFERENCE.md)
- Nihai HTML rapor şablonu: [assets/report-template.html](assets/report-template.html)
- Site düzeyi kontrol betiği: [scripts/check-site.py](scripts/check-site.py)
- Sayfa düzeyi kontrol betiği: [scripts/check-page.py](scripts/check-page.py)
- Ham sayfa getirici: [scripts/fetch-page.py](scripts/fetch-page.py)
- Şema doğrulama betiği: [scripts/check-schema.py](scripts/check-schema.py)

## FAQ

### SEO Denetim Ajanı Yeteneği nedir?

SEO Denetim Ajanı Yeteneği, bir yapay zeka ajanının bir web sayfasını incelemesine, SEO sorunlarını kontrol etmesine ve yapılandırılmış bir denetim raporu oluşturmasına yardımcı olan yeniden kullanılabilir bir iş akışıdır. Bu yetenek, Claude Kod, AçıkPençe ve Kodeks iş akışları içinde hızlı tek sayfalı SEO denetimleri için tasarlanmıştır.

### SEO Denetim yeteneği neyi kontrol eder?

Başlık etiketleri, meta açıklamaları, H1 etiketleri, kanonik etiketler, görsel alternatif metinleri, anahtar kelime yerleşimi, dahili bağlantılar, robots.txt, sitemap.xml, 404 işleme, URL standartlaştırma, güven sayfaları ve JSON-LD şeması dahil temel sayfa içi SEO ve basit site düzeyi sinyallerini kontrol eder.

### Bu tam bir teknik SEO denetimi mi?

Hayır. Bu, tek bir sayfa için hafif bir ilk geçiş SEO denetimidir. Hızlı kontroller ve temel sorun tespiti için kullanışlıdır. Tarama tabanlı denetimler, Temel Web Verileri, dizinleme tanılamaları, günlük analizi ve gelişmiş teknik SEO için tam bir SEO denetim iş akışı kullanın.

### Bu SEO Denetim Ajanı Yeteneğini kimler kullanmalı?

Bir sayfayı yayınlamadan veya iyileştirmeden önce hızlı bir şekilde kontrol etmek isteyen SEO operatörleri, SaaS kurucuları, bağımsız geliştiriciler, pazarlamacılar, içerik ekipleri ve geliştiriciler için kullanışlıdır.

### Ne tür bir rapor üretir?

Geçti, uyarı ve başarısız durumlarıyla yapılandırılmış bir SEO denetim raporu üretir. Önemli bulgular kanıt, SEO etkisi ve belirli düzeltmeleri içerir, böylece raporun geliştiricilere veya içerik ekiplerine teslimi kolaylaşır.

### Herhangi bir URL'yi denetleyebilir mi?

Evet, görünür sayfa içeriğine ve herkese açık SEO sinyallerine dayanarak bir genel URL'yi denetleyebilir. Kaynak kodu, Google Arama Konsolu verileri, analiz verileri, tarama günlükleri veya performans verileri mevcut değilse, rapor bu sınırlamaları açıkça belirtmelidir.

### Bunun normal bir SEO kontrol listesinden farkı nedir?

Normal bir SEO kontrol listesi size neyi incelemeniz gerektiğini söyler. Bu SEO Denetim Ajanı Yeteneği, bir yapay zeka ajanına kontrolleri çalıştırma, sonuçları yorumlama ve kanıtlar ve düzeltmelerle yapılandırılmış bir rapor üretme için tekrarlanabilir bir süreç sunar.

### Bunun yerine tam bir SEO denetimi ne zaman kullanmalıyım?

Daha derin teknik analiz, site genelinde tarama, Temel Web Verileri, dizinleme kontrolleri, içerik kalitesi incelemesi, dahili bağlantı mimarisi, günlük analizi veya gelişmiş sıralama tanılamaları gerektiğinde tam bir SEO denetimi kullanın.
