Nodus Works olarak yönettiğimiz Shopify projelerinde giderek artan bir soru görüyoruz: "llms.txt dosyasını mağazamıza nasıl ekleriz?" Konuya ilişkin internette dolaşan kurulum talimatlarının büyük çoğunluğu Shopify platformuna özgü kritik bir teknik gerçeği atlıyor Shopify, 2026 itibarıyla llms.txt dosyasının mağaza domain kökünden sunulmasını yerel olarak desteklemiyor. Bu rehber o boşluğu kapatır: doğru çalışan tek yöntemi, kaynaklarıyla birlikte adım adım açıklar.
LLM ve LLMs.txt Nedir?
LLM (Large Language Model), büyük metin veri kümeleri üzerinde eğitilen ve doğal dil anlama ile üretme işlemlerini gerçekleştiren yapay zeka modellerini ifade eder. ChatGPT, Claude ve Google Gemini bu kategorinin en yaygın örnekleridir. E-ticaret bağlamında LLM'ler üç alanda doğrudan değer üretir: kullanıcıya özelleştirilmiş ürün önerileri (hiperkişileştirme), semantik arama sonuçlarının iyileştirilmesi ve müşteri destek otomasyonu.
LLMs.txt ise bu modellerin bir web sitesini daha doğru anlamasını sağlayan bir yönlendirme dosyasıdır. 2024 yılında Answer.AI kurucu ortağı Jeremy Howard tarafından önerilen bu standart, site kök dizinine yerleştirilen sade bir Markdown dosyasıdır. LLM tarayıcıları siteyi tararken bu dosyayı okur ve hangi sayfaların, koleksiyonların ve içeriklerin öncelikli olduğunu anlar; HTML karmaşasını deşifre etmek zorunda kalmaz.
LLMs.txt ile robots.txt Arasındaki Fark
Kritik Not: robots.txt Shopify tarafından yourstore.com/robots.txt adresinde otomatik olarak sunulur. llms.txt için aynı mekanizma mevcut değildir. Shopify tema editöründeki Assets klasörüne yüklenen dosyalar cdn.shopify.com/... CDN adresinden sunulur; yourstore.com/llms.txt üzerinden erişilemez. Kaynak: Shopify Developer Community — Adding llms.txt file to Shopify store
Shopify'de LLMs.txt Neden Doğrudan Yüklenemiyor?
Shopify'ın platform mimarisindeki kısıtlama şuradan kaynaklanır: mağaza dosyaları (tema, görseller, statik varlıklar) Shopify'ın global CDN ağında barındırılır. Tema editörü üzerinden yüklenen her dosya cdn.shopify.com/s/files/... yapısında bir URL alır. Mağazanın kendi domaini (yourstore.com) ise Shopify sunucularına proxy üzerinden bağlanır; bu proxy sistemi özel dosya yönlendirmesine izin vermez.
Sonuç şudur: yourstore.com/llms.txt adresine yapılan bir istek Shopify tarafından işlenir, mağazada bu path için tanımlı bir route olmadığından 404 döner. CDN adresindeki dosya bu isteği karşılamaz.
Bu kısıtlamanın çözümü domain katmanında, yani Shopify'a ulaşmadan önce devreye girecek bir ara katmanda üretilmeli. Cloudflare Worker tam olarak bu görevi üstlenir.
Shopify'de LLMs.txt Kurulumu: Cloudflare Worker Yöntemi
Domain Cloudflare üzerinden yönetiliyorsa bu yöntem çalışır. Cloudflare Worker, /llms.txt isteğini Shopify sunucusuna ulaşmadan yakalar ve dosya içeriğini doğrudan döndürür; diğer tüm istekler Shopify'a iletilmeye devam eder.
Çalışan bir örnek: jennaraecakes.com/llms.txt bu implementasyon Shopify Developer Community'de FireNet_Designs tarafından paylaşılmıştır.
Adım 1: LLMs.txt İçeriğini Hazırlayın
Markdown formatında içeriğinizi yazın. Shopify mağazası için minimum gerekli yapı:
# Mağaza Adı
> Mağazanızın tek cümlelik açıklaması: ne satıyorsunuz, kime hitap ediyorsunuz.
## Sayfalar
- [Ana Sayfa](https://yourstore.com)
- [Hakkımızda](https://yourstore.com/pages/hakkimizda)
- [İletişim](https://yourstore.com/pages/iletisim)
## Koleksiyonlar
- [Tüm Ürünler](https://yourstore.com/collections/all)
- [Koleksiyon Adı](https://yourstore.com/collections/koleksiyon-adi)
## Politikalar
- [İade Politikası](https://yourstore.com/policies/refund-policy)
- [Gizlilik Politikası](https://yourstore.com/policies/privacy-policy)
## Notlar
- Bu mağaza Shopify altyapısında çalışmaktadır.
- Ürün verileri Shopify API üzerinden erişilebilir.Bu içeriği bir metin editöründe hazırlayın; Worker koduna tek satıra dönüştürülmüş halde yapıştıracaksınız.
Adım 2: Cloudflare'de Worker Oluşturun
Cloudflare Dashboard'a giriş yapın. Sol menüden Workers & Pages > Create Application > Create Worker yolunu izleyin. Worker'a bir isim verin (örnek: llms-txt-worker).
Editörde aşağıdaki kodu yapıştırın. WRITE YOUR LLMS.TXT RAW TEXT HERE satırını hazırladığınız içerikle, example.com kısmını kendi domain adresinizle değiştirin:
export default {
async fetch(request) {
const { pathname } = new URL(request.url);
if (pathname === "/llms.txt" || pathname === "/llms.txt/") {
const body = `WRITE YOUR LLMS.TXT RAW TEXT HERE`;
return new Response(body, {
status: 200,
headers: {
"Content-Type": "text/plain; charset=utf-8",
"Cache-Control": "public, max-age=86400",
"X-Served-By": "llms-worker"
},
});
}
const origin = "https://example.com";
return fetch(origin + pathname + new URL(request.url).search, request);
},
};Deploy butonuna tıklayın.
Adım 3: Worker'a Route Tanımlayın
Worker'ın mağaza domaininize bağlanması için route eklemeniz gerekir. Worker sayfasında Settings > Triggers > Add Route yolunu izleyin.
Şu iki route'u ekleyin:
yourstore.com/llms.txt
yourstore.com/llms.txt/*
Zone (alan adı) olarak kendi domain adınızı seçin. Kaydedin.
Adım 4: DNS Ayarlarını Kontrol Edin
Domain Cloudflare üzerinde proxy modunda olmalıdır. Cloudflare DNS panelinde A veya CNAME kaydınızın yanındaki bulut ikonunun turuncu (proxy aktif) göründüğünü doğrulayın. Gri bulut ikonuysa (DNS only) Worker devreye girmez.
Adım 5: Test Edin
curl -I https://yourstore.com/llms.txtYanıtta şu header'ları görmeniz gerekir:
Content-Type: text/plain; charset=utf-8
X-Served-By: llms-worker
HTTP 200 status kodu
Tarayıcıdan yourstore.com/llms.txt adresine giderek dosyanın doğru içerikle yüklendiğini de doğrulayın.
İpucu: Domain Cloudflare üzerinden yönetilmiyorsa bu yöntem çalışmaz. Alternatif olarak Vercel Edge Function veya nginx reverse proxy aynı mantıkla kurulabilir. Ancak Cloudflare ücretsiz planıyla sunulan Workers, en az yapılandırma gerektiren ve global edge ağında çalışan çözümdür.
LLMs.txt Shopify Mağazasına Ne Kazandırır?
LLMs.txt'nin değeri iki ayrı kanaldan gelir: yapay zeka arama motorlarında görünürlük ve içerik doğruluğu.
Yapay Zeka Arama Motoru Görünürlüğü
ChatGPT Search, Perplexity, Google AI Overviews ve Microsoft Copilot; kullanıcı sorgularını yanıtlarken web kaynaklarına başvurur. Bu sistemlerin bir mağazayı doğru anlayıp doğru bağlamda alıntılaması, llms.txt sayesinde HTML ayrıştırma hatasından bağımsız hale gelir. Dosyada açıkça belirtilen koleksiyonlar, ürün kategorileri ve politika sayfaları, LLM'nin mağazayı ilgili sorularda kaynak olarak kullanma olasılığını artırır.
Nodus Works verilerine göre llms.txt'yi CF Worker yöntemiyle doğru biçimde kuran Shopify mağazaları, Perplexity ve ChatGPT Search sorgularında organik atıf almaya 4–6 hafta içinde başladı; robots.txt veya sitemap değişikliği olmaksızın.
İçerik Doğruluğu ve Marka Kontrolü
LLM'ler mağazayı taramadan önce llms.txt dosyasını okursa önceliklendirme sizin elinizde olur: hangi ürün kategorilerinin, hangi koleksiyonların ve hangi sayfaların öne çıkmasını istediğinizi dosyada tanımlamış olursunuz. Bu, marka kimliğini yapay zeka yanıtlarında korumak açısından robots.txt'nin oynayamadığı bir rol üstlenir.
LLMs.txt ile Klasik SEO Araçlarının Karşılaştırması
Shopify mağazanızın arama motoru altyapısını llms.txt ile birlikte yapılandırmak istiyorsanız Nodus Works'ün SEO optimizasyon hizmeti, teknik SEO kurulumunu ve AI arama görünürlüğünü birlikte ele alır; robots.txt, sitemap, schema markup ve llms.txt entegrasyonu tek süreçte tamamlanır.
2026'da LLMs.txt Neden Şimdiden Kurulmalı?
LLMs.txt henüz zorunlu bir standart değil. Peki neden şimdiden kurulması gerekiyor?
Yapay zeka arama trafiği 2025'te tüm web trafiğinin tahminen %5–8'ine ulaştı; 2026 sonunda %12–15 bant genişliğine erişmesi bekleniyor (Cloudflare Radar, 2025 verileri). Bu trafiğin büyük bölümü alışveriş sorgularını kapsıyor: "en iyi organik bebek kıyafeti markaları Türkiye", "Shopify mağazalarından güvenli alışveriş" gibi. Bu sorularda kaynak olarak gösterilen mağazalar llms.txt ile kendini yapılandırmış olanlardır; çünkü LLM tarayıcısı dosyayı bulduğunda onu okur, bulmadığında tahmin yürütür.
Nodus Works olarak gözlemlediğimiz bir diğer örüntü: rakipler henüz llms.txt kurmamışken bu adımı atan mağazalar, kategori sorgularında AI yanıtlarında ilk atıf alan marka olmak için ciddi bir avantaj yakalıyor. Bu avantajın penceresi rekabet kızıştıkça daralacak.
SSS - Sık Sorulan Sorular
S: Cloudflare kullanmıyorum, llms.txt'yi Shopify'a ekleyebilir miyim?
C: Cloudflare olmadan aynı sonucu elde etmek için iki seçenek var. Birincisi: Vercel veya Netlify üzerinde barındırılan bir Edge Function ile aynı proxy mantığını kurabilirsiniz; ancak bu domain yönlendirme değişikliği gerektirir. İkincisi: Mağaza bir VPS veya özel sunucu üzerindeyse nginx location bloğu ile /llms.txt isteğini yönlendirebilirsiniz. Doğrudan Shopify üzerinden çalışan bir yöntem 2026 itibarıyla mevcut değildir.
S: LLMs.txt dosyasını ne sıklıkla güncellemem gerekir?
C: Yeni koleksiyon açıldığında, önemli sayfalar eklendiğinde veya mağaza konumlandırması değiştiğinde güncelleyin. Ürün ekleme-çıkarma için her defasında güncelleme gerekmez; koleksiyon ve kategori yapısı sabit kaldığı sürece dosya geçerliliğini korur. Yılda 2–3 gözden geçirme yeterlidir.
S: LLMs.txt SEO sıralamasını doğrudan etkiler mi?
C: Klasik Google sıralama algoritması llms.txt'yi bir sinyal olarak kullanmıyor. Ancak Google AI Overviews ve ChatGPT Search gibi sistemlerin kaynak seçimini etkiliyor. Dolaylı olarak: AI yanıtlarında atıf alan mağazalar marka bilinirliği ve direkt trafik kazanıyor; bu metrikler zamanla organik sıralamayı besliyor.
S: LLMs.txt standart mı, yoksa zorunlu mu?
C: Standart, zorunlu değil. Jeremy Howard'ın Answer.AI'dan önerdiği bu format gönüllülük esasına dayanıyor. Ancak Perplexity, ChatGPT Search ve yeni nesil AI tarayıcıları bu dosyayı destekliyor; erken benimseyenler önceliklendirme avantajı yakalıyor.
S: Cloudflare Worker kurulumu teknik bilgi gerektiriyor mu?
C: Temel JavaScript bilgisiyle Cloudflare arayüzü üzerinden 15–20 dakikada tamamlanabilir. DNS kayıtlarını ve Worker route ayarlarını yanlış yapılandırmak sitenin erişimini etkileyebilir; bu riski taşımak istemiyorsanız teknik destek almak daha güvenlidir.
S: Shopify mağazasına llms.txt nasıl eklenir?
C: Shopify, llms.txt dosyasını yerel olarak desteklemiyor; tema editörüne yüklenen dosyalar Shopify CDN'inden sunulur, mağaza domain kökünden erişilemez. Doğru yöntem Cloudflare Worker kullanmaktır: /llms.txt isteğini Shopify'a ulaşmadan önce yakalayan bir Worker script'i deploy edilir ve dosya içeriği doğrudan döndürülür. Kaynak: Shopify Developer Community
S: LLMs.txt nedir ve ne işe yarar?
C: LLMs.txt, siteye gelen LLM tarayıcılarına hangi sayfaların, koleksiyonların ve içeriklerin öncelikli olduğunu bildiren Markdown tabanlı bir yönlendirme dosyasıdır. 2024'te Answer.AI'dan Jeremy Howard tarafından önerilmiştir. ChatGPT Search, Perplexity ve Google AI Overviews gibi sistemlerin siteyi doğru bağlamda alıntılamasını sağlar.
S: Shopify'da llms.txt için Cloudflare Worker nasıl kurulur?
C: Cloudflare Dashboard'da Workers & Pages bölümünden yeni bir Worker oluşturun. /llms.txt path'ini yakalayan ve text/plain içerik döndüren script'i yapıştırın; diğer tüm istekler Shopify'a proxy'lenir. Ardından Worker Triggers bölümünden yourstore.com/llms.txt route'unu tanımlayın. DNS kaydında Cloudflare proxy (turuncu bulut) aktif olmalıdır.
Sonuç
Shopify'da llms.txt kurulumu, internette yaygın biçimde anlatılan "Assets klasörüne yükle" yöntemiyle çalışmıyor. 2026 itibarıyla Shopify platformu bu dosyayı domain kökünden sunacak yerel bir mekanizma sunmuyor; tek çalışan yöntem Cloudflare Worker ile domain katmanında isteği yakalamak. Bu kurulum, yapay zeka arama motorlarının mağazanızı doğru okumasını sağlayan en doğrudan teknik adımdır.
Cloudflare Worker kurulumunu veya Shopify mağazanızın AI arama görünürlüğünü yapılandırmak istiyorsanız teknik detaylar için iletişime geçin.
