llms.txt: Nedir, Nasıl Yazılır ve Nasıl Doğrulanır

Kısaca: llms.txt, /llms.txt adresinde yer alması önerilen ve dil modellerine sitenizin kısa bir haritasını sunan bir Markdown dosyasıdır: # Site adı başlığı (tek zorunlu bölüm), > ile yazılmış isteğe bağlı tek satırlık bir özet ve en faydalı sayfalarınızı Markdown bağlantıları olarak listeleyen ## bölümleri. Tarama davranışını kontrol etmez, Google için bir sıralama sinyali değildir ve büyük yapay zeka tarayıcıları bu dosyayı okuduklarını belgelerinde belirtmez. Buna rağmen yayınlamak ucuzdur ve sitenize yönlendirilen araçlar ile ajanlar için faydalıdır. On dakikada yazın, düz metin olarak 200 durum koduyla sunun ve doğrulayın.

Az sayıda web dosyası, belgelenmiş etkisi bu kadar küçükken bu kadar ilgi çekti. Eklentiler tek tıkla llms.txt ekliyor, rehberler bunun sizi "ChatGPT'ye sokacağını" vaat ediyor ve birçok site sahibi içinde ne olması gerektiğini bilmeden bir tane yayınlıyor. Bu rehber önerinin neyi tanımladığına, yapay zeka sağlayıcılarının neyi söyleyip neyi söylemediğine ve doğru, gerçekten işe yarayan bir dosyanın nasıl yazılacağına odaklanıyor. Ayrıca ücretsiz llms.txt kontrol aracımızın tam olarak neleri doğruladığını ve bildirdiği her sorunun nasıl düzeltileceğini açıklıyor.

llms.txt nedir

llms.txt önerisi 3 Eylül 2024'te Jeremy Howard tarafından yayımlandı. Kendini "ajanların bir web sitesini kullanmasına yardımcı olacak bilgiyi sağlamak için bir /llms.txt dosyası kullanımını standartlaştırma önerisi" olarak tanımlıyor; sayfa ayrıca önerinin artık ikinci sürümünde olduğunu ve topluluk katkısına açık olduğunu belirtiyor.

Fikir şu: HTML sayfaları, bir modelin sınırlı bağlam penceresini boşa harcayan gezinme öğeleri, script'ler ve yerleşim kodlarıyla dolu. İnsan eliyle yazılmış kısa bir Markdown dosyası ise modele sitenin ne olduğunu ve işe yarar içeriğin nerede durduğunu söyleyebilir. Öneriye göre llms.txt "eğitimden çok çıkarım (inference) için yararlı olur"; yani bir model ya da ajan bir soruyu yanıtlarken sitenizi canlı olarak okuduğunda.

Format, bölüm bölüm

Öneri bölümleri sabit bir sırayla tanımlıyor:

Dosya listesindeki her giriş, zorunlu bir [ad](url) bağlantısı içeren ve isteğe bağlı olarak iki nokta üst üste ile sayfa hakkında bir not taşıyan bir Markdown liste öğesidir. Öneri ayrıca tek tek sayfaların Markdown sürümlerinin, aynı URL'nin sonuna .md eklenerek (örneğin page.html.md) ya da uzantı değiştirilerek (page.md) sunulmasını öneriyor.

Dosya genellikle sitenin kök dizininde bulunur, ancak öneri onun herhangi bir yolda durmasına ve o yolun altındaki sayfaları kapsamasına izin verir; bu, /docs/ altında yer alan dokümantasyon için uygundur. Örneğin Next.js dokümantasyonu okuyucuları /docs/llms.txt adresindeki bir dizine yönlendiriyor.

llms.txt ne değildir

• Erişim kontrolü değildir. RFC 9309 ile tanımlanan robots.txt, tarayıcılara nelere erişebileceklerini söyler. llms.txt hiçbir şeye izin vermez, hiçbir şeyi yasaklamaz. Öneri de ikisinin "farklı amaçları olduğunu" ve llms.txt'nin robots.txt'yi tamamlayabileceğini belirtiyor.
• Site haritası değildir. Site haritası, arama motorları için dizine eklenebilir her URL'yi listeler. llms.txt ise bağlamıyla birlikte özenle seçilmiş birkaç sayfayı listeler. Öneri, site haritasının llms.txt'nin "yerini tutmadığını" söylüyor.
• Google şartı değildir. Google'ın yapay zeka özellikleri rehberi şöyle diyor: "Bu özelliklerde yer almak için yeni makine tarafından okunabilir dosyalar, yapay zeka metin dosyaları veya işaretlemeler oluşturmanız gerekmez."
• Büyük yapay zeka tarayıcılarının belgelerinde yer almaz. OpenAI, Anthropic ve Perplexity tarayıcı belgeleri robots.txt token'larını ve IP aralıklarını açıklıyor; Ekim 2026 itibarıyla bu sayfaların hiçbiri llms.txt'den söz etmiyor.

Yine de neden yayınlanmalı

Abartıya kaçmadan savunulabilecek üç neden var:

1. Ajanlar ve kodlama asistanları, bir siteye yönlendirildiklerinde onu okur. Bir geliştirici dokümantasyon URL'nizi bir asistana yapıştırırsa, Markdown bağlantılarından oluşan temiz bir dizin, işlenmiş gezinme menünüzden daha kolay kullanılır. Dokümantasyon platformlarının bunu ilk benimsemesinin nedeni budur; llmstxt.org, Mintlify, GitBook, Yoast SEO, AIOSEO, Wix ve diğerlerindeki oluşturucuları listeliyor.
2. Faydalı bir editoryal çalışmayı zorunlu kılar. Ne yaptığınızı tek cümleyle yazmak ve önemli olan on sayfayı seçmek, ana sayfanızı hem insanlara hem de yapay zeka yanıtlarını gerçekten besleyen arama tarayıcılarına anlaşılır kılan işin ta kendisidir.
3. Neredeyse hiçbir maliyeti yoktur. Statik bir dosyadır; bağlantıları güncel tutmak dışında süregelen bir bakım gerektirmez.

Yapmayacağı şey, yapay zeka tarayıcılarının erişemediği bir siteyi düzeltmektir. OAI-SearchBot güvenlik duvarınızdan 403 alıyorsa hiçbir metin dosyası bunu değiştirmez. Önce yapay zeka tarayıcı kontrol aracıyla erişimi kontrol edin ve ayrıntılar için yapay zeka tarayıcıları rehberimizi okuyun.

Kopyalamaya hazır llms.txt örnekleri

Bir yazılım ürünü

# Tallyboard

> Tallyboard is time tracking and invoicing software for agencies of 5 to 200 people. Plans start at $12 per user per month; a 14-day trial needs no card.

Tallyboard runs in the browser and on iOS and Android, and integrates with QuickBooks, Xero and Slack.

## Product
- [Features](https://www.example.com/features): timers, timesheets, approvals, invoicing
- [Pricing](https://www.example.com/pricing): plans, limits and annual discount
- [Integrations](https://www.example.com/integrations): QuickBooks, Xero, Slack, Jira

## Help
- [Getting started](https://www.example.com/help/getting-started): set up a workspace in 10 minutes
- [API reference](https://www.example.com/docs/api.md): REST API, authentication and rate limits

## Optional
- [Changelog](https://www.example.com/changelog)
- [Company](https://www.example.com/about)

Yerel bir işletme

# North Street Bakery

> Family bakery in Springfield, Illinois, baking sourdough, pastries and custom cakes since 2009. Open Monday to Saturday.

## Visit
- [Location and hours](https://www.example.com/visit): 120 North Street, opening hours, parking
- [Contact](https://www.example.com/contact): phone, email and order form

## Order
- [Custom cakes](https://www.example.com/cakes): flavors, sizes, prices and lead time
- [Catering](https://www.example.com/catering): office breakfast boxes

Bir dokümantasyon sitesi

# Lumen SDK

> Lumen is an open-source JavaScript SDK for building offline-first apps. MIT license.

## Docs
- [Quick start](https://docs.example.com/quick-start.md): install and first sync in five minutes
- [Configuration](https://docs.example.com/config.md): every option with defaults
- [Conflict resolution](https://docs.example.com/conflicts.md): how merges work

## Examples
- [Todo app](https://docs.example.com/examples/todo.md)

## Optional
- [Architecture notes](https://docs.example.com/internals.md)

Dosyayı faydalı kılan kurallar: özeti olgular olarak yazın (ne, kimin için, nerede, fiyat), 200 döndüren kanonik sayfaların mutlak URL'lerini kullanın, notları kısa tutun ve elinizde varsa Markdown sürümlerine bağlantı verin.

Searvia llms.txt kontrol aracı nasıl çalışır

llms.txt kontrol aracı, web sitesi SEO kontrol aracımızla aynı altyapıyı çalıştırır. Bir alan adı ya da sayfa adresi girersiniz; araç o sayfayı (yalnızca alan adı girerseniz ana sayfanızı) ve çevresindeki site dosyalarını okur, yaklaşık 20 saniyede 38 kontrol yapar ve bu aracın konusu olan üç kontrolü en üstte gösterir. Her birinin tam olarak ne yaptığı şöyle:

llms.txt dosyası (düşük öncelik). Kontrol aracı sayfayı son adresine kadar takip eder, ardından o host üzerinde /llms.txt adresini yönlendirmeleri izleyerek ister. Dosya yalnızca şu koşullarda mevcut sayılır:

• 200 durum koduyla yanıt veriyorsa,
• HTML sayfası değilse (text/html içerik türü ya da <!doctype veya <html> ile başlayan bir gövde, sunucunuzun bir web sayfası döndürdüğü anlamına gelir; genellikle bir "bulunamadı" sayfası veya ana sayfadır) ve
• boş değilse.

Dosya, isteğe bağlı bir bayt sırası işareti (BOM) ve baştaki boşluklardan sonra, önerinin zorunlu kıldığı H1 olan # ile başlıyorsa kontrol geçer. Rapor ayrıca [metin](url) biçimindeki Markdown bağlantılarını sayar. llms.txt isteğe bağlı olduğu için dosya eksikse ya da başlığı yoksa kontrol başarısız olmaz, uyarı verir.

Kontrol aracı alıntı bloğunu, bölüm sırasını veya bağlantı verilen sayfaların var olup olmadığını doğrulamaz; ayrıca yalnızca host'un kök dizinine bakar, /docs/llms.txt adresine bakmaz. llms-full.txt dosyasını da aramaz.

Yapay zeka tarayıcı erişimi (yüksek öncelik). Aynı rapor, robots.txt'nin 10 yapay zeka ve arama tarayıcısının ile 2 yapay zeka eğitimi devre dışı bırakma token'ının sayfayı almasına izin verip vermediğini ve güvenlik duvarınızın GPTBot olarak kendini tanıtan bir isteği geri çevirip çevirmediğini gösterir (bu bir uyarıdır, kanıt değildir; çünkü istek OpenAI'ın adreslerinden gelmez). Bu aracın odağındadır, çünkü tarayıcıların ulaşamadığı bir llms.txt anlamsızdır.

XML site haritası (orta öncelik). Kontrol aracı önce robots.txt içindeki Sitemap: satırlarını, ardından /sitemap.xml ve /sitemap_index.xml adreslerini dener; en fazla dört adres. Kök öğesi <urlset> ya da <sitemapindex> olan ve 200 ile yanıt veren ilk adreste başarılı olur ve kaç <loc> girişi bulduğunu bildirir. Site haritası ile llms.txt farklı işler görür; ikisine de ihtiyacınız var.

A+ ile F arasındaki genel not, önceliğe göre ağırlıklandırılmış 38 kontrolün tamamını kapsar ve rapor bir bağlantıyla paylaşılabilir.

Sonucu okumak

0 bağlantıyla geçmek, dosyanın başlığı olduğu ama hiç Markdown bağlantısı bulunmadığı anlamına gelir; yani araçlara takip edecek bir şey sunmaz. 300 bağlantıyla geçmek ise bir site haritası yapıştırdığınız anlamına gelir; onu önemli sayfalara indirin.

Her llms.txt sorunu nasıl düzeltilir

1. No llms.txt file was found

1. Yukarıdaki örneklerden birini kullanarak dosyayı yazın. UTF-8 düz metin olarak, adı tam olarak küçük harfli llms.txt olacak şekilde kaydedin.
2. Sunucunuzun site kök dizini olarak sunduğu yere koyun:
   • Statik siteler ve çoğu framework: public/ veya static/ klasörü (Next.js, Vite, Astro, Nuxt ve Hugo bu klasörü kök dizinde sunar).
   • WordPress: Yoast SEO ve AIOSEO dosyayı oluşturabilir; aksi halde WordPress kök klasörüne, wp-config.php dosyasının yanına yükleyin.
   • Shopify: kök dizine dosya yükleyemezsiniz; bir uygulama kullanın ya da dosyayı Files bölümüne yükleyip /llms.txt adresinden ona bir URL yönlendirmesi oluşturun. Kontrol aracı yönlendirmeleri takip ettiği için hedef metin olarak sunulduğu sürece bu yöntem işe yarar.
   • Wix: llmstxt.org, Wix'i dosyayı destekleyen platformlar arasında listeliyor; sitenizin SEO ayarlarına bakın.
3. https://yourdomain.com/llms.txt adresini gizli bir pencerede açın ve web siteniz yerine ham Markdown gördüğünüzden emin olun.
4. llms.txt kontrol aracını tekrar çalıştırın.

2. llms.txt exists but does not start with a "# " title

Boş olmayan ilk karakterler # ve ardından bir boşluk olmalıdır. Yaygın nedenler:

• Dosya özetle ya da boş bir listeyle başlıyor; ilk satır olarak # Site adınız ekleyin.
• Başlık boşluksuz #Ad olarak ya da altında === olan Ad şeklinde yazılmış. # Ad kullanın.
• Dosyanın başında görünmez bir bayt sırası işareti (BOM) var. Kontrol aracımız bunu yok sayar, ancak bazı diğer ayrıştırıcılar # ifadesini ilk karakterler olarak görmez. Emin olmak için dosyayı editörünüzde "BOM'suz UTF-8" olarak kaydedin.
• Bir eklenti başlığın üstüne bir yorum ya da "generated-by" satırı eklemiş. Onu aşağı taşıyın ya da silin.

3. Adres dosya yerine bir web sayfası döndürüyor

Bir dosya yüklediniz ama kontrol aracı hâlâ bulunamadığını söylüyorsa, başlıkları isteyin:

curl -I https://yourdomain.com/llms.txt

• 200 durum kodu ve Content-Type: text/html: uygulamanızın her şeyi yakalayan (catch-all) rotası bilinmeyen her URL'ye ana sayfa ya da 200 durum kodlu bir "bulunamadı" sayfası döndürüyor. Dosyayı uygulama rotalarından önce sunun ya da statik dosya işleyicisini yapılandırın.
• 404 durum kodu: dosya sunucunun baktığı yerde değil. Klasörü ve dosya adını kontrol edin.
• Ana sayfaya 301 veya 302: bir yönlendirme kuralı bilinmeyen yolları yakalıyor. Bir istisna ekleyin.
• 403 durum kodu: bir güvenlik kuralı .txt dosyalarını ya da bilinmeyen yolları engelliyor. /llms.txt yoluna izin verin.

Ardından içerik türünü düz metin olarak ayarlayın. Nginx'te:

location = /llms.txt {
    default_type text/plain;
    charset utf-8;
}

Apache'de site yapılandırmasına ya da .htaccess dosyasına eklenen AddType text/plain .txt aynı işi görür. text/markdown da uygundur; HTML dışındaki her şey geçer.

4. Yapay zeka tarayıcı erişimi başarısız ya da site haritası eksik

Bunlar daha önemli oldukları için llms.txt raporuyla birlikte gelir. Yapay zeka arama tarayıcıları robots.txt'de ya da güvenlik duvarında engellenmişse önce bunu düzeltin; adımlar yapay zeka tarayıcıları rehberimizde var. Site haritası bulunamadıysa dizine eklenebilir sayfalarınızdan oluşan bir tane yayınlayın, robots.txt içinde Sitemap: https://www.example.com/sitemap.xml gibi bir satırla belirtin ve Google Search Console ile Bing Webmaster Tools'a gönderin.

Güncel tutun

Ölü bağlantılar içeren bir llms.txt, hiç olmamasından kötüdür; çünkü araçları hata sayfalarına gönderir. Üç alışkanlık onu doğru tutar:

• Mümkünse veriden üretin. Dosyayı gezinme yapınızdan ya da dokümantasyon dizininizden yazan bir derleme adımı asla eskimez.
• Fiyatlar, planlar veya ürün yelpazesi değiştiğinde gözden geçirin. Eskimeye en yatkın bölüm özet satırıdır.
• Yalnızca kanonik sayfalara bağlantı verin. Yönlendirilen URL, izleme parametresi ya da noindex sayfa olmasın.

Uygulamalı örnek (varsayımsal)

Aşağıdaki örnek varsayımsaldır, gerçek veri değildir. Uydurma bir tur operatörü olan Fernway Travel, llms.txt oluşturan bir eklenti kuruyor. Kontrol aracı "No llms.txt file was found." diyor. curl -I 200 durum kodu ve Content-Type: text/html gösteriyor: sitenin önbellek katmanı yeni adres için önbelleğe alınmış ana sayfayı sunmuş. Önbellek temizlendikten sonra dosya görünüyor, ancak kontrol aracı bu kez dosyanın "exists but does not start with a "# " title" olduğunu söylüyor: eklenti en başa bir yorum satırı yazıyor. Ekip eklentiyi manuel moda alıp dosyayı elle yazıyor:

1. # Fernway Travel, ardından bir özet: Portekiz ve İspanya'da küçük gruplu yürüyüş turları, 6 ile 12 misafir, Nisan'dan Ekim'e.
2. ## Tours altında sekiz tur sayfası ve not olarak süreleri ile fiyat aralıkları.
3. ## Plan your trip altında rezervasyon koşulları, nelerin dahil olduğu ve SSS.
4. ## Optional altında blog ve hakkımızda sayfası.

Kontrol aracı 14 bağlantıyla geçiyor. Ekip aynı raporda site haritasının robots.txt'de eksik olduğunu da fark ediyor ve Sitemap: satırını ekliyor.

10 dakikalık llms.txt kontrol listesi

1. Önce yapay zeka tarayıcı erişimini kontrol edin; tarayıcılar engelliyse llms.txt yardımcı olamaz.
2. # Ad, tek satırlık olgusal bir özet ve önemli bağlantılardan oluşan iki ya da üç ## bölümü yazın.
3. 200 döndüren mutlak ve kanonik URL'ler kullanın.
4. Kök dizine yükleyin, düz metin olarak sunun, BOM'suz kaydedin.
5. llms.txt kontrol aracıyla doğrulayın.
6. Ürününüz ya da fiyatlarınız değiştiğinde gözden geçirmek için bir hatırlatıcı koyun.

Searvia nasıl yardımcı olur

Ücretsiz llms.txt kontrol aracı, dosyayı yapay zeka tarayıcı erişimi ve site haritanızla birlikte tek bir paylaşılabilir raporda doğrular. Yapay zeka arama hazırlığı kontrol aracı aynı altyapıyı, asistanların ihtiyaç duyduğu her şeye odaklanarak çalıştırır: tarayıcı erişimi, JavaScript olmadan içerik, kimlik işaretlemesi, yanıt tarzı içerik ve güncellik. Bir Searvia hesabında AI visibility, müşterilerinizin gerçek sorularını her hafta yapay zeka asistanlarına sorar ve sizden bahsedilip bahsedilmediğini, önerilip önerilmediğini ya da kaynak gösterilip gösterilmediğini gösterir; Check access düğmesi ise her yapay zeka botu için robots.txt kurallarını, güvenlik duvarı engellerini ve llms.txt'yi test eder. Bu çalışmanın karşılığını verip vermediğini söyleyen ölçüm budur. Daha geniş strateji için üretken motor optimizasyonu (generative engine optimization) rehberimize bakın.