serkankaya.
English version
Birlikte çalışalım ↗

llms.txt Nedir? Sitene 10 Dakikada Nasıl Eklersin

llms.txt nedir, robots.txt'den farkı ne, gerçekten okunuyor mu? Dosya formatı, Astro ve WordPress kurulumu, kontrol ve ölçüm adımlarıyla pratik rehber.

llms.txt nedir sorusunun kısa cevabı şu: llms.txt, sitenin kök dizininde duran ve sitenin özetini, en önemli sayfalarını dil modellerine Markdown formatında sunan bir metin dosyasıdır. Resmi bir standart değil, 2024’te yayımlanmış bir öneridir. Dosya sıralama sinyali olarak çalışmaz; kod asistanları ve yapay zekâ ajanları için siteyi hızlıca anlamayı kolaylaştıran bir rehberdir.

Bu yazıda llms.txt’nin formatını, robots.txt ve sitemap.xml ile farkını, gerçekten okunup okunmadığına dair verileri ve bu siteye nasıl otomatik olarak eklediğimi anlatıyorum. Konunun genel çerçevesini merak ediyorsan önce GEO nedir yazıma bakabilirsin; llms.txt, GEO’nun teknik tarafındaki küçük ama sık sorulan bir parça.

llms.txt nereden çıktı ve neden önerildi?

llms.txt, Answer.AI’nin kurucularından Jeremy Howard’ın 3 Eylül 2024’te llmstxt.org’da yayımladığı bir öneridir.[1] Önerinin çıkış noktası basit: Web sayfaları insanlar için tasarlanıyor. Menüler, reklamlar, çerez bannerları ve JavaScript ile yüklenen bölümler, bir dil modelinin sayfadaki asıl bilgiye ulaşmasını zorlaştırıyor.

İkinci sorun bağlam penceresi (context window). Bağlam penceresi, bir dil modelinin tek seferde işleyebildiği metin miktarıdır. Bir sitenin tamamı bu pencereye sığmaz ve her gereksiz kelime zaman ve maliyet demektir. llms.txt, ajana “bu sitede önemli olan şunlar, ayrıntı da şu linklerde” diyen kısa bir giriş kapısı sunuyor.

Öneri, Ağustos 2026’da ikinci sürümüne güncellendi.[1] Güncel metne göre binlerce site llms.txt yayımlıyor, dokümantasyon platformları dosyayı otomatik üretiyor ve Chrome’un Lighthouse aracı ajan tarayıcılığı denetimlerinde bu dosyayı kontrol ediyor. OpenAI, Anthropic ve Google’ın Gemini ekibi de geliştirici dokümantasyonları için llms.txt yayımlıyor. Bu bilgiler önerinin kendi sayfasından geliyor; bağımsız bir ölçüm değil.

Kullanıcı sorusu Ajan llms.txt okur İlgili linki açar Cevap üretir
llms.txt'nin amaçlanan kullanımı: ajan önce kısa özeti okur, sonra yalnızca ihtiyaç duyduğu sayfayı açar.

llms.txt dosyasının formatı nasıl olmalı?

Kısa cevap

llms.txt dosyasının formatı nasıl olmalı?

llms.txt, Markdown ile yazılmış ve belirli bir sırayı izleyen düz metin bir dosyadır. Tek zorunlu bölüm, site ya da proje adını taşıyan H1 başlıktır. Ardından alıntı biçiminde kısa bir özet, isteğe bağlı açıklama paragrafları ve H2 başlıkları altında “ad: not” biçiminde link listeleri gelir.

Önerideki sıra şöyle:[1]

SıraBölümZorunlu mu?Ne yazılır?
1# Site adı (H1)EvetSitenin, markanın ya da projenin adı
2> Özet (alıntı)HayırDosyanın geri kalanını anlamak için gereken kısa özet
3Açıklama paragraflarıHayırBaşlık içermeyen ek bilgi, notlar, uyarılar
4## Bölüm + link listesiHayırHer satırda - [Ad](URL): kısa not
5## OptionalHayırKısa bağlamda atlanabilecek ikincil linkler

Bir hizmet sitesi için sade bir örnek:

# Örnek Ajans

> İstanbul merkezli, teknik SEO ve Google Ads yönetimi yapan bir dijital pazarlama ajansı.

Türkçe ve İngilizce hizmet veriyoruz. Fiyat bilgisi sayfalarda yer almaz; teklif iletişim formuyla verilir.

## Hizmetler

- [Teknik SEO](https://ornek.com/teknik-seo/): Site denetimi, tarama ve indeksleme sorunları
- [Google Ads yönetimi](https://ornek.com/google-ads/): Kampanya kurulumu ve dönüşüm takibi

## Rehberler

- [Core Web Vitals rehberi](https://ornek.com/blog/core-web-vitals/): Sayfa hızı ölçümü ve iyileştirme adımları

## Optional

- [Gizlilik politikası](https://ornek.com/gizlilik/)

Formatın Markdown olmasının nedeni, dosyanın hem insanlar hem dil modelleri tarafından kolay okunması. Ama yapı yine de sabit olduğu için klasik yazılım araçlarıyla, yani bir parser ya da düzenli ifadeyle de işlenebiliyor.

Alt dizinler ve Markdown sürümleri

Önerinin ikinci sürümü iki ayrıntı ekliyor.[1] Birincisi, dosya yalnızca kökte değil bir alt dizinde de durabilir. Örneğin /docs/llms.txt yalnızca /docs/ altındaki sayfaları kapsar ve birden fazla dosya varsa ajan en spesifik olanı kullanır. İkincisi, ajanların ihtiyaç duyabileceği sayfaların temiz bir Markdown sürümü aynı URL’nin sonuna .md eklenerek sunulabilir. Bazı dokümantasyon platformları buna ek olarak tüm içeriği tek dosyada birleştiren bir llms-full.txt de yayımlıyor; bu dosya önerinin kendi metninde tanımlı değil, yaygınlaşmış bir uygulama.

Bu sürümleri ajana göstermek için öneri, standart link ilişkilerini kullanmayı tavsiye ediyor. rel="alternate" type="text/markdown" sayfanın Markdown sürümünü, rel="describedby" ise o sayfayı kapsayan llms.txt dosyasını gösterir. Bu ilişkiler HTML’de <link> etiketiyle ya da HTTP Link başlığıyla verilebilir; başlık biçimi RFC 8288’de tanımlı web linkleme standardına dayanır.[4]

llms.txt ile robots.txt ve sitemap.xml arasındaki fark nedir?

llms.txt erişim kuralı koymaz; robots.txt botların nereye girebileceğini yönetir, sitemap.xml ise indekslenebilir sayfaların tamamını listeler. Üç dosya farklı sorulara cevap verir ve biri diğerinin yerine geçmez. robots.txt’de engellediğin bir bölümü llms.txt’ye eklemek, ajana çelişkili bir sinyal verir.

robots.txtsitemap.xmlllms.txt
Cevapladığı soruBot nereye girebilir?Hangi sayfalar var?Önce neyi okumalı?
Hedef okurTarayıcı botlarArama motorlarıDil modelleri ve ajanlar
FormatDüz metin kurallarXMLMarkdown
KapsamTüm siteTüm indekslenebilir sayfalarSeçilmiş önemli sayfalar
DurumYerleşik standartYerleşik standartTopluluk önerisi

Öneri metni de bu ilişkiyi aynı şekilde kuruyor: sitemap.xml tüm sayfaları listeler ve genellikle bir bağlam penceresine sığmayacak kadar büyüktür, llms.txt ise seçilmiş bir özet sunar.[1] Yani llms.txt, sitemap’in kısaltılmış bir kopyası değil, editoryal bir seçkidir.

Robots.txt tarafında asıl önemli olan, görünmek istediğin platformların arama botlarını yanlışlıkla engellememek. Bu ayrımı GEO nedir yazımda OpenAI ve Perplexity botları üzerinden ayrıntılı anlattım.

llms.txt gerçekten işe yarıyor mu?

llms.txt’nin arama görünürlüğüne doğrudan bir etkisi olduğuna dair bir kanıt yok ve Google bunu açıkça söylüyor. Google’ın yapay zekâ özellikleri dokümantasyonuna göre AI Overviews ya da AI Mode’da görünmek için yeni makine okunur dosyalar, yapay zekâ metin dosyaları ya da özel işaretleme oluşturmak gerekmiyor.[2] Sayfanın indekslenmiş ve snippet ile gösterilmeye uygun olması yeterli.

Kullanım tarafındaki veri de beklentiyi aşağı çekiyor. Ahrefs’in Haziran 2026’da yayımladığı çalışmada geçerli bir llms.txt dosyası olan yaklaşık 38 bin alan adının %97’si, Mayıs 2026 boyunca bu dosya için hiç istek almadı.[3] Okunan dosyalarda ise isteklerin %96’sı botlardan geldi.

Geçerli llms.txt dosyası olan alan adı
~38.000
Mayıs 2026 boyunca hiç istek almayan dosya oranı
%97
Okunan dosyalarda botlardan gelen istek payı
%96
Kaynak: Ahrefs, llms.txt çalışması (Haziran 2026)

Peki neden yine de ekliyorum? Üç nedenim var:

  1. Maliyeti çok düşük. Dosya bir kez kurulup otomatikleştirildiğinde içerik eklendikçe kendiliğinden güncelleniyor.
  2. Gerçek bir kullanım alanı var. Öneriye göre dosya en çok yazılım dokümantasyonunda, kod asistanlarının API referansına ulaşması için kullanılıyor.[1] Bir hizmet sitesinde de bir ajan, “bu kişi ne iş yapıyor?” sorusunu tek dosyadan cevaplayabiliyor.
  3. Seni netleştiriyor. Siteni tek paragrafta özetlemek ve en önemli on sayfayı seçmek, içerik stratejisi için de faydalı bir egzersiz.

llms.txt nasıl oluşturulur?

Kısa cevap

llms.txt nasıl oluşturulur?

llms.txt oluşturmak için sitenin adını, kısa bir özetini ve en önemli sayfalarının linklerini Markdown formatında bir metin dosyasına yazıp dosyayı sitenin kök dizinine yüklemek yeterlidir. Dosyayı elle yazabilir, bir CMS eklentisiyle ya da build sürecinde otomatik üretebilirsin.

  1. Sitenin adını ve tek paragraflık özetini yaz.
  2. En önemli 10-20 sayfayı seç ve her birine kısa bir not ekle.
  3. Sayfaları H2 başlıkları altında grupla.
  4. Dosyayı llms.txt adıyla sitenin kök dizinine yükle.
  5. Adresin 200 döndüğünü ve text/plain olarak sunulduğunu kontrol et.

Elle yazmak istemiyorsan, bu sitedeki llms.txt oluşturucu aracı formu doldurduğunda dosyayı önerideki yapıya çeviriyor ve indirmeni sağlıyor. Kalıcı çözüm ise dosyayı sitenin kendi içeriğinden üretmek.

  1. Özeti yaz

    Kim olduğunu, ne yaptığını, kime ve hangi bölgede hizmet verdiğini iki cümlede anlat. Pazarlama sloganı değil, bilgi yaz.

  2. Sayfaları seç

    Hizmet ve ürün sayfaları, en kapsamlı rehberler, hakkında ve iletişim sayfaları. Etiket arşivleri, sepet ve hesap sayfalarını ekleme.

  3. Notları ekle

    Her linke sayfanın neyi cevapladığını anlatan kısa bir açıklama yaz. Ajan hangi linki açacağına bu notla karar verir.

  4. Yayınla ve kontrol et

    Dosyayı kök dizine koy, tarayıcıda aç ve HTTP yanıtını kontrol et. Sonra bir ajana yalnızca bu dosyayı verip siten hakkında soru sor.

Astro ile otomatik üretim

Bu site Astro ile yazılıyor ve Cloudflare Pages’te yayınlanıyor. llms.txt’yi elle tutmak yerine bir Astro endpoint’i ile build sırasında üretiyorum. Astro’da endpoint, src/pages içindeki bir .ts dosyasının HTML yerine istediğin türde bir yanıt döndürmesini sağlayan yapıdır.[5] Basitleştirilmiş hâli şöyle:

// src/pages/llms.txt.ts
import { getCollection } from 'astro:content';

export async function GET() {
  const posts = await getCollection('yazilar', ({ data }) => !data.draft);
  const lines = [
    '# Site adı',
    '',
    '> Sitenin iki cümlelik özeti.',
    '',
    '## Yazılar',
    ...posts.map((p) => `- [${p.data.title}](https://alanadi.com/yazilar/${p.id}/): ${p.data.description}`),
  ];
  return new Response(lines.join('\n'), {
    headers: { 'Content-Type': 'text/plain; charset=utf-8' },
  });
}

Statik çıktı alan bir Astro sitesinde bu endpoint build anında bir kez çalışır ve sonuç düz bir dosya olarak yayınlanır. Yeni bir yazı eklediğimde dosya bir sonraki build’de kendiliğinden güncelleniyor. Bu sitenin /llms.txt dosyasında yazıların yanında hizmet sayfaları, sektör sayfaları ve İngilizce sürümler de aynı mantıkla listeleniyor.

WordPress ve diğer platformlar

WordPress’te en kolay yol bir SEO eklentisi kullanmak. Öneri sitesi, llms.txt üreten entegrasyonlar arasında Yoast SEO ve AIOSEO eklentilerini, Wix’i ve dokümantasyon tarafında Mintlify ile GitBook’u sayıyor.[1] Eklenti kullanmıyorsan dosyayı elle hazırlayıp FTP ya da hosting panelindeki dosya yöneticisiyle kök dizine yükleyebilirsin. Hazır site platformlarında kök dizine dosya yükleme imkânı sınırlı olabilir; bu durumda platformun kendi dokümantasyonuna bakmak gerekiyor.

Sunucu ve CDN ayarları

Dosyanın yayında olması yetmez, doğru sunulması da gerekir. Üç noktaya dikkat ediyorum:

  • İçerik türü: Yanıtın Content-Type başlığı text/plain; charset=utf-8 olmalı. Türkçe karakterler bozuk görünüyorsa sorun genellikle eksik charset bilgisidir.
  • Bot korumaları: Cloudflare gibi CDN ve WAF (Web Application Firewall, web uygulama güvenlik duvarı) katmanlarındaki bot kuralları, dosyayı ajanlara kapatabilir. Dosyayı engellenmemiş bir yol olarak bırak.
  • Link başlığı: Statik sitelerde _headers gibi bir dosyayla sayfalara Link: </llms.txt>; rel="describedby" başlığı eklenebilir. Bu sayede sayfaları değiştirmeden dosyanın yerini ajanlara gösterebilirsin.[1]

llms.txt’ye hangi sayfalar eklenmeli?

llms.txt’ye sitenin tamamı değil, bir ajanın siteyi doğru anlaması için gereken en önemli sayfalar eklenmelidir. Pratikte bu, hizmet ya da ürün kategorileri, en kapsamlı rehberler, hakkında ve iletişim sayfaları demek. Dosyanın amacı bağlam penceresine sığacak kadar kısa kalmak; ayrıntı linklerin arkasında durmalı.

Eklememen gerekenler de en az o kadar önemli:

  • Kişisel veri: Dosya herkese açık bir metin. Çalışan telefonları, e-posta listeleri ya da müşteri bilgisi yazma. KVKK (Kişisel Verilerin Korunması Kanunu) açısından da gereksiz bir risk.
  • Gizli ya da yönetim sayfaları: llms.txt’ye yazdığın her URL’yi herkes görebilir. Yönetim paneli, test ortamı ya da robots.txt’de engellediğin yolları listeleme.
  • Tekrarlı sayfalar: Etiket arşivleri, filtre sonuçları, sayfalama URL’leri ve sepet adımları ajana yeni bilgi vermez.
  • Doğrulanmamış iddialar: Özet paragrafı bir slogan alanı değil. “Sektörün lideri” gibi kanıtlanamayan ifadeler, modelin seni yanlış tanımlamasına yol açabilir.

Türkçe bir sitede özeti Türkçe yazmak doğal olanı. Sitende İngilizce sayfalar da varsa, onları ayrı bir H2 başlığı altında listelemek ajanın doğru dil sürümüne gitmesini kolaylaştırır. Bu sitede de İngilizce sayfalar “English” başlığı altında ayrı duruyor.

llms.txt’nin okunduğunu nasıl kontrol edersin?

llms.txt’nin okunup okunmadığını anlamanın en güvenilir yolu, sunucu ya da CDN loglarında /llms.txt adresine gelen istekleri ve bu isteklerin kullanıcı ajanlarını (user agent) incelemektir. Analitik araçları bu isteği göstermez, çünkü dosya JavaScript çalıştırmaz. Ahrefs’in çalışmasındaki %97 oranı da tam olarak bu tür istek verisine dayanıyor.[3]

Kendi kurulumumda şu sırayla ilerliyorum: önce dosyanın teknik olarak doğru sunulduğunu kontrol ediyorum, sonra öneri metnindeki tavsiyeye uyup bir ajana yalnızca llms.txt’yi verip site hakkında sorular soruyorum.[1] Ajan doğru sayfaya gidip doğru cevabı veriyorsa özet ve notlar işini yapıyor demektir. En son da loglarda kimin dosyayı istediğine bakıyorum.

llms.txt yayın öncesi kontrol listesi0/8

Loglara bakarken kullanıcı ajanı bilgisinin taklit edilebileceğini unutma. Önemli kararlar için bot doğrulamasını CDN’in kendi araçlarıyla ya da platformların yayımladığı IP aralıklarıyla yapmak daha sağlıklı.

Nereden başlamalı?

llms.txt, siteni dil modellerine ve ajanlara özetleyen, kurulumu kısa süren ama etkisi sınırlı bir dosya. Google onu bir gereklilik olarak görmüyor, mevcut veriler de dosyaların çoğunun hiç okunmadığını gösteriyor. Buna rağmen otomatik üretildiğinde bakım maliyeti sıfıra yakın olduğu için eklemek mantıklı bir tercih.

Benim önerim şu sırayla ilerlemek: önce robots.txt ve CDN ayarlarında görünmek istediğin botları engellemediğinden emin ol. Ardından iki cümlelik bir özet ve en önemli sayfalarınla ilk llms.txt’ni hazırla, mümkünse CMS’ine ya da build sürecine bağla. Son olarak loglardan istekleri izle. Bu tür otomasyonları site altyapısına bağlamak yazılım geliştirme tarafının işi; yapay zekâ görünürlüğünün geri kalanını ise GEO nedir yazısında anlattım.

Bu yazıdaki terimler

llms-full.txt
llms-full.txt, bazı dokümantasyon platformlarının llms.txt'ye ek olarak sunduğu ve sitedeki içeriğin tamamını tek bir Markdown dosyasında birleştiren bir dosyadır. llms.txt önerisinin kendi metninde tanımlı değildir; yaygınlaşmış bir uygulamadır.
Markdown
Markdown, başlık, liste ve link gibi biçimleri # ve - gibi basit işaretlerle yazmayı sağlayan hafif bir metin biçimlendirme dilidir. Hem insanlar hem dil modelleri tarafından kolay okunduğu için llms.txt dosyalarının formatı olarak seçilmiştir.
robots.txt
robots.txt, sitenin kök dizininde duran ve tarayıcı botlara hangi URL'lere erişip erişemeyeceklerini bildiren düz metin bir kurallar dosyasıdır. Bir güvenlik önlemi değildir; kurallara uyup uymamak botun kendisine bağlıdır.
sitemap.xml
sitemap.xml, bir sitedeki indekslenebilir sayfaların listesini arama motorlarına XML formatında bildiren bir dosyadır. Sayfaların keşfedilmesini kolaylaştırır ama hangi sayfanın önemli olduğunu ya da nasıl yorumlanacağını anlatmaz.
Tüm sözlük ↗

Sık sorulan sorular

llms.txt nedir?

llms.txt, bir sitenin kök dizininde duran ve sitenin kısa özetini, en önemli sayfalarını dil modellerine ve yapay zekâ ajanlarına Markdown formatında sunan bir metin dosyasıdır. Jeremy Howard'ın 2024'te yayımladığı bir öneridir; resmi bir web standardı değildir.

llms.txt ile robots.txt arasındaki fark nedir?

robots.txt botlara sitenin hangi bölümlerine erişebileceklerini söyleyen bir erişim kuralları dosyasıdır. llms.txt ise erişim kuralı koymaz; bir ajanın siteyi hızlı anlaması için özet ve seçilmiş link listesi sunar. İkisi birbirinin yerine geçmez, birlikte kullanılabilir.

llms.txt SEO'ya etki eder mi?

Google, AI Overviews ve AI Mode'da görünmek için yeni bir makine okunur dosya ya da yapay zekâ metin dosyası oluşturmanın gerekmediğini resmi dokümantasyonunda belirtiyor. Bu yüzden llms.txt'yi bir sıralama sinyali olarak değil, kod asistanları ve ajanlar için düşük maliyetli bir kolaylık olarak görmek daha doğru.

llms.txt dosyası nereye yüklenir?

Dosya genellikle sitenin kök dizinine, yani alanadi.com/llms.txt adresine yüklenir. Önerinin güncel sürümü, dosyanın bir alt dizinde de durabileceğini ve yalnızca o dizinin altındaki sayfaları kapsayacağını söylüyor; örneğin /docs/llms.txt yalnızca /docs/ altını anlatır.

WordPress'te llms.txt nasıl oluşturulur?

En kolay yol, llms.txt üretimini destekleyen bir SEO eklentisi kullanmaktır; öneri sitesi Yoast SEO ve AIOSEO'yu bu entegrasyonlar arasında sayıyor. Eklenti kullanmak istemiyorsan dosyayı elle hazırlayıp FTP ya da dosya yöneticisiyle kök dizine yükleyebilirsin.

Kaynaklar

  1. The /llms.txt file (Jeremy Howard, llmstxt.org)
  2. Google Search Central: AI features and your website
  3. Ahrefs: We Analyzed 137K Sites, 97% of llms.txt Files Never Get Read
  4. RFC 8288: Web Linking
  5. Astro Docs: Endpoints