llms.txt nedir, ne yapmaz ve nasıl yazılır?

llms.txt önerisi neyi tanımlar?

Öneriyi 3 Eylül 2024’te Jeremy Howard yayımladı. llmstxt.org adresindeki güncel metin, 10 Ağustos 2026’da değiştirilen 2. sürümdür. Herkese açık bir GitHub deposunda tutulan ve topluluk katkısına açık, resmî olmayan bir özettir; IETF veya W3C standardı değildir. Hiçbir arama motoru ya da yapay zekâ sağlayıcısı onu okumakla yükümlü değildir.

Dosya Markdown’dır ve bölümleri sabit bir sıradadır:

1. Site veya proje adını içeren bir H1. Zorunlu olan tek bölüm budur.
2. Temel bilgilerin kısa özetini içeren bir blockquote.
3. Başlık içermeyen, ek bağlam veren isteğe bağlı paragraflar veya listeler.
4. Sıfır veya daha fazla H2 bölümü ve dosya listeleri: bir bağlantı içeren, istenirse iki nokta ve not ile devam eden liste öğeleri; örneğin - [Pricing](https://example.com/pricing): plans and limits.

Optional adlı bölüm, ajanın daha kısa bağlam gerektiğinde atlayabileceği ikincil bağlantıları barındırır.

Dosya kökte ya da /docs/llms.txt gibi bir yolun altında durabilir. Kendi yolu altındaki URL’leri kapsar; birden fazla dosya geçerliyse ajanlar en özel olanı kullanmalıdır. Öneri /.well-known/ kullanmaz; çünkü well-known konumları yalnızca origin kökünde bulunur ve birçok yazar paylaşımlı bir sunucuda yalnızca bir yolu denetler.

Öneri ayrıca sayfaların aynı URL’de temiz Markdown kopyalarını da önerir: sonuna .md eklenerek (page.html.md) veya 2. sürümden itibaren uzantı değiştirilerek (page.md). 2. sürüm, HTML <link> öğeleri veya HTTP Link başlığıyla gönderilen iki bağlantı ilişkisi ekler: kopya için rel="alternate" type="text/markdown" ve sayfayı kapsayan llms.txt için rel="describedby". Güncel metin llms-full.txt gibi bir eşlik eden dosya tanımlamaz; bir araç veya dokümantasyon platformu üretiyorsa bu kendi geleneğidir.

llms.txt, robots.txt ve sitemap.xml’den nasıl ayrılır?

Üç dosya, farklı okuyucular için farklı işler yapar.

Öneri de aynı ayrımı yapar: robots.txt otomatik erişimin neyin kabul edilebilir olduğunu söyler, llms.txt ise istendiğinde kullanılır. Site haritasının bunun yerine geçmediğini de ekler; çünkü sayfaların Markdown sürümlerini çoğunlukla içermez, başka sitelerdeki URL’leri kapsamaz ve genellikle bir modelin bağlam penceresine sığandan fazla içeriği kapsar.

Bu yüzden bir yapay zekâ tarayıcısına izin vermek veya onu engellemek istiyorsanız robots.txt’yi düzenleyin. Bir sayfayı llms.txt’ye eklememek onu gizlemez; oraya eklemek de bir tarayıcıyı engelleyen robots.txt kuralını geçersiz kılmaz. Kuralların nasıl eşleştirildiğini robots.txt rehberi açıklar.

Google ve yapay zekâ sağlayıcıları llms.txt hakkında ne söyledi?

Birincil kaynakların söyledikleri şöyle:

• Google Arama. Üretken yapay zekâ özellikleri rehberi (10 Temmuz 2026’da güncellendi), yapay zekâ özellikleri dâhil Google Arama’da görünmek için makine tarafından okunabilir dosyalara, yapay zekâ metin dosyalarına veya Markdown’a gerek olmadığını söyler; çünkü Arama bunları kullanmaz. llms.txt’yi doğrudan anar: bu tür dosyaları kullanan başka hizmetler için bir tane tutmak sorun değildir, ancak Google Arama’daki görünürlüğe ya da sıralamaya ne yardımı ne zararı olur.
• Chrome Lighthouse. Deneysel Agentic Browsing kategorisinde (Chrome 150 veya üzeri, 0–100 puan yok) alan adı kökünde dosyayı arayan bir llms.txt denetimi vardır. Sunucu hatası işaretlenir; 404 uygulanamaz sayılır, çünkü dosyayı sağlamak isteğe bağlıdır. Bu, bir geliştirici aracında varlık kontrolüdür; herhangi bir arama veya yapay zekâ ürününün dosyayı kullandığı anlamına gelmez.
• OpenAI. Tarayıcı sayfası OAI-SearchBot (ChatGPT’deki arama sonuçları) ve GPTBot (eğitim) için robots.txt denetimlerini açıklar; kullanıcı tetiklemeli ChatGPT-User ziyaretlerinin robots.txt’yi izlemeyebileceğini belirtir. OpenAI’ın bir sitenin llms.txt’sini okuduğunu söylemez.
• Anthropic. Yardım makalesi ClaudeBot, Claude-User ve Claude-SearchBot’u listeler ve bunların robots.txt’ye uyduğunu söyler. llms.txt’den söz etmez.
• Perplexity. Belgeleri arama sonuçları için PerplexityBot’u ve genellikle robots.txt’yi yok sayan, kullanıcı tetiklemeli Perplexity-User getiricisini kapsar. Perplexity’nin bir sitenin llms.txt’sini okuduğunu söylemez.
• Microsoft Bing. Microsoft veya Bing’den llms.txt hakkında bir yönerge bulunamadı. Bing Webmaster Tools’taki AI Performance’ın Şubat 2026 duyurusu dosyadan söz etmez.

1 Ekim 2026 itibarıyla bu sağlayıcıların hiçbiri bir sitenin llms.txt’sini sıralama, alıntı veya yanıtlar için kullandığını belgelemiyor. Bazıları kendi geliştirici dokümantasyonu için bir dosya yayımlıyor (OpenAI, Anthropic, Perplexity ve Google’ın Gemini API belgeleri); Cloudflare de öyle. Kendi belgeleriniz için dosya yayımlamak, başka sitelerin dosyalarını okumakla aynı şey değildir.

llms.txt ne zaman eklemeye değer, ne zaman bekleyebilir?

Dosyanın yazılması ucuzdur ve Google’a göre Arama’da zararsızdır. Asıl maliyet, onu doğru tutmaktır.

Kısa bir test: bir geliştirici URL’nizi kodlama asistanına yapıştırıp ürününüzle çalışmasını ister mi? Evetse, anahtar sayfaların Markdown kopyalarını içeren bir llms.txt iyi harcanmış bir öğleden sonradır. Yerel bir hizmetle ilgili yanıtlarda adınızın geçmesini istiyorsanız o zamanı net sayfa içeriğine ve tarayıcı erişimine ayırın. Ajanların ürününüz hakkında okumak yerine onun üzerinde işlem yapmasını istiyorsanız bir API’ye veya MCP sunucusuna bakın; MCP’ye giriş bunun nasıl çalıştığını açıklar.

Küçük bir site için minimal llms.txt örneği

example.com’daki varsayımsal bir vardiya planlama uygulaması için eksiksiz bir dosya:

# Example Rota

> Example Rota is a browser-based app for scheduling shifts in small cafés and shops. A free plan covers one location; paid plans add more locations.

Example Rota does not run payroll. Last reviewed: 2026-10-01.

## Docs

- [Getting started](https://example.com/docs/getting-started.md): Create a location, add staff and publish a first week
- [Shift templates](https://example.com/docs/templates.md): Repeating shifts, breaks and cover rules
- [API reference](https://example.com/docs/api.md): REST endpoints, authentication and rate limits

## Product

- [Pricing](https://example.com/pricing): Plans, limits and what each plan includes
- [Data and privacy](https://example.com/privacy): Where data is stored and how to export or delete it

## Optional

- [Changelog](https://example.com/changelog): Release notes by month

• Metin olarak sunun. https://example.com/llms.txt 200 durumu ve Markdown’ın kendisini döndürmelidir. Tek sayfalık uygulamalar bazen bilinmeyen yollara HTML kabuğuyla yanıt verir; yanıtı curl ile kontrol edin.
• Markdown kopyaları isteğe bağlıdır. Yayımlamıyorsanız, yukarıdaki Product bölümünde olduğu gibi normal HTML sayfalarına bağlantı verin.
• Özeti olgusal tutun. Ürünün ne olduğunu, kimler için olduğunu ve önemli sınırlarını yazın. Sloganları dışarıda bırakın.
• İstem değil, not yazın. Modelden sizi önermesini istemek, okuyucunun doğrulayabileceği hiçbir şey katmaz.
• Seçici olun. On iyi bağlantı iki yüz bağlantıdan iyidir; URL’lerin tam listesi site haritasına aittir.

Markdown kopyalarıyla her HTML sayfası kendi kopyasına ve kendisini kapsayan dosyaya işaret edebilir:

<link rel="alternate" type="text/markdown" href="/docs/getting-started.md">
<link rel="describedby" href="/llms.txt">

Oluşturucular, denetleyiciler ve doğrulayıcılar: dosyayı doğru tutmak

Eski bir fiyatı veya silinmiş bir sayfayı listeleyen dosya hiç olmamasından daha kötü olabilir; çünkü onu izleyen bir ajan güncelliğini yitirmiş bilgileri tekrarlayabilir.

• Dokümanlarla birlikte derleyin. Dokümantasyon Markdown’dan üretiliyorsa llms.txt’yi ve sayfa kopyalarını aynı derleme adımında üretin.
• Yayın kontrol listesine ekleyin. Fiyatlar, plan adları, platformlar veya URL’ler değiştiğinde dosyayı aynı sürümde güncelleyin.
• Bağlantıları otomatik denetleyin. Her URL, yönlendirme zinciri olmadan 200 yanıtı vermelidir. Bu tek satırlık kabuk komutu, dosyadaki her mutlak bağlantının durum kodunu yazdırır:

curl -s https://example.com/llms.txt | grep -oE 'https://[^) ]+' | while read -r u; do echo "$(curl -s -o /dev/null -w '%{http_code}' "$u") $u"; done

Bir llms.txt oluşturucu, site haritasından veya doküman klasöründen üretilen ilk taslak için yeterlidir. Hangi sayfaların önemli olduğuna karar veremez; noindex ayarlı veya robots.txt’de engellenmiş sayfaları da ekleyebilir. Çıktıyı yayımladığınız her sayfa gibi gözden geçirin.

Bir llms.txt denetleyicisi veya doğrulayıcısı mekanik kısımları doğrulayabilir: dosya erişilebilir mi, H1 başta mı, bağlantılar çözülüyor mu. Hiçbir denetleyici bir asistanın dosyayı okuyup okumadığını söyleyemez; çünkü sağlayıcılar bunu belgelemiyor.

Yapay zekâ yanıtları için daha önemli olanlar

Yapay zekâ yanıtları için kullanılabilir bir kaynak olmak istiyorsanız öncelik şunlardır:

1. İstediğiniz botlar için tarama erişimi. Yapay zekâ tarayıcıları robots.txt’de, her biri kendi belirteciyle denetlenir. OpenAI, OAI-SearchBot’u (ChatGPT araması) GPTBot’tan (eğitim), Anthropic Claude-SearchBot’u ClaudeBot’tan ayırır; Perplexity ise PerplexityBot’u belgeler. Google-Extended belirteci ayrı bir tarayıcı değil, robots.txt denetimidir: Google’ın taradığı içeriğin Gemini eğitimi ve temellendirmesinde kullanılıp kullanılamayacağını belirler ve Google’a göre Google Arama’daki dâhil edilmeyi veya sıralamayı etkilemez. Arama tarayıcılarına izin verip eğitim tarayıcılarını engellemek meşru bir tercihtir. Disallow: / içeren bir User-agent: * grubunun, robots.txt’yi izleyen ve kendi grubu olmayan her tarayıcıyı engellediğini unutmayın. OpenAI, robots.txt değişikliğinin sistemlerine ulaşmasının yaklaşık 24 saat sürebileceğini söyler.
2. Özel içerik için kimlik doğrulama. ChatGPT-User ve Perplexity-User gibi kullanıcı tetiklemeli getiriciler robots.txt’yi izlemeyebilir; RFC 9309 da robot kurallarının erişim yetkilendirmesi olmadığını söyler.
3. Sayfadaki net içerik. Google’ın yapay zekâ özellikleri rehberi özel dosyalara değil, özgün ve yararlı içeriğe ile keşif ve dizinlemeye hazır net bir teknik yapıya işaret eder. Gerçek soruları, erişilebilir bir sayfanın HTML’inde doğrudan yanıtlayın. Yapay zekâ görünürlüğü rehberi bir örnek üzerinden ilerler.
4. Sayfayla örtüşen yapılandırılmış veri. Google, üretken yapay zekâ aramasında yapılandırılmış verinin gerekmediğini ve özel schema.org işaretlemesine ihtiyaç olmadığını söyler; yine de Arama’da zengin sonuç uygunluğu için yapılandırılmış veriyi önerir. JSON-LD kullanıyorsanız görünen bilgilerle tutarlı tutun.
5. Tutarlı bilgiler. Ad, fiyatlar, planlar, bölgeler ve iletişim bilgileri sayfalarınızda, yapılandırılmış verinizde ve llms.txt’nizde tutarlı olmalıdır. Kendi sayfalarınız birbirini tutmuyorsa onları özetleyen her sistem tahmin yürütmek zorunda kalır.

Hiçbir dosya bir asistanı sizi alıntılamaya zorlayamaz. Denetleyebileceğiniz şey, sayfalarınızın erişilebilir, okunabilir ve doğru olmasıdır; tarama ve dizinleme temellerini teknik SEO rehberi kapsar.

Sitelemetry llms.txt hakkında neyi kontrol eder?

Sitelemetry’nin yapay zekâ görünürlüğü alanı, Starter planında $49/ay’dan başlayan altı alanlı denetimin (güvenlik, teknik SEO, yapay zekâ görünürlüğü, erişilebilirlik, performans ve entegrasyonlar) parçasıdır. llms.txt kontrolü dardır:

• Origin’de /llms.txt adresini bir kez ister ve durumu ile boyutu raporlar.
• Dosya, yalnızca 2xx durumu döndürüyorsa, boş değilse, HTML değilse ve bir bağlantı rehberine benziyorsa mevcut sayılır: # veya - ile başlayan bir satır, bir URL ya da docs veya sitemap gibi sözcükler. Eksik dosya, öneriyle birlikte kısmi sonuç olarak raporlanır.
• Formatı doğrulamaz, bağlantıları izlemez veya sınamaz ve herhangi bir yapay zekâ sisteminin dosyayı okuduğunu iddia etmez.

Aynı alanın tarayıcı erişimi sinyali, denetlenen adres için robots.txt’yi okur. Kuralları RFC 9309’un tarif ettiği gibi uygular: tarayıcıyı adlandıran grup, hiçbiri yoksa User-agent: *; * ve $ desenleri; ve en uzun eşleşen kural, eşitlikte Allow kazanır. /members/ gibi yalnızca başka bir bölümü kapsayan kural o adres aleyhine sayılmaz. Yapay zekâ tarayıcı kurallarından yalnızca yapay zekâ arama tarayıcılarına ait olanlar sinyali düşürür: OAI-SearchBot, Claude-SearchBot, PerplexityBot, MistralAI-Index, Amzn-SearchBot, meta-webindexer ve DuckAssistBot; üreticileri bunları yapay zekâ arama veya yanıt özellikleri için belgeler. User-agent: * grubundan devralınan engeller de sayılır; aynı engel Googlebot için de geçerliyse denetim bunu bir kez, engellenmiş sayfa olarak raporlar. Teknik SEO alanı bu kuralları bulgu olarak raporlar ve engellenen yapay zekâ arama tarayıcıları puanını da düşürür. Diğer yapay zekâ kuralları bilgi amaçlı raporlanır ve puanı değiştirmez: GPTBot, ClaudeBot, Google-Extended, Applebot-Extended veya CCBot gibi eğitim belirteçlerini engelleyen gruplar, ChatGPT-User, Claude-User veya Perplexity-User gibi kullanıcı isteğiyle çalışan getiricileri engelleyen gruplar ve Anthropic’in artık listelemediği eski anthropic-ai veya Claude-Web belirteçlerini yalnızca adlandıran kurallar. Belirteç listesi, her üreticinin 8 Kasım 2026’da kontrol edilen tarayıcı belgelerinden gelir ve her tarayıcıyı kapsamaz; listede olmayan belirteçleri kendiniz kontrol edin. Alan ayrıca JSON-LD yapılandırılmış verisini schema.org’a göre doğrulamadan raporlar. Denetim, JavaScript çalıştırmadan sayfa örneğinin statik HTML’ini okur; ChatGPT, Claude, Perplexity veya Google’ı sorgulamaz ve yapay zekâ yanıtlarındaki alıntıları izlemez.

Free plan yalnızca güvenlik kontrollerini kapsar; bir Free çalışma alanı, yapay zekâ görünürlüğü alanına ait bir denetim kredisiyle bu denetimi de çalıştırabilir (her yeni Free çalışma alanı her alan için 1 krediyle başlar). Ücretsiz Yayına Hazırlık Snapshot’ı kayıt olmadan sekiz pasif kontrol çalıştırır; llms.txt, robots.txt veya yapılandırılmış veriye bakmaz ve altı alanlı denetim değildir. Plan ayrıntıları fiyatlandırma sayfasındadır.