llms.txt kontrolü: dosyanız gerçekten yayında mı, yoksa 404 mü dönüyor?

llms.txt, sitenizi yapay zeka modellerine sade bir dille tanıtan bir metin dosyasıdır. Henüz resmî bir standart değildir — ama maliyeti neredeyse sıfır olduğu için, ekleyip gerçekten yayında olduğundan emin olmak mantıklı bir adımdır.

llms.txt tam olarak nedir?

Sitenizin kökünde duran (https://siteniz.com/llms.txt) Markdown biçimli düz bir metin dosyasıdır. İçinde sitenin ne yaptığı, en önemli sayfaları ve varsa notlar bulunur. Amaç, bir dil modelinin sitenizi anlamak için onlarca sayfayı taramak zorunda kalmadan, tek dosyadan özet bir harita edinmesidir.

Dürüst olmak gerekirse: bugün büyük sağlayıcıların bu dosyayı ne ölçüde kullandığı kesin değildir. Bu yüzden onu bir "sihirli çözüm" değil, ucuz bir netlik yatırımı olarak görün.

İçinde ne olmalı?

# Firma Adınız

> Tek cümlelik açıklama: ne yapıyorsunuz, kim için.

## Temel Sayfalar

- [Ana Sayfa](https://siteniz.com/): kısa açıklama
- [Hizmetler](https://siteniz.com/hizmetler): kısa açıklama
- [Blog](https://siteniz.com/blog): kısa açıklama

## Notlar

- İletişim: info@siteniz.com

Başlıklar, kısa açıklamalar ve gerçek bağlantılar yeterlidir. Pazarlama dili yerine bilgi yazın; bu dosya bir insana değil, bir modele hitap eder.

En sık karşılaşılan sorun: dosya var sanmak

Uygulamada gördüğümüz en yaygın hata, dosyanın yüklendiğinin sanılması ama adresin aslında 404 sayfası döndürmesidir. Özellikle üç durumda olur:

• Yanlış klasör: Dosya proje kökünde durur ama sunucunun yayın kökü (docroot) başka bir klasördür.
• SPA yönlendirmesi: Tek sayfa uygulamalarında tüm adresler index.html'e yönlendirilir; /llms.txt de HTML sayfası döndürür. Tarayıcıda "bir şey" göründüğü için doğru sanılır.
• Yanlış içerik tipi: Dosya text/html olarak sunulur; içerik doğru olsa bile makine tarafında metin dosyası gibi işlenmez.

llms.txt Kontrolcüsü tam olarak bunu ayırt eder: adrese gerçek bir istek atar, dönen içerik tipini ve gövdenin HTML olup olmadığını inceler. Yani "sayfa açıldı" ile "dosya yayında" arasındaki farkı görür. Aynı kontrolü /llms-full.txt için de yapar.

Nereye koyacaksınız?

Statik sitelerde dosyayı yayın klasörünün köküne bırakmanız yeterlidir. WordPress'te kök dizine (genellikle public_html) koyabilir ya da bir eklentiyle üretebilirsiniz. Laravel/Next.js gibi çatılarda public/ klasörü doğru yerdir.

Sık sorulan sorular

llms.txt resmî bir standart mı?

Hayır. Topluluk tarafından önerilmiş bir yaklaşımdır ve büyük sağlayıcılar tarafından resmen benimsenmiş değildir. Zararı yoktur, maliyeti düşüktür; beklentinizi buna göre ayarlayın.

robots.txt ile aynı şey mi?

Hayır. robots.txt izin dosyasıdır: kim nereye girebilir. llms.txt ise tanıtım dosyasıdır: burada ne var. İkisi birbirinin yerine geçmez.

Sitemap varken llms.txt'e gerek var mı?

Sitemap makinelere adres listesi verir, llms.txt ise bağlam verir: hangi sayfa ne işe yarar. İkisi farklı soruları cevaplar; birlikte kullanılırlar.

Dosyayı ne sıklıkla güncellemeliyim?

Site yapınız değiştikçe — yeni bir bölüm, yeni bir hizmet sayfası eklediğinizde. Ayda bir gözden geçirmek çoğu site için fazlasıyla yeterlidir.

Adım adım kontrol listesi

1. Adresi açın. https://siteniz.com/llms.txt — tarayıcıda düz metin görüyor musunuz?
2. "Kaynağı görüntüle" ile bakın. HTML etiketleri görüyorsanız dosya değil, bir sayfa dönüyordur.
3. İçerik tipini doğrulayın. Yanıt text/plain olmalı. text/html dönüyorsa sunucu yapılandırmanız dosyayı yanlış sunuyordur.
4. Bağlantıları test edin. Dosyadaki adreslerin hepsi 200 dönmeli; ölü bağlantı içeren bir tanıtım dosyası güven kaybettirir.
5. Güncelliğini kontrol edin. Sitede olmayan bir bölümü listeliyorsa temizleyin.

llms.txt mi, llms-full.txt mi?

Topluluk pratiğinde iki dosya konuşulur: llms.txt kısa bir harita, llms-full.txt ise içeriğin daha geniş bir düz metin dökümüdür. Küçük ve orta ölçekli siteler için yalnızca llms.txt fazlasıyla yeterlidir. Tüm içeriğinizi ikinci bir dosyada tekrarlamak bakım yükü yaratır ve iki kaynak arasında tutarsızlık riski doğurur.

Gerçekçi beklenti

Bu dosyanın bugün ölçülebilir bir trafik etkisi olduğunu iddia etmek dürüst olmaz. Onu şu iki sebeple ekleyin: maliyeti neredeyse sıfır ve sitenizi tek sayfada anlatma alıştırması, kendi bilgi mimarinizi de netleştirir. Asıl işi robots.txt, şema ve içerik yapısı yapar.

Ne sıklıkla kontrol etmelisiniz?

Site yapısı değiştiğinde — yeni bölüm, yeni hizmet sayfası. Ayrıca sunucu/hosting taşıması sonrasında mutlaka: taşıma sırasında kök dizindeki tekil dosyalar en sık unutulan şeylerdir.

Sonraki adım: Dosyanız yayındaysa, aynı netliği yapılandırılmış veride de sağlayın: şema doğrulayıcı ve sitemap kontrolü.