Cantürk Çelikok
Tüm yazılarYapay Zeka

Claude SEO nedir, nasıl kurulur? Claude Code için SEO eklentisi

Cantürk Çelikok • • 5 dk okuma

Claude SEO nedir, nasıl kurulur? Claude Code için SEO eklentisi

Claude SEO nedir?

Claude SEO, Claude Code'a eklenen ücretsiz ve açık kaynaklı bir SEO denetim eklentisi. Agrici Daniel tarafından geliştiriliyor ve MIT lisansıyla yayınlanıyor. Bir web sitesinin adresini veriyorsunuz, eklenti siteyi teknik SEO, içerik kalitesi, yapılandırılmış veri ve yapay zeka aramalarında görünürlük açısından inceliyor ve önem sırasına göre dizilmiş bir eylem planı çıkarıyor.

Eklenti tek bir büyük talimat dosyasından değil, 26 alt skill ve 19 uzman ajandan oluşuyor. Tam bir site denetimi başlattığınızda bu ajanların bir kısmı aynı anda çalışıyor: biri teknik altyapıya, biri içeriğe, biri yapılandırılmış veriye bakıyor. Projenin README'sine göre tam bir denetim 10 ile 15 dakika sürüyor.

Bu yazıda Claude SEO'nun neleri kontrol ettiğini, nasıl kurulduğunu ve hangi komutların ne işe yaradığını anlatıyorum.

Neleri kontrol ediyor?

Teknik SEO. Taranabilirlik, dizine eklenme, site haritaları, robots.txt, yönlendirmeler, sayfa hızı ve Core Web Vitals.

İçerik kalitesi. Google'ın E-E-A-T olarak adlandırdığı deneyim, uzmanlık, otorite ve güvenilirlik sinyalleri, zayıf içerikli sayfalar ve konu kapsamı.

Yapılandırılmış veri. Sayfalardaki Schema.org işaretlemesini buluyor, doğruluyor ve eksik olanlar için yeni işaretleme yazıyor.

Yapay zeka araması (GEO). Google AI Overviews, AI Mode, ChatGPT, Perplexity ve Gemini gibi yapay zeka destekli arama araçlarının sayfalarınızı kaynak gösterme olasılığını değerlendiriyor. Yapay zeka tarayıcılarının siteye erişip erişemediğini de kontrol ediyor.

Yerel ve e-ticaret SEO. Google İşletme Profili, yorumlar, harita sonuçları, ürün sayfaları ve çok dilli siteler.

Sayfanın içeriği JavaScript ile yükleniyorsa, yani site Next.js, React ya da Vue ile yazılmışsa, eklenti sayfayı arka planda çalışan bir tarayıcıda açıyor. Böylece tek sayfa uygulamaları da ziyaretçinin gördüğü haliyle denetleniyor.

Gereksinimler

Claude Code 1.0.33 ya da daha yeni bir sürüm. Eklenti Claude Code'un içinde çalışıyor, ayrı bir program değil.

Python 3.11 ile 3.14 arasında bir sürüm. Eklenti kendi Python ortamını kuruyor ama bilgisayarınızda Python'un yüklü olması gerekiyor.

Bir Claude planı. Eklentinin kendisi ücretsiz ama çalışırken Claude Code planınızın kullanım hakkını harcıyor. Daha fazla değerlendirme gerektiren beş ajan Opus, geri kalanlar Sonnet modeliyle çalışıyor. Bu yüzden tam bir site denetimi, tek bir sayfayı incelemekten belirgin şekilde daha fazla kullanım hakkı tüketiyor.

Google API anahtarı ya da başka bir ücretli servis gerekmiyor. Bunlar isteğe bağlı eklentiler olarak sonradan bağlanabiliyor.

Kurulum

En kolay yol Claude Code'un eklenti sistemi. Claude Code'u açıp şu üç komutu sırayla yazmanız yeterli:

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup

İlk komut projenin eklenti pazarını Claude Code'a ekliyor, ikincisi eklentiyi kuruyor. Üçüncü komut olan /seo setup, eklentinin ihtiyaç duyduğu ayrı bir Python ortamını ve arka planda çalışan tarayıcıyı (Chromium) hazırlıyor. Bu kurulum sisteminizdeki diğer Python paketlerine dokunmuyor.

Kurulumun doğru tamamlandığını kontrol etmek için:

/seo doctor

Bu komut hiçbir şeyi değiştirmeden çalışma ortamının hazır olup olmadığını raporluyor. Bir şey ters giderse ilk bakılacak yer burası.

Elle kurulum

Eklenti sistemini kullanmak istemiyorsanız, depoyu indirip kurulum betiğini kendiniz çalıştırabilirsiniz. macOS ve Linux'ta:

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh

Windows'ta PowerShell ile:

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1

Projenin Windows için irm ... | iex gibi tek satırlık bir komut yerine git clone önermesinin bir nedeni var. İnternetten indirilen bir betiği okumadan doğrudan çalıştırmak, Claude Code'un kendi güvenlik kontrollerinin de risk olarak işaretlediği bir yöntem. Depoyu önce indirmek, install.ps1 dosyasını çalıştırmadan önce açıp okuyabilmenizi sağlıyor. Başkasının yazdığı bir kurulum betiğini çalıştırmadan önce bir göz atmak iyi bir alışkanlık.

İlk denetim

Kurulumdan sonra Claude Code'u başlatıp bir site adresi vermeniz yeterli:

claude
 
/seo audit https://ornekmagaza.com

Bütün komutların listesini görmek için yalnızca /seo yazabilirsiniz.

Bir denetim üç adımda ilerliyor:

  1. Siteyi tanıyor. Eklenti önce sitenin türünü (SaaS, yerel işletme, e-ticaret, yayıncı ya da ajans) belirliyor ve kontrollerini buna göre ayarlıyor.
  2. Ajanlar paralel çalışıyor. README'ye göre en fazla 17 uzman ajan siteyi aynı anda inceliyor.
  3. Önceliklendirilmiş bir plan çıkıyor. Bulgular puanlanıp önem sırasına diziliyor. Her öneride neye dayandığı, neye bağlı olduğu ve işe yarayıp yaramadığını nasıl anlayacağınız yazıyor.

Raporlar Markdown dosyası olarak bilgisayarınıza kaydediliyor. Google API'lerini bağladıysanız, /seo google report komutuyla PDF rapor da üretebiliyorsunuz.

En çok işe yarayan komutlar

Eklentide 30'a yakın komut var. Hepsini bilmeniz gerekmiyor, çoğu iş için şunlar yetiyor.

/seo audit <url> sitenin tamamını denetliyor. İlk çalıştırmanız gereken komut bu.

/seo page <url> tek bir sayfayı ayrıntılı olarak inceliyor. Yeni yayımladığınız bir blog yazısını ya da bir ürün sayfasını kontrol etmek için tam denetimden çok daha hızlı ve daha az kullanım hakkı harcıyor.

/seo technical <url> yalnızca teknik SEO'ya, dokuz kategori altında bakıyor.

/seo schema <url> sayfadaki yapılandırılmış veriyi bulup doğruluyor ve eksik işaretlemeyi JSON-LD olarak yazıyor. Ürün sayfası yapılandırılmış veri rehberinde anlattığım şemaları elle yazdıktan sonra kontrol etmek için de kullanılabilir.

/seo content <url> içerik kalitesini ve E-E-A-T sinyallerini değerlendiriyor.

/seo geo <url> sayfalarınızın yapay zeka aramalarında kaynak gösterilmeye ne kadar hazır olduğunu puanlıyor. Yapay zeka tarayıcılarının erişimini ve markanızın Wikipedia, Reddit, YouTube ve LinkedIn gibi platformlardaki varlığını da kontrol ediyor.

/seo ecommerce <url> ürün sayfalarına, ürün şemasına ve Google Alışveriş görünürlüğüne odaklanıyor. Merchant Center ile çalışan bir mağaza için iyi bir başlangıç noktası.

/seo drift baseline <url> bir sayfanın SEO açısından önemli öğelerinin anlık görüntüsünü kaydediyor. Daha sonra /seo drift compare <url> ile bu görüntüyü güncel haliyle karşılaştırıp, örneğin bir tema güncellemesinin başlıkları ya da şemayı bozup bozmadığını görebiliyorsunuz.

Komutların tam listesi projenin komut belgesinde bulunuyor.

Google verilerini bağlamak

Eklenti hiçbir API anahtarı olmadan çalışıyor ama bu durumda bazı ölçümler tahmine dayanıyor. Core Web Vitals değerleri gerçek kullanıcı verisi yerine laboratuvar ölçümü oluyor, bir sayfanın dizinde olup olmadığı da sayfanın kendisinden çıkarılıyor.

Gerçek verilerle çalışmak isterseniz Google'ın ücretsiz API'lerini (PageSpeed Insights, Chrome UX Report, Search Console ve Google Analytics 4) bağlayabilirsiniz:

/seo google setup

Projenin belgelerine göre anahtarlar yalnızca sizin bilgisayarınızda saklanıyor. Search Console bağlandıktan sonra denetimler, sitenizin gerçek arama performansını da hesaba katıyor.

Bilmeniz gerekenler

Verileriniz Claude'a gidiyor. Eklenti Claude Code'un içinde çalıştığı için incelenen sayfalar ve veriler, Claude Code'da yaptığınız diğer her iş gibi Anthropic'in modeline gönderiliyor. Raporlar sizin bilgisayarınızda kalıyor. Bir eklenti ya da API bağlamadığınız sürece başka bir SEO servisi verilerinizi görmüyor. Bazı kontroller Wikipedia, Reddit ve Common Crawl gibi herkese açık kaynakları da okuyor. Ayrıntılar projenin PRIVACY.md dosyasında.

Klasik tarayıcıların yerini almıyor. Screaming Frog gibi tarama araçları siteyi çok daha hızlı ve derin tarıyor, büyük SEO platformlarının da kendi backlink veritabanları var. Claude SEO'nun farkı, bulduğu sorunları açıklaması, etkisine göre sıralaması ve sonuçlar hakkında düz Türkçeyle soru sorabilmeniz. İkisini birlikte kullanmak mümkün.

Bazı sayfalar gürültülü sonuç verebiliyor. Asıl içeriği yalnızca kaydırma ya da tıklamadan sonra yükleyen sayfalarda bulgular eksik ya da hatalı olabiliyor.

Önerileri körü körüne uygulamayın. Eklenti her öneriyi neden yaptığını açıklıyor. Bir değişikliği yapmadan önce bu açıklamayı okumak ve kendi sitenizin durumuna uyup uymadığını düşünmek gerekiyor. Özellikle robots.txt ve yönlendirme gibi siteyi bütünüyle etkileyen değişikliklerde.

Kaldırma

Eklenti sistemiyle kurduysanız:

/plugin uninstall claude-seo@agricidaniel-claude-seo

Elle kurduysanız, depodaki kaldırma betiğini çalıştırmanız gerekiyor:

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/uninstall.sh

Bilgiler Claude SEO'nun 2.6.0 sürümüne ve projenin GitHub deposundaki belgelere göre 13 Kasım 2026 tarihinde kontrol edildi. Komutlar ve gereksinimler yeni sürümlerde değişebilir.

Cantürk Çelikok

Ankara'da freelance full stack yazılım geliştirici. PlusTurk, Nerdesin, Ayda POS ve Songnaria Coffee gibi canlı ürünleri uçtan uca geliştirdi; burada bu projelerden çıkan notları paylaşıyor.

Hakkımda