Web Sitenizi Yapay Zekâ Ajanlarına Hazırlamak: llms.txt, Yapılandırılmış Veri ve Ajanlar İçin Markdown Sayfalar

Kısaca: Bu ay Vercel ve Shopify'ın duyurduğu ajan tabanlı e-ticaret ürünleri (ayrıntılar), alışveriş ajanlarının mağazaları şu yollarla keşfettiğini anlatıyor: yapılandırılmış veri, site haritaları ve llms.txt; ayrıca ürün sayfalarının insanlara görsel, ajanlara Markdown döndürmesi. Aynı eğilim dokümantasyon sitelerinde de görünüyor: Next.js'in blogu ve Model Context Protocol'ün sitesi bir /llms.txt dizini sunuyor ve Next.js blog yazılarının .md (Markdown) sürümleri var. Peki bir hizmet sitesi veya e-ticaret siteniz için ne yapmalı? Kanıtlı ve düşük riskli olanlar: temiz HTML yapısı, yapılandırılmış veri (schema.org), güncel site haritası, hızlı ve taranabilir sayfalar, net iletişim/şirket bilgileri. Denenebilir ama kanıtlanmamış olanlar: llms.txt ve ajanlar için Markdown sürümleri. llms.txt'in arama sıralamasına veya yapay zekâ cevaplarına etkisi için burada güvenilir bir ölçüm sunamam; resmî bir web standardı olarak da sunulmuyor. Bu yazı mevcut uygulamaları ve sınırlarını anlatır.

Son güncelleme: 26 Ekim 2026

Ajanlar sitenizi nasıl “okur”?

Bir yapay zekâ ajanı veya asistanı sitenize iki şekilde ulaşabilir:

1. Tarayıcı gibi sayfayı çekip metni çıkarır. Bu durumda karmaşık JavaScript, gizli içerik veya yavaş sayfalar sorun çıkarır.
2. Özel kanallardan veri alır: MCP sunucuları, protokoller (ör. UCP) veya sitenin sunduğu yapılandırılmış veriler.

İkisinde de hedef aynı: ajanın sitenizin ne sunduğunu, fiyatını, koşullarını ve nasıl iletişime geçileceğini doğru anlaması.

Kanıtlı ve düşük riskli temeller

1. Temiz, anlamlı HTML

Başlık hiyerarşisi (h1, h2…), açıklayıcı bağlantı metinleri, tablolar ve listeler hem insanlara hem otomatik okuyuculara yardım eder. İçeriğin yalnızca JavaScript ile sonradan yüklendiği sayfalar, metin çıkarmayan okuyucular için görünmez olabilir. Sunucu tarafı oluşturma bu yüzden önemlidir: Next.js ile teknik SEO rehberimiz.

2. Yapılandırılmış veri (schema.org)

Ürün, organizasyon, hizmet, SSS ve yazı işaretlemeleri; fiyat, stok, adres, çalışma saatleri gibi bilgileri makine okunabilir kılar. Vercel/Shopify duyurusunda da yapılandırılmış veri ajan keşfi için sayılan yollardan biri. Doğrulamak için Google'ın Zengin Sonuçlar Testi gibi araçlar kullanılabilir.

3. Güncel site haritası ve düzgün tarama ayarları

sitemap.xml güncel ve doğru olsun; robots.txt ile önemli sayfaları yanlışlıkla engellemeyin. Çok dilli sitelerde hreflang ve kanonik bağlantılar tutarlı olmalı: çok dilli site rehberimiz.

4. Hız ve kararlılık

Yavaş ve hata veren sayfalar hem kullanıcı hem otomatik okuyucu için kötü sonuç doğurur.

5. Net ve doğrulanabilir bilgi

Hizmetleriniz, fiyat aralıkları (varsa), süreçleriniz, iletişim bilgileriniz, sık sorulan sorular ve politikalarınız açık yazılmış olsun. Ajanlar, kullanıcıya cevap verirken sizin sayfanızdaki bilgiyi alıntılayabilir; belirsiz bilgi yanlış alıntılanır. Yapay zekâ aramalarında görünürlük için GEO rehberimize bakın.

Denenebilir ama kanıtlanmamış: llms.txt

llms.txt, sitenin kökünde duran ve yapay zekâ modellerine/ajanlara sitenin önemli sayfalarını, kısa açıklamalarla, okunaklı biçimde listeleyen bir metin (Markdown) dosyası. Pratikte görülen örnekler:

• Next.js blogu: “Tüm Next.js içeriğinin dizini için /llms.txt.”
• Model Context Protocol sitesi: “Tüm dokümantasyon dizinini /llms.txt adresinden alın.”

Neden dikkat?

• Bu, resmî bir web standardı değil; topluluk tarafından önerilen bir uygulama.
• Arama motorlarının veya yapay zekâ asistanlarının bunu sıralama ya da alıntı için kullandığına dair burada doğrulayabildiğim bir kanıt yok.
• Dokümantasyon siteleri için daha anlamlı; küçük bir hizmet sitesinde kazancı sınırlı olabilir.

Ne zaman denemeye değer? Çok sayıda belge/içerik sayfanız varsa, bir ürün dokümantasyonu veya geniş bir bilgi bankanız varsa. Düşük maliyetli bir dosyadır; denemenin zararı genellikle yoktur, ama beklentiyi düşük tutun. Bakım yükünü de unutmayın: dosya güncel kalmazsa yanıltıcı olur.

Basit bir llms.txt örneği (Markdown):

# Şirket Adı

> Şirketin ne yaptığını anlatan bir iki cümle.

## Hizmetler
- [Web uygulamaları](adres): Ne sunduğunun kısa açıklaması
- [E-ticaret çözümleri](adres): Kısa açıklama

## Kaynaklar
- [Blog](adres): Rehber yazıları
- [İletişim](adres): Teklif ve destek

Ajanlara Markdown sunmak

Vercel Shop, ürün sayfalarını ajanlara Markdown olarak döndürüyor (açıklama, fiyat, seçenekler, stok), insanlara ise görsel sayfa gösteriyor. Next.js blogunda da yazıların .md uzantılı Markdown sürümleri var. Bu yaklaşımın avantajı: ajan, sayfa düzeni gürültüsü olmadan temiz içerik alıyor.

Dikkat edilecekler:

• İki sürüm arasında tutarlılık şart: Markdown sürümünde farklı veya eksik bilgi olmasın.
• Kullanıcıya ve ajana içerik olarak aynı gerçekleri gösterin. Arama motorlarına farklı içerik göstermek (“cloaking”) spam politikalarını ihlal edebilir; bu yüzden ajan odaklı bir sürüm eklerken Google'ın kurallarına ve spam güncellemesi rehberimize dikkat edin. Bunu yalnızca eşdeğer içeriği daha makine dostu bir biçimde sunma amacıyla ve uzman görüşüyle yapın.
• Bu, ileri düzey bir uygulama; çoğu hizmet sitesi için ilk öncelik değil.

Hizmet siteleri için öncelik sırası

E-ticaret siteleri için ek adımlar

• Ürün verisinde (fiyat, stok, varyant) tutarlılık ve güncellik,
• Canlı stok entegrasyonu,
• Ödeme/iade/kargo politikalarının net metinleri,
• Ajan kaynaklı trafik ve siparişleri ayırt eden analitik.

Ayrıntılar için ajan tabanlı e-ticaret yazımıza bakın.

Güvenlik ve gizlilik notları

• Ajanlara açtığınız her kanal (API, MCP sunucusu, Markdown uç noktası) bir saldırı yüzeyidir: MCP rehberimiz ve ajan erişim kontrolleri.
• Herkese açık dosyalara (llms.txt dahil) gizli veya dahili bilgi koymayın.
• Ajan kaynaklı isteklere hız sınırı ve kötüye kullanım koruması uygulayın.

Aktaş Digital ile yapay zekâ çağına hazır web siteleri

Modern, hızlı, yapılandırılmış veriyle güçlü ve ajanlara hazır web siteleri geliştiriyoruz. Mevcut sitenizin teknik SEO ve ajan hazırlığı denetimi için teklif formumuzu kullanabilirsiniz. İlgili hizmetlerimiz: web çözümleri.

Sık Sorulan Sorular

llms.txt zorunlu mu?

Hayır. Resmî bir standart değil; kanıtlanmış bir sıralama etkisi de yok. Dokümantasyon ağırlıklı sitelerde denenebilir.

llms.txt'i Google okuyor mu?

Bunu doğrulayabildiğim bir kaynağım yok. Bu nedenle sıralama veya görünürlük vaadinde bulunmuyorum.

Ajanlar için ayrı Markdown sayfaları yapmalı mıyım?

Çoğu hizmet sitesi için ilk öncelik değil. Yapıyorsanız içeriğin insan sürümüyle tutarlı olmasına dikkat edin.

En önemli üç şey nedir?

Temiz ve hızlı HTML, doğru yapılandırılmış veri ve net, güncel içerik.

Yapay zekâ cevaplarında nasıl görünürüm?

Garanti verilemez. Özgün, doğru, iyi yapılandırılmış içerik ve güvenilirlik işaretleri en sağlam yaklaşımdır: GEO rehberimiz.

Sonuç

Sitenizi ajanlara hazırlamak, çoğunlukla zaten iyi bir web sitesi için yapılması gerekenlerin devamı: temiz HTML, yapılandırılmış veri, güncel site haritası ve net içerik. llms.txt ve Markdown sürümleri ise ucuz denemeler, ama kanıtlanmış kazançlar değil. İlk adım: sitenizin en önemli beş sayfasını JavaScript kapalıyken açıp metin içeriğinin görünüp görünmediğini kontrol etmek.