Claude Code ile Teknik SEO: Otomatik Site Denetimi Senaryoları

Claude Code ile Teknik SEO: Otomatik Site Denetimi Senaryoları, web sitelerindeki tarama, indeksleme, yönlendirme, canonical, yapılandırılmış veri ve performans sorunlarını daha hızlı tespit etmek için kod tabanlı kontrollerden yararlanmayı ifade eder. Claude Code tek başına kusursuz bir SEO uzmanı gibi davranmaz; ancak doğru araçlara, veri kaynaklarına ve kontrol kriterlerine bağlandığında tekrarlanan teknik denetimleri büyük ölçüde hızlandırır. Özellikle çok sayfalı sitelerde, e-ticaret projelerinde ve düzenli kod güncellemesi alan platformlarda teknik SEO kontrollerini geliştirme sürecinin bir parçasına dönüştürür.

Claude Code’un en güçlü tarafı yalnızca metin üretmesi değildir. Yerel proje dosyalarını okuyabilir, terminal komutlarını çalıştırabilir, kodu analiz edebilir ve gerekli izinler verildiğinde dosyalarda düzenleme yapabilir. Bu özellikler, onu klasik bir sohbet aracından farklılaştırır. Teknik SEO ekipleri Claude Code’u bir denetim asistanı, raporlama katmanı veya kontrollü düzeltme aracı olarak kullanabilir.

Ancak etkili bir sistem kurmak için “Sitemi SEO açısından kontrol et” şeklinde genel bir komut yeterli değildir. Denetimin kapsamını, veri kaynaklarını, hata kriterlerini, önceliklendirme yöntemini ve yapılabilecek değişikliklerin sınırlarını açık biçimde tanımlamak gerekir.

Claude Code Teknik SEO Sürecinde Nasıl Çalışır?

Claude Code ile teknik SEO süreci üç temel katmandan oluşur: veri toplama, değerlendirme ve uygulama.

Veri toplama aşamasında site tarama çıktıları, XML sitemap dosyaları, robots.txt, sunucu logları, PageSpeed raporları veya proje kaynak kodları sisteme aktarılır. Claude Code bu verileri doğrudan üretebilir ya da Screaming Frog, Lighthouse, Google Search Console API’si ve özel scriptler gibi araçların çıktıları üzerinden çalışabilir.

Değerlendirme aşamasında sistem, önceden tanımlanan SEO kurallarını uygular. Örneğin indekslenebilir bir URL’nin canonical etiketinin farklı bir adrese yönelmesi hata olarak sınıflandırılabilir. Aynı şekilde sitemap içinde 404 durum kodu döndüren URL bulunması kritik teknik problem sayılabilir.

Uygulama aşamasında Claude Code gerekli kod değişikliklerini hazırlayabilir. Fakat production ortamını etkileyen düzenlemelerde doğrudan otomatik uygulama yerine pull request oluşturmak daha güvenli bir yaklaşım sunar. Böylece SEO uzmanı ve geliştirici önerilen değişikliği inceleyebilir.

Claude Code’un GitHub Actions ve CI/CD sistemleriyle çalışabilmesi bu yapıyı sürekli bir denetim modeline dönüştürür. Her kod değişikliğinde belirli SEO testleri yeniden çalışır ve kritik bir hata varsa deployment süreci durabilir.

Claude Code ile Otomatik Site Denetimi Nasıl Kurulur?

Otomatik denetim kurarken ilk adım araç seçmek değil, denetim politikasını tanımlamaktır. Hangi sorunların kritik, hangilerinin uyarı ve hangilerinin bilgi seviyesinde olduğunu belirlemeden oluşturulan raporlar kısa sürede kalabalıklaşır.

Sağlıklı bir teknik SEO otomasyonu için şu beş aşamalı framework kullanılabilir:

1. Bul: Siteyi ve ilgili veri kaynaklarını tara.

2. Doğrula: Tespit edilen sorunun gerçek bir hata olup olmadığını kontrol et.

3. Önceliklendir: Trafik, indeksleme ve dönüşüm etkisine göre sınıflandır.

4. Düzelt: Güvenli değişiklikleri hazırla veya görev oluştur.

5. Yeniden test et: Değişiklik sonrası aynı kontrolü tekrar çalıştır.

Bu modelde denetim motoru ile karar motorunu birbirinden ayırmak önem taşır. Bir URL’nin 404 durum kodu vermesi gözlemdir. Bunun kritik hata olup olmadığı ise URL’nin backlink alıp almadığına, sitemap içinde bulunup bulunmadığına, trafik üretip üretmediğine ve yerine yönlendirilebilecek uygun bir sayfanın varlığına bağlıdır.

Başlangıç aşamasında Claude Code’a yalnızca rapor üretme yetkisi vermek daha doğru olur. Sistem yeterince test edildikten sonra düşük riskli değişiklikler için otomatik pull request hazırlama yetkisi eklenebilir.

Robots.txt ve XML Sitemap Kontrolü

Robots.txt ve XML sitemap dosyaları, arama motorlarının siteyi nasıl tarayacağını anlamasında önemli rol oynar. Bu dosyalardaki küçük bir hata binlerce URL’nin keşfedilmesini veya taranmasını etkileyebilir.

Claude Code şu kontrolleri otomatik biçimde yürütebilir:

• Robots.txt dosyasında yanlışlıkla engellenen önemli dizinleri bulmak

• Sitemap adresinin robots.txt içinde tanımlanıp tanımlanmadığını kontrol etmek

• Sitemap içindeki URL’lerin durum kodlarını doğrulamak

• Noindex etiketi taşıyan URL’lerin sitemap içinde bulunup bulunmadığını tespit etmek

• Canonical adresi farklı olan URL’leri işaretlemek

• HTTP, HTTPS ve www varyasyonlarını karşılaştırmak

• Eski veya yönlendirilmiş URL’leri bulmak

Burada yalnızca teknik eşleşme kontrolü yapmak yeterli değildir. Örneğin sepet ve hesap sayfalarının robots.txt ile engellenmesi bilinçli bir karar olabilir. Claude Code’un her engellenen dizini hata saymaması için proje bağlamını açıklayan kurallara ihtiyacı vardır.

Projenin kök dizininde yer alan bir CLAUDE.md dosyasında indekslenmesi gereken sayfa türleri, engellenmesi gereken dizinler ve tercih edilen domain yapısı tanımlanabilir. Böylece her denetimde aynı kurallar tekrar yazılmaz.

Status Code ve Kırık Bağlantı Analizi

Kırık bağlantı kontrolü teknik SEO otomasyonunun en kolay başlangıç noktalarından biridir. Ancak yalnızca 404 URL listesi oluşturmak gerçek kullanıcı sorununu çözmez.

Claude Code, kırık URL’leri şu bilgilere göre gruplandırabilir:

• Sitemap içinde bulunan kırık URL’ler

• Navigasyondan bağlantı alan URL’ler

• Blog içeriklerinden bağlantı alan URL’ler

• Harici backlink alan URL’ler

• Trafik üreten URL’ler

• Uygun yönlendirme hedefi bulunan URL’ler

• Bilinçli olarak kaldırılmış ve 410 dönmesi gereken URL’ler

Bu sınıflandırma, yüzlerce hatayı tek bir listede göstermek yerine iş etkisine göre sıralar.

Örneğin ürün kategorisinden bağlantı alan eski bir ürün URL’si yüksek öncelik taşıyabilir. Buna karşılık yıllar önce kaldırılmış, hiçbir iç bağlantısı ve trafiği bulunmayan bir kampanya URL’si daha düşük öncelikte kalabilir.

Claude Code burada otomatik olarak yönlendirme önerileri hazırlayabilir. Fakat her 404 URL’yi ana sayfaya yönlendirmek doğru değildir. Yönlendirme hedefi, eski URL’nin arama niyetiyle semantik olarak uyumlu olmalıdır.

Canonical ve Yönlendirme Zincirlerinin Denetlenmesi

Canonical hataları özellikle e-ticaret, filtreleme ve çok dilli site yapılarında görünürlük kaybına yol açabilir. Claude Code, kaynak kodu ve crawl çıktısını birlikte inceleyerek tutarsızlıkları belirleyebilir.

Kontrol senaryoları şunları kapsar:

• Canonical etiketi bulunmayan indekslenebilir sayfalar

• Birden fazla canonical etiketi

• 404 veya 5xx dönen canonical hedefleri

• Yönlendirilmiş URL’ye verilen canonical

• Noindex sayfaya verilen canonical

• HTTP sürüme işaret eden canonical

• Parametreli sayfaların yanlış ana URL’ye bağlanması

• Hreflang ile canonical arasındaki çelişkiler

Yönlendirme tarafında ise zincir ve döngü kontrolleri çalıştırılabilir. Bir URL önce başka bir URL’ye, ardından üçüncü bir adrese yönleniyorsa sistem doğrudan nihai hedefe giden yeni kural önerebilir.

Kısa Bir Proje İçgörüsü

Bir e-ticaret sitesinde kategori filtreleri için geliştirilen yeni URL yapısı, binlerce sayfanın canonical etiketini ana kategoriye çevirebilir. İlk bakışta bu durum duplicate content sorununu azaltıyor gibi görünür. Ancak önemli filtre sayfaları organik trafik getiriyorsa yapılan değişiklik indekslenebilir landing page’leri arama sonuçlarından çıkarabilir.

Claude Code bu tutarsızlığı tespit edebilir fakat filtre sayfalarının ticari değerini tek başına bilemez. Search Console tıklamaları, dönüşüm verileri ve anahtar kelime hedefleri de değerlendirmeye katılmalıdır. Bu örnek, teknik doğruluk ile SEO stratejisinin neden ayrı düşünülmemesi gerektiğini gösterir.

Meta Etiket ve Heading Kontrolleri

Claude Code, title, meta description, H1 ve heading yapısını geniş ölçekte kontrol edebilir. Bu senaryoda amaç yalnızca eksik alanları bulmak değil, şablon kaynaklı sorunları tespit etmektir.

Örneğin yüzlerce kategori sayfasında aynı title yapısının tekrar etmesi, CMS şablonundaki bir değişkenden kaynaklanabilir. Claude Code tekrar eden kalıbı analiz ederek sorunun tek tek sayfalarda değil, şablon seviyesinde bulunduğunu gösterebilir.

Kontrol listesi şu maddeleri içerebilir:

• Eksik veya yinelenen title

• Eksik H1

• Birden fazla H1

• Title ile H1 arasında konu uyumsuzluğu

• Aşırı kısa veya anlamsız meta description

• Sayfa niyetini karşılamayan başlıklar

• Ana içerik başlamadan kullanılan düzensiz heading yapısı

• Aynı şablondan kaynaklanan tekrarlar

Bu kontroller semantic SEO açısından da geliştirilebilir. Sistem yalnızca anahtar kelime varlığına bakmak yerine sayfanın ana entity’si, alt konuları ve kullanıcı sorularıyla başlık yapısı arasındaki ilişkiyi inceleyebilir.

Schema Markup Doğrulaması

Yapılandırılmış veri, arama motorlarının sayfadaki varlıkları ve içerik türünü daha net anlamasına yardımcı olur. Ancak hatalı schema kullanımı görünür bir fayda sağlamadığı gibi yanıltıcı işaretlemelere de yol açabilir.

Claude Code kaynak kodundaki JSON-LD bloklarını çıkarabilir ve şu kontrolleri yapabilir:

• Geçersiz JSON sözdizimi

• Eksik zorunlu alanlar

• Sayfada görünmeyen bilgilerin schema içinde bulunması

• Yanlış schema türü

• Birbiriyle çelişen Organization bilgileri

• Hatalı breadcrumb sıralaması

• Ürün stok ve fiyat verilerindeki tutarsızlık

• FAQ içeriğiyle FAQPage işaretlemesi arasındaki farklar

Schema kontrollerinde yalnızca teknik doğrulama değil, içerikle eşleşme de önem taşır. Sayfada kullanıcıya görünmeyen soruları FAQ schema içine eklemek doğru bir yaklaşım değildir.

Teknik denetim sırasında tespit edilen schema sorunları, schema markup hakkında daha ayrıntılı bir supporting içerikle ilişkilendirilebilir. Böylece blog cluster’ı hem teknik hem anlamsal açıdan güçlenir.

Core Web Vitals ve Performans Analizi

Claude Code, Lighthouse veya PageSpeed Insights çıktılarından yararlanarak performans sorunlarını sınıflandırabilir. Büyük JavaScript paketleri, render-blocking kaynaklar, optimize edilmemiş görseller ve layout shift oluşturan elementler raporlanabilir.

Ancak tek bir test sonucuna göre karar vermek doğru değildir. Laboratuvar verileri ile gerçek kullanıcı verileri farklı sonuçlar gösterebilir. Bu nedenle sistem şu ayrımı açık biçimde yapmalıdır:

• Lab data

• Field data

• Mobil sonuçlar

• Masaüstü sonuçlar

• Şablon bazlı problemler

• Sayfaya özel problemler

Claude Code, aynı şablonu kullanan sayfaları gruplandırarak geliştirici ekibine daha uygulanabilir görevler sunabilir. Örneğin 5.000 ürün sayfasında görülen aynı LCP problemi, 5.000 ayrı hata değil tek bir ürün şablonu sorunudur.

Internal Linking Analizi

Internal linking yalnızca sayfalar arasında bağlantı vermek anlamına gelmez. Site içi authority akışını, konu ilişkilerini ve kullanıcı yolculuğunu düzenler.

Claude Code şu bağlantı problemlerini tespit edebilir:

• Yetim sayfalar

• Çok az iç bağlantı alan önemli sayfalar

• Gereksiz derecede fazla bağlantı alan düşük değerli sayfalar

• Kırık iç bağlantılar

• Redirect veren bağlantılar

• Aynı anchor’ın ilgisiz sayfalara yönelmesi

• Bloglardan hizmet sayfalarına bağlantı bulunmaması

• Cluster içerikleri arasında semantik bağlantı eksikliği

Bu analizde URL sayısını tek ölçüt olarak kullanmak yanlış olur. Bir hizmet sayfasının yüzlerce sitewide footer bağlantısı alması, konu bağlamı güçlü blog bağlantıları aldığı anlamına gelmez.

Claude Code; sayfa başlıklarını, ana entity’leri ve içerik kümelerini inceleyerek bağlamsal bağlantı fırsatları önerebilir. Örneğin Claude SEO Agent hakkında hazırlanan bir içerikten teknik SEO otomasyonu yazısına bağlantı verilmesi doğal bir cluster ilişkisi oluşturur.

GEO ve AI Bot Erişim Kontrolleri

Teknik SEO otomasyonu artık yalnızca klasik arama motoru botlarıyla sınırlı kalmamalıdır. GEO, yani yapay zekâ arama optimizasyonu, içeriğin yapay zekâ sistemleri tarafından erişilebilir, anlaşılabilir ve güvenilir biçimde yorumlanmasını hedefler.

Claude Code şu GEO kontrollerini destekleyebilir:

• Robots.txt içinde AI botlarına yönelik kurallar

• Önemli içeriklerin JavaScript arkasında kalıp kalmadığı

• Ana cevabın sayfada açık biçimde bulunması

• Entity bilgilerinin tutarlılığı

• Yazar ve yayıncı bilgilerinin görünürlüğü

• Schema ile görünen içerik arasındaki uyum

• İçeriğin sorulara doğrudan cevap veren bölümleri

• Kaynak ve referans yapısı

• Eski bilgilerin güncellik kontrolü

SEO ve GEO birbirinden tamamen ayrı iki süreç değildir. Crawl edilemeyen, yavaş açılan veya ana içeriğini doğru sunmayan bir sayfa hem klasik arama motorlarında hem de AI destekli arama deneyimlerinde dezavantaj yaşayabilir.

Bu nedenle teknik SEO denetim sistemi içinde GEO kontrollerine ayrı bir modül eklemek, uzun vadeli görünürlük stratejisini güçlendirir.

Claude Code ile gerçekleştirilen bot, schema ve içerik kontrolleri; uzman bir GEO Ajansı tarafından hazırlanan stratejiyle birleştiğinde SEO, GEO ve AI Overview görünürlüğü ortak bir sistem üzerinden yönetilebilir.

GitHub Actions ve Hooks ile Sürekli SEO Denetimi

Claude Code’un en değerli kullanım alanlarından biri, teknik SEO kontrollerini yalnızca aylık audit dönemlerinde değil, geliştirme sürecinin içinde çalıştırmaktır.

GitHub Actions üzerinden her pull request açıldığında şu testler tetiklenebilir:

• Canonical etiketleri değişti mi?

• Robots.txt dosyasında kritik bir engelleme oluştu mu?

• Sitemap üretimi bozuldu mu?

• Yeni sayfa şablonunda title veya H1 eksik mi?

• Schema JSON’ı geçerli mi?

• Internal link yapısında kırık bağlantı oluştu mu?

• Performans bütçesi aşıldı mı?

Kritik kurallardan biri başarısız olduğunda sistem deployment işlemini durdurabilir veya pull request içine uyarı bırakabilir.

Hooks ise Claude Code’un belirli araç çağrılarından önce veya sonra deterministik kontroller çalıştırmasını sağlar. Örneğin sistem, robots.txt dosyasını değiştirmeden önce özel bir doğrulama scripti çalıştırabilir. Test başarısız olursa değişikliği engelleyebilir.

Bu yaklaşım, prompt tabanlı talimatlarla teknik kural uygulama arasındaki farkı gösterir. Prompt, modele nasıl davranması gerektiğini anlatır. Hook ise belirli bir kuralı kod seviyesinde zorunlu kılar.

Teknik SEO Otomasyonunda En Sık Yapılan Hatalar

Belirsiz Promptlarla Denetim Yapmak

“Sitedeki bütün SEO hatalarını bul” komutu kapsamı belirsiz bırakır. Sistem hangi URL’leri, hangi ortamı, hangi kuralları ve hangi veri kaynaklarını kullanacağını bilemez.

Daha güçlü bir görev tanımı şu bilgileri içerir:

• Denetlenecek ortam

• URL kapsamı

• Hariç tutulacak dizinler

• Kritik hata kuralları

• Rapor formatı

• Yapılabilecek işlemler

• Yapılamayacak işlemler

• Başarı kriterleri

Her Öneriyi Otomatik Uygulamak

Claude Code kod değiştirebildiği için bulunan her sorunu otomatik düzeltmek cazip görünebilir. Ancak canonical, redirect, noindex ve robots.txt gibi alanlardaki yanlış bir değişiklik ciddi organik trafik kaybına yol açabilir.

Düşük riskli işlemler otomatikleştirilebilir. Yüksek riskli işlemler için insan onayı ve pull request incelemesi gerekir.

İş Etkisini Dikkate Almamak

Binlerce düşük değerli hata, tek bir kritik indeksleme sorunundan daha önemsiz olabilir. Denetim sistemi yalnızca hata sayısını değil şu verileri de değerlendirmelidir:

• Organik trafik

• Dönüşüm

• Backlink

• Sayfa tipi

• İndekslenme durumu

• İç bağlantı seviyesi

• Ticari önem

• Sorundan etkilenen URL sayısı

AI Çıktısını Tek Doğruluk Kaynağı Kabul Etmek

Claude Code güçlü bir analiz aracı olsa da bağlamı eksik yorumlayabilir, yanlış öncelik verebilir veya teknik olarak geçerli fakat stratejik olarak hatalı bir öneri sunabilir.

Bu nedenle her kritik bulgu en az bir bağımsız veri kaynağıyla doğrulanmalıdır. Crawl verisi, Search Console, log dosyaları, analytics ve kaynak kod birlikte değerlendirilmelidir.

Claude Code SEO Uzmanının Yerini Alır mı?

Claude Code teknik SEO uzmanının yerini almaz. Tekrarlanan kontrolleri hızlandırır, büyük veri kümelerini sınıflandırır, kod değişikliği önerir ve raporlama yükünü azaltır. Buna karşılık iş hedeflerini, arama niyetini, ticari sayfa önceliklerini ve risk seviyesini kendi başına güvenilir biçimde belirleyemez.

En verimli model, Claude Code’u uzman kararını destekleyen bir uygulama ve denetim katmanı olarak kullanır.

SEO uzmanı şu sorulara cevap verir:

• Hangi sayfalar indekslenmeli?

• Hangi hata ticari kayıp oluşturuyor?

• Hangi URL yapısı korunmalı?

• Hangi içerik cluster içinde öncelik taşıyor?

• Hangi teknik değişiklik kullanıcı deneyimini etkiliyor?

• SEO ve GEO hedefleri nasıl birlikte yönetilmeli?

Claude Code ise belirlenen kuralları geniş ölçekte kontrol eder, tutarsızlıkları bulur ve uygulanabilir görevler hazırlar.

Teknik SEO süreçlerini yalnızca hata raporlarıyla değil, stratejik önceliklendirme ve ölçülebilir uygulama planıyla yönetmek isteyen işletmeler profesyonel SEO danışmanlığından yararlanabilir. Web sitesinin klasik arama sonuçlarıyla birlikte AI Overviews ve üretken yapay zekâ platformlarında görünürlüğünü geliştirmek isteyen markalar ise SEO ve GEO çalışmalarını ortak bir teknik altyapı üzerinde ele almalıdır.

Otomatik Teknik SEO Denetimi Checklist’i

Claude Code tabanlı bir sistem yayına alınmadan önce şu maddeler kontrol edilmelidir:

• Denetimin URL kapsamı açıkça tanımlandı mı?

• Production ve test ortamları ayrıldı mı?

• Kritik hata kuralları belirlendi mi?

• False positive kontrolü yapıldı mı?

• Otomatik değişiklik yetkileri sınırlandırıldı mı?

• Yüksek riskli işlemler için insan onayı bulunuyor mu?

• Her bulguya önem seviyesi atanıyor mu?

• Search Console ve crawl verileri birlikte değerlendiriliyor mu?

• Düzeltme sonrası yeniden test çalışıyor mu?

• Yapılan değişiklikler kayıt altına alınıyor mu?

• Rollback planı bulunuyor mu?

• SEO ve GEO kontrolleri ayrı raporlanıyor mu?

Bu checklist, aracı yalnızca hızlı değil aynı zamanda kontrollü kullanmaya yardımcı olur.

Sıkça Sorulan Sorular

1. Claude Code web sitesini doğrudan tarayabilir mi?

Claude Code terminal araçları, özel scriptler veya crawler çıktıları üzerinden web sitesini tarayabilir ve analiz edebilir. Büyük sitelerde özel crawler, Screaming Frog veya benzeri araçlardan alınan verilerle birlikte kullanmak daha kapsamlı sonuç verir.

2. Claude Code Screaming Frog yerine geçer mi?

Claude Code ve Screaming Frog farklı işlevler taşır. Screaming Frog site tarama ve teknik veri toplama konusunda uzmanlaşır. Claude Code ise bu verileri yorumlayabilir, sınıflandırabilir, farklı kaynaklarla birleştirebilir ve kod değişikliği hazırlayabilir. İki aracı birlikte kullanmak daha güçlü bir iş akışı oluşturur.

3. Claude Code teknik SEO hatalarını otomatik düzeltebilir mi?

Claude Code uygun yetkiler verildiğinde kaynak kodda ve yapılandırma dosyalarında düzenleme yapabilir. Ancak canonical, redirect, noindex ve robots.txt gibi yüksek riskli değişiklikler insan onayından geçmelidir. Otomatik pull request modeli doğrudan production değişikliğinden daha güvenlidir.

4. Claude Code GEO çalışmalarında kullanılabilir mi?

Evet. Claude Code AI bot erişimini, robots.txt kurallarını, yapılandırılmış verileri, entity tutarlılığını ve içeriğin doğrudan cevap yapısını kontrol etmek için kullanılabilir. Bu denetimler GEO ve AI Overview görünürlüğünü destekleyen teknik altyapının değerlendirilmesine yardımcı olur.

5. Teknik SEO otomasyonunda insan kontrolü gerekli mi?

Evet. Otomasyon sorunları bulabilir ve çözüm önerileri hazırlayabilir; ancak ticari öncelik, arama niyeti, marka riski ve kullanıcı etkisi gibi kararlar uzman değerlendirmesi gerektirir. En güvenli sistem, otomatik denetimi insan onayı ve bağımsız veri doğrulamasıyla birleştirir.