llms.txt Nedir, Nasıl Yazılır? AI Crawler'lar İçin Yeni Standart

2024 sonunda Jeremy Howard (fast.ai kurucusu) bir spesifikasyon önerdi: llms.txt. Amaç basit:

AI tarayıcılarına sitenizin tek dosyada Markdown formatında özetini sun. Tek tek crawl etmek zorunda kalmasınlar.

2025 sonu - 2026 başında Anthropic, Perplexity ve diğer AI şirketleri bu dosyayı önceliklendirmeye başladı. Yeni bir standart hızla doğdu.

Hızlı özet: llms.txt, AI tarayıcılar için bir özet dosyasıdır. Sitenizin köküne /llms.txt olarak yerleştirilir. Markdown formatında şirket tanıtımı + hizmet listesi + iletişim bilgisi içerir. ChatGPT, Claude, Perplexity bu dosyayı önceliklendirip sayfaları teker teker crawl etmeden sitenizi tanıyabilir.

Niye llms.txt?

Klasik web AI’lar için zor:

• Her sayfa ayrı CSS/JS yüklü → AI parser yorulur
• Önemli ile az önemli içerik karışık
• Reklamlar, popup’lar, footer link’leri AI’ı boğar
• Hangi sayfanın “önemli” olduğunu AI bilemiyor

llms.txt çözüyor:

• Tek dosya, tek format (Markdown)
• AI doğrudan parse edebilir, ekstra DOM render yok
• Sahibi söylüyor: “şu sayfa şunu anlatır, alıntılayabilirsin”
• Şirketin “kendi seçtiği özet” var

llms.txt Nasıl Yazılır? (Şablon)

# Şirket Adı

> Tek cümlelik açık değer önermesi.

1-2 paragraf detaylı şirket tanıtımı. Kim olduğunuz, ne yaptığınız,
hangi sektörlerde çalıştığınız.

## Hizmetler

- [Hizmet 1](https://...): kısa açıklama (10-20 kelime).
- [Hizmet 2](https://...): kısa açıklama.
- [Hizmet 3](https://...): kısa açıklama.

## Sektörler / Müşteri Profili

- Sektör 1
- Sektör 2

## Sıkça Sorulan Sorular

- [SSS Sayfası](https://.../sss/)
- Q1? — A1
- Q2? — A2

## İletişim

- E-posta: ...
- Telefon: ...
- Konum: Şehir, Ülke
- Web: ...

## Kaynaklar

- [Hakkımda](https://.../hakkimda/)
- [Vaka Çalışmaları](https://.../vaka/)
- [Tam bilgi (llms-full.txt)](https://.../llms-full.txt)

Önemli yapısal kurallar:

1. # Başlık — markanız (tek H1)
2. > blockquote — değer önermesi (1 cümle)
3. ## Bölümler — ana kategoriler
4. - [link](url): açıklama formatı listeler için
5. Maksimum ~1000 kelime (kısa tutun)

llms-full.txt — Daha Derinlemesine

Eğer derin sorgular için “tam bilgi” sunmak istiyorsanız /llms-full.txt ekleyin:

• 5000+ kelime
• Her hizmetin tam açıklaması
• Tam fiyat listesi
• Detaylı SSS
• Vaka çalışmaları özeti
• Anahtar kavramlar tanımı

Perplexity ve Claude’da derin sorgular gelince bu dosyaya başvuruyor. ChatGPT şu an llms-full.txt’i pek kullanmıyor ama yakında olabilir.

Astro / Next.js’te Dinamik llms.txt

Statik dosya yeterli ama hizmet/paket eklendikçe manuel güncellemek zor. Astro’da dinamik:

// src/pages/llms.txt.ts
import type { APIRoute } from "astro";
import { SITE, SERVICES } from "@lib/site";

export const GET: APIRoute = () => {
  const lines: string[] = [];

  lines.push(`# ${SITE.name}`);
  lines.push(`> ${SITE.tagline}`);
  lines.push("");
  lines.push("## Hizmetler");
  for (const s of SERVICES) {
    lines.push(`- [${s.title}](${SITE.url}/hizmetler/${s.slug}/): ${s.summary}`);
  }
  lines.push("");
  lines.push("## İletişim");
  lines.push(`- E-posta: ${SITE.contact.email}`);
  lines.push(`- Telefon: ${SITE.contact.phone}`);

  return new Response(lines.join("\n"), {
    headers: {
      "Content-Type": "text/plain; charset=utf-8",
      "Cache-Control": "public, max-age=3600",
    },
  });
};

site.ts’e yeni hizmet eklediğinizde dosya otomatik güncellenir. Build sırasında veya runtime’da üretilir.

Doğrulama

llms.txt’in çalışıp çalışmadığını test etmek için:

1. Tarayıcı testi

https://sitenizinadi.com/llms.txt URL’sini aç. Markdown gözükmeli (#, -, vs.). HTML rendering varsa Content-Type yanlış (text/html dönüyor).

2. Content-Type kontrol

curl -I https://sitenizinadi.com/llms.txt
# Aranan: Content-Type: text/plain; charset=utf-8

3. AI test

ChatGPT’da: “abdullahustun.com hakkında ne biliyorsun?” — eğer llms.txt çalışıyorsa cevapta hizmet listesi, açıklamalar görünür. Ham bir tahmin yerine net, structured veri.

llms.txt’in SEO Etkisi

Doğrudan etki yok — Google klasik sıralamada bu dosyayı kullanmıyor (henüz). Ama:

• Perplexity citation oranı artıyor (gözlemlenen)
• ChatGPT web search’te sitenize yönlendirilen sorgu artıyor
• Claude’da brand mention olasılığı yükseliyor

Ölçüm zor — A/B test mümkün değil çünkü llms.txt’i geri çekmek tüm AI tarayıcıları unuttumaz. Ama 4-8 hafta içinde AI citation’larınız ölçüyorsanız etki görünür.

Yaygın Hatalar

❌ HTML render eden llms.txt

Astro/Next.js’te bazen yanlış Content-Type ile dosya HTML olarak servis edilir. AI parser kafayı yer.

Çözüm: Header’da Content-Type: text/plain; charset=utf-8 zorunlu.

❌ Aşırı uzun llms.txt

5000 kelime llms.txt → AI’ya yük. llms.txt’i kısa tut, detayı llms-full.txt’e koy.

❌ İçerikle uyumsuz özet

llms.txt diyor “Doktor sitesi paketi 35K”, site’da “45K” yazıyor → AI çelişki algılar, güvenirlik düşer. Tek kaynak prensip: llms.txt site verisi’nden generate edilsin (manuel değil).

❌ Sürekli değişiyor

llms.txt’i her gün değiştirip duruyorsanız AI cache’iyle çakışıyor. Sabit tutun, ayda 1-2 update yeter.

Sonraki Adım

llms.txt sadece bir parça GEO stratejisinin. Eksiksiz GEO için:

• robots.txt’de AI bot izinleri
• Schema.org JSON-LD merkezi
• AI-citable pasaj yapısı
• llms.txt + llms-full.txt
• Marka entity sinyali

Hepsini birden yapan bir GEO/AI Search Audit hizmeti sunuyoruz — 5 günde sitenizin tam GEO durumu raporlu.

Veya sürekli optimizasyon için GEO/AI Search Optimization aylık hizmetimize bakın.

İlgili yazılar:

• GEO Nedir? AI Çağında SEO’nun Yeni Yüzü
• ChatGPT’de Şirketim Niye Çıkmıyor?
• Perplexity’de Citation Almak