SEOAsist Site API ile özel yazılım siteni bağlama

Siten WordPress veya Shopify değilse (Next.js, Laravel, .NET, düz PHP…), sitene küçük bir API ekleyerek SEO işlerini SEOAsist'e devredebilirsin. Bağlantı kurulduktan sonra başlık, açıklama, canonical, robots, yapısal veri ve yönlendirme düzeltmeleri sunucu tarafında uygulanır; blog yazıları yayınlanır, llms.txt güncellenir. Eklenti ya da pull request gerekmez.

#Ön koşullar

• Sitenin kodunu değiştirebilmelisin (sen, bir geliştirici ya da Claude/Cursor gibi bir AI kod asistanı).
• Sitenin ortam değişkenlerine (.env veya barındırma paneli) erişimin olmalı.
• Panelde düzenleme yetkin olmalı; yoksa “Bu işlem için düzenleme yetkisi gerekir.” uyarısı çıkar.

#1. API'yi siteye kur

1. Siteler sayfasından siteyi aç ve Düzeltme kanalları sekmesine geç.
2. En üstteki SEOAsist Site API (özel yazılım siteler) kartında Kurulum promptu düğmesine bas.
3. Açılan pencerede Kopyala'ya bas ve metni projende çalışan Claude, Cursor veya geliştiricine ver. Prompt, tam spesifikasyonu ve bu siteye özel bilgileri (site adresi, API taban adresi, varsa bağlı GitHub deposu) içerir.
4. Kendin kodlamak istiyorsan Geliştirici kılavuzu düğmesine bas. Pencerede Adımlar, Spesifikasyon, Next.js, PHP ve Test sekmeleri var; hazır kodları kopyalayıp başlayabilirsin.

Sitede tek bir taban yol altında dört uç nokta açılır: GET /manifest, PUT /rules, POST /content, PUT /files. Ayrıntılar için Site API teknik referansı makalesine bak.

#2. Adresi kaydet ve token'ı ekle

1. Kartın altındaki API taban adresi alanına API'nin adresini yaz. Varsayılan öneri https://<alan-adın>/api/seoasist biçimindedir.
2. Bağla'ya bas. Sarı kutuda Token — yalnızca şimdi gösteriliyor başlığıyla SEOASIST_SITE_TOKEN=sa_… satırı çıkar.
3. Kopyala'ya bas ve bu satırı sitenin ortam değişkenlerine ekle. Ardından siteyi yeniden başlat ya da yeniden yayınla.

#3. Bağlantıyı test et

1. İstersen önce Geliştirici kılavuzu → Test sekmesindeki curl komutuyla /manifest adresini dene.
2. Kartta Bağlantıyı test et'e bas. SEOAsist /manifest uç noktasını çağırır ve sitenin hangi yetenekleri desteklediğini kaydeder.
3. Test başarılıysa “Bağlantı başarılı · yetenekler: … · N kural gönderildi” mesajı çıkar. Bekleyen tüm etkin kurallar o anda siteye gönderilir.

#Bağlandıktan sonra ne olur?

Durum satırında sitenin bildirdiği yetenekler görünür: SEO kuralları, İçerik yayını ve llms.txt / robots. Her biri ayrı çalışır; site hangisini bildirdiyse o kullanılır.

Kartta elle tetiklemek için iki düğme de var: Kuralları şimdi gönder (N) ve llms.txt gönder. llms.txt düğmesi, önce AI erişimi sekmesinde llms.txt üretmeni ister.

#Teknik Denetim'de otomatik düzeltme

Site API “SEO kuralları” yeteneğiyle bağlıysa Teknik Denetim sayfasında bazı sorunların yanında Otomatik düzelt düğmesi çıkar. Desteklenen sorunlar: eksik, çok uzun, çok kısa veya tekrarlayan title; eksik, çok uzun veya tekrarlayan meta description; eksik veya başka sayfayı gösteren canonical; eksik html lang; noindex ile işaretli sayfalar.

Düğmeye basınca SEOAsist son taramadaki etkilenen sayfalar için (en fazla 40) değer üretir. Title ve açıklamaları AI yazar; canonical, lang ve robots değerleri doğrudan hesaplanır. Bunlar kural olarak siteye gönderilir ve bir doğrulama taraması başlar. Aynı sorun için tekrar çalıştırırsan önceki kurallar silinip yenileriyle değiştirilir. Ayrıntılar: Kasıtlı sorunlar ve otomatik düzeltme.

#Doğrulama

• Kartın durum satırında yeşil Bağlı yazmalı, yanında yetenek etiketleri ve “son gönderim N kural” görünmeli.
• Sitenin bir sayfasının kaynak kodunu (tarayıcıda “Sayfa kaynağını görüntüle”) aç; uygulanan title veya meta description HTML'de görünmeli. Kurallar istemci tarafı JavaScript ile değil, sunucu tarafında uygulanmalıdır.
• Bir hata olursa durum kırmızı Hata olur ve son hata mesajı kartta görünür. Çözüm için Site API bağlantı sorunları makalesine bak.

#Sık sorulanlar

#Bağlantıyı kaldırırsam sitedeki kurallar silinir mi?

Hayır. Bağlantıyı kaldır yalnızca SEOAsist'in göndermeyi durdurmasını sağlar; sitede saklanan kurallar olduğu gibi kalır.

#API adresini değiştirirsem ne olur?

Yeni adresi yazıp Adresi kaydet'e bas. Durum Test bekliyor olur; Bağlantıyı test et ile yeniden doğrula. Token değişmez.

#Hiç kural yokken sitem etkilenir mi?

Olmamalı. Spesifikasyon, kural yoksa her sayfanın bugünkü gibi çalışmasını şart koşar. Kurulum promptu da var olan SEO davranışını bozmamayı açıkça ister.

#Pixel ile Site API arasındaki fark ne?

Aynı kuralları kullanırlar. Pixel bunları tarayıcıda JavaScript ile uygular; Site API ise sitenin sunucusunda uygular, böylece arama motorları değişikliği doğrudan HTML'de görür. Site API ayrıca yazı yayınlayabilir ve llms.txt yazabilir.

#Yerel geliştirme adresimi (localhost) bağlayabilir miyim?

Hayır. SEOAsist yalnızca internetten erişilebilen genel adreslere istek atar; localhost ve özel ağ adresleri reddedilir. API'yi yayındaki siteye kur.