URL Inspection API ile İndeks Kontrol Otomasyonu Kurulumu

Her gün onlarca URL’yi Search Console arayüzünden tek tek denetlemek, kısa sürede darboğaza dönüşür. Asıl sorun zaman değil, tutarsızlıktır; bugün baktığınız sayfayı yarın aynı şekilde takip edemezsiniz.

İyi kurulan bir URL Inspection API otomasyonu, kritik sayfaları sıraya alır, sonuçları kaydeder ve bozulma olduğunda haber verir. Bu işi sağlıklı yapmak için önce API’nin ne yaptığını, ne yapmadığını netleştirmek gerekir.

Önce API’nin sınırlarını doğru koyun

URL Inspection API, büyük sitelerde “tüm siteyi her gün tara” aracı değildir. Daha çok teşhis, doğrulama ve değişim takibi için uygundur. Yani yeni yayımlanan içerikleri, gelir getiren açılış sayfalarını, teknik değişiklikten etkilenen URL’leri ve index kaybı riski taşıyan sayfaları izlemek için idealdir.

2026 itibarıyla sahada en çok karşılaşılan sınırlar şunlar:

Başlık	Güncel pratik	Neden önemli
Günlük kota	Property başına 2.000 denetim	Büyük sitelerde önceliklendirme şart
Hız limiti	Dakikada 600 istek	Kuyruk ve hız kontrolü gerekir
Yetki	Doğrulanmış Search Console property erişimi	Hesap yetkisi yoksa sorgu dönmez
Kapsam	Tekil URL denetimi	Toplu indeks sayımı için uygun değil

Buradaki kritik nokta, kotanın property bazlı olmasıdır. Başka bir deyişle, aynı mülkte farklı kullanıcılarla sorgu açmanız sınırı ortadan kaldırmaz. Ayrıca aynı URL’yi peş peşe sorgulamak da indekslemeyi hızlandırmaz. API size durum raporu verir, indeks talebi göndermez.

Aynı URL’yi defalarca denetlemek, dizine alınma sürecini hızlandırmaz. Bu API’nin işi teşhis koymaktır.

Bu yüzden otomasyonu kurarken “hangi URL’ler gerçekten izlenmeli?” sorusunu baştan çözmelisiniz. Blogda yeni yayımlanan içerikler, ürün sayfaları, kategori şablonları, migration sonrası taşınan adresler ve canonical riski olan sayfalar genelde ilk sıradadır.

Kurulum için gereken yetki ve mimari

Kurulum tarafında en sık hata, Google Cloud tarafını doğru hazırlayıp Search Console yetkisini eksik bırakmaktır. Oysa iki taraf birlikte çalışır. Cloud projesi API erişimini açar, Search Console property yetkisi ise veriye erişmenizi sağlar.

Pratik kurulum akışı genelde şöyle ilerler:

1. Search Console’da ilgili siteyi doğrulayın. Mümkünse domain property kullanın, çünkü protokol ve alt alan adı farklarını daha rahat yönetirsiniz.
2. Google Cloud’da bir proje açın ve URL Inspection erişimi için gerekli API kullanımını etkinleştirin.
3. Sunucu tarafında çalışacaksanız bir servis hesabı oluşturun.
4. Servis hesabının e-posta adresini Search Console property’sine yetkili kullanıcı olarak ekleyin.
5. Anahtar dosyasını repoya koymayın. Secret Manager, çevre değişkeni veya güvenli kasa kullanın.
6. URL kaynağını belirleyin; CMS, sitemap, veri ambarı ya da yayın akışı olabilir.

siteUrl alanı burada önemlidir. Domain property kullanıyorsanız genelde sc-domain: biçimi gerekir. URL-prefix property kullanıyorsanız tanımlı prefix ile birebir eşleşme beklenir. http ve https farkı, www varyasyonu ve sonda slash kullanımı yüzünden çok kişi boşuna hata alır.

Bir ayrımı da net tutun: URL Inspection API, durum kontrolü içindir. Yayın sonrası manuel bildirim mantığıyla karıştırılmamalı. Bu farkı görmek için Node.js ile Google Indexing API kullanımına dair örnek faydalı olur; ancak o akış ayrı bir API ve ayrı bir kullanım alanıdır.

İlk çağrı, örnek yanıt ve karar mantığı

İlk istek gövdesinde genelde üç temel alan bulunur: inspectionUrl, siteUrl ve isteğe bağlı olarak languageCode. Buradaki mantık basittir. Denetlenecek tam sayfa adresini verirsiniz, ardından bu adresin bağlı olduğu doğrulanmış property bilgisini eklersiniz.

Yanıtta genelde şu başlıklar işinize yarar:

• verdict, genel sonucun özetidir.
• coverageState, dizin kapsamı durumunu insan tarafından okunabilir biçimde gösterir.
• indexingState, URL’nin indekslenebilir olup olmadığını anlatır.
• lastCrawlTime, Google’ın son tarama zamanını verir.
• pageFetchState, sayfa erişiminde sorun olup olmadığını gösterir.
• robotsTxtState, robots engelini ayırmanızı sağlar.
• googleCanonical ve userCanonical, canonical çatışmasını yakalamanıza yardım eder.
• Mobil kullanılabilirlik ve zengin sonuç verileri de dönebilir.

Otomasyonun değeri, bu alanları kaydetmekten çok karar kurallarına çevirmekte ortaya çıkar. Örnek bir karar motoru şu mantıkla çalışabilir: yeni içerik 48 saat sonra hâlâ indekslenmediyse uyarı üret, kullanıcı canonical’ı ile Google canonical’ı farklıysa teknik inceleme kuyruğuna at, pageFetchState başarısızsa geliştirme ekibine hata kaydı aç, durum bir önceki denetime göre kötüleştiyse Slack mesajı gönder.

Burada bir ayrıntı daha var. Search Console arayüzündeki “canlı test” beklentisini API’ye taşımayın. URL Inspection API’yi anlık tarayıcı gibi değil, indeks ve denetim verisini işleyen bir sinyal kaynağı gibi düşünün. Bu yüzden her tetikte tekrar tekrar çağrı yapmak yerine, belirli zaman pencereleri tanımlayın.

En iyi kurallar, teknik açıdan anlamlı ve kota açısından ölçülü kurallardır.

İlk aşamada şu üç tetik çoğu ekip için yeterli olur: yeni yayımlanan URL, şablon değişikliği sonrası örnek URL seti ve trafik getiren sayfalarda durum değişimi.

Python veya Apps Script ile otomasyon akışı

Dil bağımsız mantık değişmez. Önce URL listesini toplarsınız, sonra temizlersiniz, önceliklendirirsiniz, kota ve hız limitine göre sıraya koyarsınız. Ardından API çağrısını yapar, sonucu tabloya ya da veri tabanına yazarsınız. Son adımda da eşik kurallarını işletirsiniz.

Python tarafı, orta ve büyük ölçekli akışlar için daha rahattır. Çünkü servis hesabı yönetimi, zamanlanmış görev, kuyruk, yeniden deneme ve veri işleme tarafında daha esnektir. Günlük yayınları CMS’den çekip cron, Cloud Run ya da benzeri bir zamanlayıcıyla çalıştırabilirsiniz. Sonuçları Sheets, BigQuery, PostgreSQL veya basit CSV çıktısına yazmanız da kolaydır.

Apps Script ise küçük ve orta hacimde hızlı çözüm verir. Search Console verisini bir Google Sheet içinde takip etmek istiyorsanız, zaman tetikleyicileriyle günlük kontrol kurmak pratiktir. Fakat kota daralınca ve logik büyüyünce Python tarafı daha temiz kalır.

Hangi dili seçerseniz seçin, üç teknik kuralı sabit tutun. İlk olarak, istekleri toplu değil kuyruk mantığıyla yönetin. İkinci olarak, geçici hatalarda exponential backoff uygulayın. Üçüncü olarak, her sonucun ham çıktısını saklayın. Çünkü bir hafta sonra yaşanan index kaybında “ne değişti?” sorusunun cevabı çoğu zaman eski yanıttadır.

URL listesini seçerken, otomasyonu kör çalıştırmayın. Önceliklendirmeyi bir kapsamlı web sitesi SEO analizi ile beslerseniz, kotayı gerçekten değerli sayfalara ayırırsınız.

Raporlama, alarmlar ve sık hata senaryoları

İyi bir URL Inspection API otomasyonu, sadece veri toplamaz; değişimi görünür kılar. En faydalı raporlar şunlardır: son 7 günde index durumunu kaybeden sayfalar, canonical uyuşmazlığı artan şablonlar, son tarama tarihi çok geride kalan önemli URL’ler ve sayfa tipi bazında denetim sonucu dağılımı.

Alarm mantığında sade kalın. Her düşüş için bildirim göndermeyin. Bunun yerine yüksek değerli URL’lerde durum bozulduğunda, aynı şablonda belirli sayıda hata biriktiğinde veya yayından sonra belirlediğiniz sürede dizine alınma görülmediğinde bildirim üretin. Kurumsal ekiplerde bu akışı kurumsal SEO hizmetleri ile bir operasyon paneline bağlamak daha verimli olur.

Sahada en çok görülen hata senaryoları da benzerdir:

• permission denied benzeri hatalar, çoğu zaman property yetkisinin eksik olmasından çıkar.
• invalid argument türü hatalar, siteUrl ile denetlenen URL’nin aynı property altında olmamasından kaynaklanır.
• Kota aşımı, aynı gün fazla denetim yapıldığında gelir; çözüm, URL’leri günlere bölmektir.
• Geçici sunucu hatalarında kısa aralıklarla yeniden denemek yerine artan bekleme süresi kullanın.
• Canonical çakışması varsa sorun API’de değil, sayfanın kendi sinyal setindedir.

Benzer vakaları Google Search Console yardım topluluğundaki bu dizine alınmama örneğinde de görmek mümkün. Ayrıca aynı panoda Search Analytics verisi kullanıyorsanız, o uç noktanın ayrı kota kuralları olduğunu unutmayın. URL Inspection verisiyle arama performansı verisini tek limit gibi düşünmek yanlış planlamaya yol açar.

Son not

Elle kontrol, küçük sitelerde bir süre idare eder. Fakat ekip büyüdükçe ve URL sayısı arttıkça, düzenli çalışan bir URL Inspection API otomasyonu çok daha güvenilir hale gelir.

Doğru kurulumun özü basit: yetkiyi eksiksiz verin, kritik URL’leri seçin, kotayı koruyun ve sonucu rapora bağlayın. Böyle kurulan bir sistem, index sorunlarını geç fark etmek yerine erken yakalamanızı sağlar.

This post may contain affiliate links. If you make a purchase through these links, I may earn a small commission at no extra cost to you.