llms.txt nedir: ne işe yarar, Google kullanıyor mu, nasıl yazılır

llms.txt, bir sitenin kök dizinine konan ve yapay zeka sistemlerine "siteyi anlamak için önce şunlara bak" diyen, Markdown biçiminde kısa bir dizin dosyasıdır. Öneriyi Answer.AI'dan Jeremy Howard yaptı. Resmî bir internet standardı değil ve bunu baştan söylemekte fayda var, çünkü bu dosya hakkında yazılanların bir kısmı onu robots.txt'in yeni sürümüymüş gibi anlatıyor. Değil.

Bu yazıda dosyanın ne olduğunu, nasıl yazıldığını ve en çok sorulan soruyu cevaplıyorum: eklemeye değer mi? Kısa cevabı baştan vereyim. Google Search için hiçbir faydası yok, zararı da yok. Başka sistemler için fayda sağlayıp sağlamadığı site türüne bağlı ve kanıtı zayıf. Ucuz bir iş olduğu için çoğu site yine de ekleyebilir, ama bunu bir SEO taktiği olarak değil, küçük bir bakım işi olarak görmek gerekir.

llms.txt'nin çözmeye çalıştığı sorun

Bir yapay zeka ajanı bir sayfayı okurken menüler, çerezler, reklamlar ve betikler arasında asıl içeriği ayıklamak zorunda. Dil modellerinin bağlam penceresi sınırlı olduğu için tüm bir siteyi de okuyamıyor. Öneri şu: site sahibi, hangi sayfaların önemli olduğunu ve her birinin ne anlattığını tek bir temiz dosyada versin. Önerinin kendi ifadesiyle amaç, yapay zeka ajanlarına siteye ilişkin kısa ve seçilmiş bir giriş noktası sunmak. Dosya esas olarak çıkarım anı için tasarlanmış, yani biri bir soru sorduğunda modelin siteden bilgi çekmesi için. Model eğitimi için değil.

Bu tarif en çok geliştirici dokümantasyonu için anlamlı. Yüzlerce sayfası olan bir API dokümanında bir ajanın doğru sayfayı bulması gerçekten zor. Kişisel bir site ya da on sayfalık bir şirket sitesinde ise sorun zaten yok.

Dosyanın biçimi

Öneri, bölümlerin sırasını belirliyor:

1. Site ya da proje adıyla bir H1 başlığı. Bu, tek zorunlu bölüm.
2. Bir blok alıntı içinde kısa özet.
3. İsteğe bağlı olarak başlıksız açıklama paragrafları ya da listeler.
4. H2 başlıkları altında bağlantı listeleri. Her öğe [ad](adres) biçiminde, istenirse iki nokta üst üste ve kısa bir not ile.
5. "Optional" adlı bir H2 bölümü. Buradaki bağlantılar, ajanın daha kısa bağlam gerektiğinde atlayabileceği ikincil kaynaklar.

Örnek bir dosya şöyle görünür:

# Örnek Şirket

> Adana'da B2B yazılım geliştiren küçük bir ekip. Ürünler, fiyatlar ve destek belgeleri aşağıda.

Fiyatlar TL cinsindendir ve KDV hariçtir.

## Ürünler

- [CRM paketi](https://ornek.com/crm.md): Satış ekipleri için müşteri takibi ve teklif yönetimi
- [Randevu sistemi](https://ornek.com/randevu.md): Klinikler için çevrimiçi randevu

## Destek

- [Sık sorulan sorular](https://ornek.com/sss.md): Kurulum, faturalama, veri aktarımı
- [Kurulum kılavuzu](https://ornek.com/kurulum.md)

## Optional

- [Blog](https://ornek.com/blog.md)

Dosya sitenin kökünde ya da kökün altındaki herhangi bir yolda durabilir. Birden çok dosya geçerliyse ajanların en özel olanı kullanması bekleniyor. Öneri ayrıca, değerli içeriği olan sayfaların aynı adreste temiz bir Markdown sürümünün sunulmasını tavsiye ediyor: adresin sonuna .md eklemek ya da uzantıyı .md ile değiştirmek gibi. Sayfanın Markdown sürümünü HTML içinden rel="alternate" type="text/markdown" ile, llms.txt dosyasını ise rel="describedby" ile işaretleme yolu da tanımlı. Bu bağlantıları HTTP Link başlığıyla da verebilirsiniz.

robots.txt ve sitemap ile farkı

Üçünü karıştıranlar çok, o yüzden ayırayım.

llms.txt'ye "OAI-SearchBot'a izin ver" gibi bir kural yazamazsınız. Hangi yapay zeka botunun sitenize gireceğini yönetmek hâlâ robots.txt'in işi. OpenAI ve Perplexity'nin kendi dokümanlarında kontrol mekanizması olarak robots.txt anlatılıyor. İkisinde de arama botu ile eğitim botu ayrı yönetiliyor ve ayarlar bağımsız çalışıyor. Bu ayrımın ayrıntısını yapay zeka aramalarında görünmek yazısında anlattım.

Spesifikasyonun durumu

Öneri sayfasında ilk yayın tarihi 3 Eylül 2024, son değişiklik tarihi Ağustos 2026 görünüyor ve metin kendini "v2" olarak adlandırıyor. Yani dosya biçimi hâlâ yaşayan bir taslak. Yukarıda anlattığım bölüm sırası ve keşif için tanımlanan bağlantı ilişkileri bu sürümden. Bir kuruluş ya da standart organı tarafından onaylanmış değil, bu yüzden dosyayı yazarken önerinin güncel hâline bakın ve ileride biçimin değişebileceğini hesaba katın.

Google llms.txt'yi kullanıyor mu

Hayır. Google'ın Mayıs 2026'da yayımladığı üretken yapay zeka optimizasyon rehberi bunu açıkça yazıyor: Google Search bu dosyayı ya da "özel" işaretlemeleri kullanmıyor. Başka hizmetler için oluşturmanın sakıncası olmadığını, ama Search görünürlüğüne ne yardım ne zarar verdiğini ekliyor. Rehber aynı yerde içeriği "parçalara bölmenin", yapay zeka için yeniden yazmanın ve yapay "bahsedilmeler" üretmenin de gerekli olmadığını söylüyor.

AI Overviews ve AI Mode için de durum aynı. Google'ın site sahipleri için hazırladığı sayfada bu özelliklere çıkmak için sayfanın dizine eklenmiş ve snippet ile gösterilebilir olmasının yeterli olduğu, ek teknik şart olmadığı, yapay zekaya özel metin dosyalarına ya da şemaya gerek bulunmadığı yazıyor.

Bu, "llms.txt işe yaramaz" demek değil. "Google'da sıralama ya da yapay zeka özetlerinde görünme aracı değil" demek. Ayrımı karıştırmayın. Bir SEO ajansı size "llms.txt ile ChatGPT'de çıkarsınız" diyorsa, bunu destekleyen resmi bir belge göstermesini isteyin. Ben böyle bir belge bulamadım.

Başka sistemlerde durum

Chrome'un Lighthouse aracında "ajan tarama" kategorisi altında bir llms.txt denetimi var. Denetim dosyanın varlığını ve erişilebilirliğini kontrol ediyor. Dosya yoksa (404) denetim "uygulanamaz" sayılıyor ve belge dosyayı sağlamanın şu an isteğe bağlı olduğunu açıkça yazıyor. Sunucu hata dönerse sayfa işaretleniyor. Yani araç bir benimsenme sinyali veriyor ama zorunluluk getirmiyor.

Hangi yapay zeka ürününün bu dosyayı gerçekten çıkarım sırasında okuduğuna dair bağımsız, güvenilir bir döküm bulamadım. "Şu model bu dosyayı okuyor" cümlesi kuran kaynakların çoğu satıcı yazısı. Bu yüzden beklentinizi düşük tutun.

Yayımlama ve test

Dosyayı statik bir site için kök dizine llms.txt adıyla koymak yeterli. WordPress gibi bir sistemde kök dizine dosya yüklemek ya da bir eklenti kullanmak gerekir. Yayımladıktan sonra üç şeye bakın. Adres 200 dönüyor mu, içerik tarayıcıda düz metin olarak açılıyor mu ve dosyadaki her bağlantı çalışıyor mu? Komut satırında curl -I https://siteniz.com/llms.txt yanıt kodunu ve içerik türünü gösterir. Chrome'un Lighthouse denetimi de dosyanın erişilebilirliğini ayrıca kontrol ediyor.

Markdown sürümleri sunmak, dosyanın kendisinden daha fazla iş. Sayfaların temiz bir .md kopyasını üretmek, bir şablon sistemi ya da derleme adımı gerektiriyor. Bu sitede de llms.txt ve sayfaların Markdown sürümleri var, çünkü site statik üretiliyor ve ek maliyeti sıfıra yakın. Elle yönetilen bir sitede bu kopyaları güncel tutmak zor olur. Güncel tutamayacaksanız sadece llms.txt'yi ve kısa notlarını yayımlayın, .md kopyalarını boş verin.

Eklemeye değer mi

Benim yaklaşımım şöyle:

• Dokümantasyon ya da geliştirici ürünü olan bir siteniz varsa, ekleyin. Ajan ve kod asistanı kullanıcılarının işine yarama ihtimali en yüksek grup bu.
• Küçük bir kurumsal ya da kişisel siteniz varsa, bir saatlik işi geçmez, ekleyebilirsiniz. Ama sıralama beklemeyin.
• E-ticaret ya da binlerce sayfalı bir siteniz varsa, dosyayı elle seçilmiş, kısa bir dizin olarak tutun. Tüm sayfaları dökmeyin, o iş sitemap'in.

Bakım yükü de düşünülmeli. Yanlış ya da kırık adresler içeren bir llms.txt, hiç olmamasından kötü. Dosyadaki bağlantıları sitenizdeki değişikliklerle birlikte güncelleyecek biri yoksa eklemeyin.

Sık yapılan hatalar

• Tüm siteyi listelemek. Dosyanın değeri seçilmiş olmasından geliyor.
• Dosyadaki açıklamaları sitede yazmayan şeylerle doldurmak. Makineye sayfada olmayan bir şey söylemek, kullanıcıya ve tarayıcıya farklı içerik göstermeye benzer. Google'ın cloaking politikası arama motoru botları için yazılmış, ama güvenli ilke aynı: sayfanın söylediği ile dosyanın söylediği çelişmesin.
• llms.txt'yi robots.txt yerine kullanmak. Erişimi kapatmaz.
• Dosyaya anahtar kelime yığmak. Ne okuyan model ne de bakan insan bunu takdir eder.
• Güncellemeyi unutmak. Sayfalar taşındığında dosyadaki adresler kırık kalır.

Teknik SEO'nun geri kalanı için teknik SEO ana yazısına bakabilirsiniz.

Eklemeden önce kontrol listesi

1. Dosya /llms.txt adresinde 200 dönüyor ve düz metin ya da Markdown olarak sunuluyor mu?
2. İlk satır H1 başlığı, hemen ardından blok alıntı bir özet var mı?
3. Bağlantıların hepsi çalışıyor ve sitedeki güncel içeriğe gidiyor mu?
4. Önemli sayfaların temiz bir Markdown sürümü varsa dosya onlara mı bağlanıyor?
5. robots.txt'te arama botlarını (OAI-SearchBot, PerplexityBot, Googlebot) yanlışlıkla engellemediğinizi kontrol ettiniz mi?
6. Dosyanın bakımını kim yapacak ve ne zaman gözden geçirilecek, belli mi?

Altısına da evet diyebiliyorsanız dosyayı yayımlayın. Hayır diyeceğiniz madde varsa önce onu çözün.