Headless CMS için SEO
Headless ve composable CMS platformları için SEO — Contentful, Strapi, Sanity, Storyblok ve Ghost. CMS, içerik modellemeyi, API'leri ve iş akışını şekillendirir; ancak arama motorlarının gerçekte gördüğü şey frontend'in oluşturduğu çıktıdır.
Diller
Bu sayfada 1 kanıt sinyali
- İlgili canlı araçRaw vs. Rendered HTML Checker
Headless, CMS'in içerik yönetimini sunumdan ayırdığı anlamına gelir — frontend framework'ünüzü, oluşturma modunu, barındırmayı, önbelleğe almayı, önizleme güvenliğini veya yayınlama iş akışını belirtmez; bunların her biri SEO'yu şekillendiren ayrı bir karardır. Contentful, Strapi, Sanity, Storyblok ve Ghost, içeriği API'ler üzerinden sunar; en büyük tek kaldıraç, frontend'in bu içeriği arama motorlarına nasıl aldığı, oluşturduğu ve sunduğudur. SSG ve SSR eksiksiz HTML sunar ve daha güvenli varsayılandır; CSR ayrı bir oluşturma aşamasına bağlıdır ve doğrulama gerektirir. Hiçbir headless kurulum, bağlı bir CMS'ye kıyasla doğuştan gelen bir sıralama avantajına sahip değildir — ayrıştırma, sıralamaları değil denetimi, bağımlılıkları ve test yükünü değiştirir. WordPress'te bir eklentinin yaptığı tüm SEO işlerini (site haritaları, meta verileri, canonical'lar, yapılandırılmış veriler) artık açıkça siz oluşturursunuz.
TL;DR — Headless CMS, içeriği yazdığınız yer ile görüntülendiği yeri birbirinden ayırır — bu, içeriğin nasıl oluşturulacağını, barındırılacağını, önbelleğe alınacağını veya önizleneceğini belirtmez. SEO açısından en büyük tek kaldıraç, web sitenizin bu içeriği nasıl oluşturduğudur — dağıtım sırasında (SSG), her istek için sunucuda (SSR) veya ziyaretçinin tarayıcısında (CSR). SSG ve SSR eksiksiz HTML sunar; CSR’de oluşturulan çıktının görünür olduğu varsayılmamalı, doğrulanmalıdır.
Headless SEO açısından ne anlama gelir
Geleneksel CMS platformları (WordPress, Drupal) içerik yönetimi ile sunumu sıkı biçimde birbirine bağlar. CMS, arama motorlarının gördüğü HTML sayfasını oluşturur. Headless kurulumda CMS, API üzerinden erişilebilen bir içerik deposudur. Ayrı bir frontend (genellikle Next.js veya Nuxt gibi bir JavaScript framework’ü) içeriği bu API’den alır ve oluşturur. Evidence for this claim A headless CMS decouples the content repository from the frontend presentation layer and delivers content through APIs. Scope: Contentful as a representative headless CMS architecture. Confidence: high · Verified: Contentful: What is a headless CMS? “Headless” yalnızca bu ayrımı anlatır — hangi frontend framework’ünü, oluşturma modunu, sunucuyu, önbelleği, önizleme güvenliğini veya yayınlama iş akışını kullandığınızı söylemez. Bunların her biri sizin verdiğiniz ve SEO’yu gerçekten etkileyen ayrı bir karardır.
Bu, CMS platformunun kendisinin — Contentful, Strapi, Sanity, Storyblok veya Ghost — arama motorlarının gördüğü sayfayı doğrudan oluşturmadığı, ancak uygulamayı yine de şekillendirdiği anlamına gelir: içeriği nasıl modellediğiniz, API’nizin ne sunduğu, önizleme ve yayınlamanın nasıl çalıştığı ve bir şey bozulduğunda sayfayı kimin düzelteceği. SEO sonucunu belirleyen, frontend’in aldığı içerikle ne yaptığıdır.
SEO sonuçlarını belirleyen tek şey
Frontend’in sayfaları nasıl oluşturduğu.
SSG, SSR ve CSR, sıralama faktörleri değil teslimat mimarileridir — Google, sayfayı üreten framework’ün adına değil, bir sayfadan gerçekten aldığı ilk HTML’yi, oluşturulmuş HTML’yi, tarama izinlerini, HTTP durumunu, kaynak erişimini, bağlantıları ve meta verileri değerlendirir. Uygulamaya bağlı olarak bu üçünün herhangi biri başarılı olabilir veya başarısız olabilir:
- SSG (statik site oluşturma) — sayfalar dağıtım sırasında statik HTML olarak oluşturulur. Arama motorları JavaScript gerektirmeyen, tamamen oluşturulmuş HTML alır; bu, bir oluşturma adımını ortadan kaldırır ancak HTML’nin eksiksiz veya güncel olduğunu garanti etmez.
- SSR (sunucu taraflı oluşturma) — sayfalar istek anında sunucuda oluşturulur. Arama motorları ilk istekte yine eksiksiz HTML alır; eksiksizlik ve güncellik konusunda aynı uyarı geçerlidir.
- CSR (istemci taraflı oluşturma) — tarayıcı API’den veriyi alır ve sayfayı JavaScript ile oluşturur. Google JavaScript’i oluşturabilir, ancak içerik ayrı bir oluşturma aşamasına ve kaynakların başarıyla yüklenmesine bağlıdır. Görünür olduğunu varsaymak yerine oluşturulmuş çıktıyı doğrulayın. Evidence for this claim Google renders JavaScript pages in a separate processing stage, and JavaScript or resource failures can affect rendered output. Scope: Google Search; no guarantee of indexing. Confidence: high · Verified: Google: JavaScript SEO basics
Uygulamada SSG ve SSR, bir tarayıcının oluşturma adımını atlaması veya geciktirmesi gibi bir hata modunu ortadan kaldırdığı için daha güvenli varsayılanlardır — ancak etiketi garanti olarak görmek yerine üçünün de gerçekten teslim edilen çıktısını test edin.
Kendinizin oluşturması gerekenler
WordPress kurulumunda eklentiler meta verileri, site haritalarını, canonical’ları ve yapılandırılmış verileri yönetir. Headless kurulumda bunların hepsini siz oluşturursunuz:
- Title ve meta description — framework’ünüzün
<head>bileşeninde ayarlanır - Canonical etiketleri — layout’unuzda veya sayfa başına yapılandırılır
- XML sitemap — bir paket (
next-sitemap, Nuxt’un sitemap modülü) veya özel kod tarafından oluşturulur - Yapılandırılmış veri —
<head>ya da<script>bileşenleriniz üzerinden JSON-LD olarak eklenir - robots.txt — public dizininizde statik bir dosyadır
TL;DR — Headless CMS SEO’su çoğunlukla frontend mimarisidir ve hiçbir headless kurulum, bağlı bir CMS’ye kıyasla doğuştan gelen bir sıralama avantajına sahip değildir — CMS uygulamayı yine de şekillendirir. CMS’e özgü hususlar şunlardır: önizleme erişim denetimi (önce kimlik doğrulama, sonra noindex — noindex erişim denetimi değildir), API tarafından sağlanan meta veri alanları (CMS her kayıt için title/description alanlarını sunmalıdır), yayından canlıya geçiş hattı (teslim edilen bir webhook otomasyonun çalıştığını kanıtlar, yeni bir sayfanın canlı olduğunu değil) ve AI tarayıcısı erişimi (birçok headless API varsayılan olarak engellenir).
CMS düzeyinde SEO hususları
Headless CMS’in kendisi herkese açık sayfayı oluşturmaz, ancak SEO’ya şu şekillerde katkıda bulunur:
Meta veri alanları — CMS şemanız her içerik türü için SEO meta veri alanlarını içermelidir: title, meta description, Open Graph görseli, canonical URL geçersiz kılma alanı. Bunlar frontend’in kullanabilmesi için API yanıtında sunulmalıdır.
Önizleme URL’leri — Headless CMS’ler, editörlerin yayınlamadan önce taslakları görebilmesi için ayrı bir API, host veya token üzerinden önizleme içeriği oluşturur — önizleme API’si herkese açık olanın bir çeşidi değil, ayrı ve hassas bir teslimat yoludur. Evidence for this claim Google supports noindex in a robots meta tag or X-Robots-Tag response header, while robots.txt blocking can prevent Google from seeing that directive. Scope: Google Search indexing controls. Confidence: high · Verified: Google: Block indexing with noindex
Erişim denetimini birincil savunma olarak ele alın: önizleme token’larını ve host’larını kimlik doğrulamalı tutun; ortak kullanılan veya tahmin edilmesi kolay bir önizleme bağlantısının giriş yerine geçmesine izin vermeyin. HTML’deki veya bir X-Robots-Tag başlığındaki noindex, önizleme sayfasına erişilebildiği durumda ikinci ve tamamlayıcı bir katmandır — dizine eklemeyi durdurur, erişimi durdurmaz ve bir robots.txt disallow kuralı tarayıcıların noindex etiketini hiç görmesini engelleyebilir. Yaygın bir hata, yalnızca noindex’i yeterli sayıp önizleme URL’lerini kimlik doğrulama olmadan erişilebilir bırakmaktır.
Webhook tetiklemeli derlemeler — SSG kurulumlarında yayınlanan içerik, yeni bir derleme çalışana kadar canlıya geçmez. CMS’inizi yayınlama sırasında bir derleme webhook’u tetikleyecek şekilde yapılandırın; ancak webhook teslimini tamamlanmış bir yeniden derlemenin kanıtı saymayın — teslim edilen callback otomasyonun çalıştığını doğrular; derlemenin başarılı olduğunu, dağıtımın yayına alındığını veya sonraki bir önbelleğin geçersizleştirildiğini doğrulamaz. Evidence for this claim A statically generated deployment must be rebuilt to include source-content changes in its generated output. Scope: Astro static output as a representative SSG; deployment automation varies. Confidence: high · Verified: Astro: Build your site Yayınlamadan sonra herkese açık sayfayı doğrudan (yeni bir fetch veya izleme sisteminizle) doğrulayın ve başarısız bir derlemeyi kimin yeniden çalıştıracağını veya geri alacağını bilin. Aksi hâlde oluşturulan site, bir sonraki derlemeye kadar değişikliği içermez.
ISR (artımlı statik yeniden oluşturma) tuzakları — ISR’yi Next.js veya benzeriyle kullanıyorsanız, bayat önbelleğe alınmış sayfalar yeniden doğrulama aralığınızın izin verdiği süre boyunca tarayıcılara sunulabilir. Sık değişen içerikler için kısa yeniden doğrulama pencereleri ayarlayın ve yalnızca sabit bir aralığa güvenmek yerine aynı yayınlama webhook’unun tetiklediği isteğe bağlı yeniden doğrulamayı tercih edin.
AI tarayıcısı erişimi — Birçok headless CMS API uç noktası API anahtarlarıyla korunur. Ziyaretçilere sunulan frontend sayfalarınız erişilebilir olmalıdır; ancak AI tarayıcısı kullanıcı aracılarının (GPTBot, ClaudeBot vb.) CDN’niz veya edge yapılandırmanız tarafından engellenmediğini doğrulayın.
Doğuştan gelen bir sıralama avantajı yoktur — Headless bir CMS, yalnızca mimarisi sayesinde bağlı bir CMS’den daha iyi sıralanmaz. Ayrıştırma, neyi kimin denetlediğini (içerik modelleme, API şekli, oluşturma, barındırma) değiştirir; bağımlılıklar (API, derleme, önbellek, önizleme) ekler ve test ile sahiplenme yükünü artırır — bunların hiçbiri tek başına sıralama faktörü değildir. Arama, kurulumunuzun gerçekten ürettiği herkese açık sayfaları değerlendirir; arkasındaki CMS etiketini değil. Platformları hangisinin “SEO için daha iyi” olduğuna göre değil, teslimat güvenilirliği, gecikme, maliyet ve her hata modunun sahibine göre karşılaştırın.
Platform karşılaştırması
| CMS | API türü | Önizleme denetimi | Webhook tetikleyicileri | Yerleşik SEO alanları |
|---|---|---|---|---|
| Contentful | REST + GraphQL | Ortamlar + Preview API | Evet | İçerik modeli üzerinden |
| Strapi | REST + GraphQL | Taslak/yayınla + Preview | Evet | Eklenti üzerinden |
| Sanity | GROQ + REST | Preview API | Evet | Şema üzerinden |
| Storyblok | REST + GraphQL | Preview modu | Evet | Yerleşik SEO eklentisi |
| Ghost | REST + Admin API | Preview bağlantıları | Evet | Yerleşik meta alanları |
“Headless” yalnızca CMS’in (Contentful, Strapi, Sanity, Storyblok, Ghost) içerik yönetimini sunumdan ayırdığı anlamına gelir — frontend framework’ünü, oluşturma modunu, barındırmayı, önbelleği, önizleme güvenliğini veya yayınlama iş akışını belirtmez. CMS yine de uygulamayı (içerik modelleme, API şekli, önizleme, yayınlama, sahiplik) şekillendirir; ancak arama motorlarının gördüğü şey için en büyük tek kaldıraç frontend oluşturma mimarisidir. Hiçbir headless kurulum, yalnızca mimarisi sayesinde bağlı bir CMS’ye kıyasla doğuştan gelen bir sıralama avantajına sahip değildir.
Oluşturma kararı şudur: SSG (dağıtım sırasında statik HTML olarak oluşturulan sayfalar) ve SSR (istek başına sunucu tarafında oluşturulan sayfalar) eksiksiz HTML sunar ve daha güvenli varsayılandır. CSR (tamamen tarayıcıda JavaScript ile oluşturulan sayfalar) ayrı bir oluşturma aşamasına bağlıdır — Google bunu işleyebilir, ancak oluşturulan çıktıyı varsaymak yerine doğrulayın. SSG, SSR ve CSR teslimat mimarileridir, sıralama faktörleri değildir; her biri uygulamaya bağlı olarak başarılı olabilir veya başarısız olabilir.
Headless kurulumda açıkça oluşturmanız gerekenler (WordPress eklentilerinin otomatik olarak yönettiği şeylere karşılık):
- Her sayfa için meta veriler (title, description, Open Graph)
- Canonical etiketleri
- XML sitemap
- Yapılandırılmış veri (JSON-LD)
- robots.txt
CMS’e özgü SEO hususları:
- Contentful: içerik modelinde SEO alanlarını sunun; Preview API taslakları ayrı bir host ve token üzerinden sunar — önce kimlik doğrulaması isteyin, noindex’i ikinci katman olarak kullanın
- Strapi: SEO eklentisini kurun; yayınlamada derlemeleri tetikleyecek webhook’u yapılandırın, ardından yalnızca webhook teslimine güvenmek yerine herkese açık sayfayı doğrulayın
- Sanity: şemada SEO alanlarını tanımlayın; meta verileri sorgulamak için GROQ kullanın; yayınlamada webhook yeniden derlemesini canlı sayfaya karşı doğrulayın
- Storyblok: hikâye başına meta title/description içeren yerleşik SEO eklentisi; önizleme token’ı taslak erişimini denetler
- Ghost: yerleşik SEO alanları (meta title, description, OG görseli); frontend oluşturma modu (API üzerinden headless veya Ghost’un kendi Handlebars oluşturucusu) taranabilirliği belirler
Teslim edilen bir webhook, otomasyonun çalıştığını doğrular; yeni bir derlemenin başarılı olduğunu, dağıtıldığını veya önbelleğin geçersizleştirildiğini değil — webhook teslimini kanıt saymak yerine yayınlamadan sonra canlı herkese açık sayfayı doğrulayın.
Headless CMS SEO kurulum kontrol listesi
CMS yapılandırması
- Her içerik türüne SEO alanları ekleyin: title, meta description, OG görseli, canonical URL geçersiz kılma alanı
- Önizleme URL’si kimlik doğrulamasını veya noindex başlıklarını yapılandırın
- İçerik yayınlama/yayından kaldırma ile tetiklenen derleme webhook’u kurun
- Hangi ortamların staging, hangilerinin production olduğunu belgeleyin (staging’de noindex’i doğrulamak için)
Frontend (tüm headless kurulumlar için geçerlidir)
- Sayfaları SSG veya SSR olarak oluşturun — bir
curlya da kaynak görüntüleme kontrolüyle doğrulayın -
<title>ve<meta name="description">değerlerini CMS alanlarından dinamik olarak ayarlayın - Her sayfaya canonical etiketi (
<link rel="canonical">) ekleyin - XML sitemap oluşturun (next-sitemap, @nuxtjs/sitemap veya özel kod)
- public dizinine
robots.txtekleyin; staging/preview yollarını engelleyin -
<script type="application/ld+json">üzerinden yapılandırılmış veri (JSON-LD) ekleyin - Oluşturmayı test edin: Rich Results Test veya URL Inspection ile Google’ın içeriğinizi görebildiğini doğrulayın
ISR’ye özgü
- Sık güncellenen içerikler (haberler, fiyatlandırma) için kısa
revalidatearalıkları ayarlayın - CMS yayınlama etkinliklerinde webhook üzerinden isteğe bağlı yeniden doğrulamayı tetikleyin
- Search Console’da bayat içerik sorunlarını izleyin (içerik sitede canlı, ancak dizine eklenmemiş)
Headless yığını test etmek için araçlar
- Render Gap Analyzer — sunucu tarafından teslim edilen HTML’yi oluşturulmuş sayfayla karşılaştırın; yalnızca istemci çalıştırıldıktan sonra var olan içerik ve bağlantıları yakalayın.
- Staging vs. Production SEO Diff — frontend sürümünden önce yönergeleri, canonical’ları, meta verileri ve yapılandırılmış verileri karşılaştırın.
- Schema Validator — frontend’in CMS alanlarından oluşturduğu JSON-LD’yi doğrulayın.
- Sitemap Validator — frontend rotalarının ve CMS yayınlama durumunun amaçlanan sitemap’i oluşturduğunu doğrulayın.
- Scout Site Audit Free — tümleşik sistemi örnekleyin; yalnızca CMS API’si üzerinde yapılan denetim, tarayıcıların frontend’den ne aldığını gösteremez.
Platformların ayrıntılı incelemeleri
İlgili okumalar
Kendinizi test edin: Headless CMS SEO
Headless kurulumda SEO sonuçlarını gerçekte neyin yönlendirdiği hakkında beş soru. Her biri için bir yanıt seçin, sonra kontrol edin.
Değişiklik günlüğü
8 Ağu 2026 tarihinde güncellendi.
Editoryal özet ve kaydedilen değişiklik ayrıntıları.Değişiklik ayrıntıları
-
Ayrıntılı değişiklik notları şu anda İngilizce olarak mevcut.
Tam karşılaştırma kullanılamıyor — bu sürüm için önceki anlık görüntü arşivlenmemiş.
25 Tem 2026 tarihinde güncellendi.
Editoryal özet ve kaydedilen değişiklik ayrıntıları.Değişiklik ayrıntıları
-
Ayrıntılı değişiklik notları şu anda İngilizce olarak mevcut.
Tam karşılaştırma kullanılamıyor — bu sürüm için önceki anlık görüntü arşivlenmemiş.
18 Tem 2026 tarihinde güncellendi.
Editoryal özet ve kaydedilen değişiklik ayrıntıları.Değişiklik ayrıntıları
-
Ayrıntılı değişiklik notları şu anda İngilizce olarak mevcut.
-
Ayrıntılı değişiklik notları şu anda İngilizce olarak mevcut.
Tam karşılaştırma kullanılamıyor — bu sürüm için önceki anlık görüntü arşivlenmemiş.