Shopify'de LLMs.txt Entegrasyonu: Cloudflare Worker ile Doğru Kurulum Rehberi (2026)

Shopify'de LLMs.txt entegrasyonu için Mayıs 2026'dan beri dosya yüklemek gerekmez: Shopify her Online Store mağazasında /llms.txt, /llms-full.txt ve /agents.md dosyalarını yerel olarak sunar. İçeriği değiştirmek için temaya templates/llms.txt.liquid şablonu eklenir. Headless vitrin gibi Online Store dışındaki kurulumlarda ise /llms.txt isteğini domain katmanında karşılayan bir Cloudflare Worker kullanılır.

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, Mayıs 2026'dan beri her Online Store mağazasında /llms.txt, /llms-full.txt ve /agents.md dosyalarını yerel olarak sunuyor ve 28 Mayıs 2026'dan beri bu dosyalar templates/llms.txt.liquid şablonuyla özelleştirilebiliyor. Bu rehber yerel desteği ve yalnız headless vitrinler için alternatif olan Cloudflare Worker yöntemini, 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'in GEO (Generative Engine Optimization) bütünündeki yerini ve diğer sıralama faktörleriyle ilişkisini GEO rehberimizde ayrıca ele aldık.

LLMs.txt ile robots.txt Arasındaki Fark

Kritik Not: robots.txt Shopify tarafından yourstore.com/robots.txt adresinde otomatik olarak sunulur. Mayıs 2026'dan beri llms.txt da yourstore.com/llms.txt adresinde otomatik olarak sunulur. Buna karşın 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 A ve CNAME kayıtlarıyla doğrudan Shopify'a bağlanır ve bu adreslere hangi yanıtın döneceğini Shopify belirler; domain köküne elle dosya koymanın bir yolu yoktur.

Sonuç şudur: CDN adresindeki dosya yourstore.com/llms.txt isteğini karşılamaz. Bu adrese yapılan isteği Mayıs 2026'dan beri Shopify kendisi karşılar ve otomatik ürettiği dosyayı döndürür; içeriği değiştirmek için temaya templates/llms.txt.liquid şablonu eklenir.

Headless vitrin gibi Online Store dışındaki kurulumlarda ise çözüm domain katmanında, yani istek vitrin sunucusuna ulaşmadan önce devreye girecek bir ara katmanda üretilir. Cloudflare Worker bu durumlar için alternatif olarak bu görevi üstlenir. Online Store'a bağlı bir domainde ise bu ara katmana gerek yoktur; üstelik Shopify, bu domainin önüne Cloudflare proxy'si konmasını desteklemez.

Shopify'de LLMs.txt Kurulumu: Cloudflare Worker Yöntemi

Bu yöntem yalnız vitrin Shopify dışında barındırılıyorsa (headless) bir alternatiftir ve domain Cloudflare üzerinden yönetiliyorsa çalışır; kayıt Shopify'a yönleniyorsa Worker kurulmaz. Cloudflare Worker, /llms.txt isteğini vitrin sunucusuna ulaşmadan yakalar ve dosya içeriğini doğrudan döndürür; diğer tüm istekler vitrin sunucusuna iletilmeye devam eder.

Kritik Not: Bu yöntemi Shopify Online Store'a bağlı bir domainde kullanmayın. Shopify, Cloudflare proxy'sini (Orange-to-Orange kurulumu dahil) desteklemez ve Shopify'a yönlenen bütün DNS kayıtlarının DNS only (gri bulut) olmasını ister; proxy açık kaldığında SSL sertifikası verilemez ya da yenilenemez ve domain bağlantısı bozulabilir. Online Store mağazalarında /llms.txt zaten Shopify tarafından sunulur; Worker yalnız vitrini Shopify dışında barındırılan kurulumlar içindir.

Ç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. İçeriği elle yazmak yerine taslağını Shopify LLMs.txt Oluşturucu ile mağazanıza göre çıkarabilirsiniz.

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

Headless vitrininize yönlenen domain kaydı Cloudflare üzerinde proxy modunda olmalıdır. Cloudflare DNS panelinde bu A veya CNAME kaydının yanındaki bulut ikonunun turuncu (proxy aktif) göründüğünü doğrulayın. Gri bulut ikonuysa (DNS only) Worker devreye girmez. Turuncu buluta alınacak kayıt, headless vitrininizin barındırıldığı sunucuya yönlenen kayıttır; Shopify'a (23.227.38.65 ya da shops.myshopify.com) yönlenen A, AAAA veya CNAME kaydını proxy moduna almayın. Shopify, Cloudflare proxy'sini ve Orange-to-Orange kurulumunu desteklemez; bu kayıtlar DNS only kalmalıdır.

Adım 5: Test Edin

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

Yanı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üğü

llms.txt, yapay zeka arama sistemlerinin mağazanızın öncelikli sayfalarını HTML'i çözmek zorunda kalmadan bulmasını kolaylaştırır. Ancak bu sistemlerin dosyayı ne ölçüde kullandığına dair açık bir taahhüt yok; atıf beklentisini tek başına llms.txt'ye bağlamayın, dosyayı ürün sayfası içeriği ve yapılandırılmış veriyle birlikte düşünün. Ürün sayfalarının bu atıfları alacak şekilde nasıl kurgulanması gerektiğini ürünleri yapay zekaya bağlama yazımızda ayrı ele aldık.

İç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 büyüyor: Adobe Analytics verilerine göre 2025 tatil sezonunda (1 Kasım-31 Aralık) üretken yapay zeka araçlarından ABD'deki perakende sitelerine gelen trafik bir önceki yıla göre %693,4 arttı. Bu trafiğin bir kısmı alışveriş sorgularından oluşuyor: "en iyi organik bebek kıyafeti markaları Türkiye", "Shopify mağazalarından güvenli alışveriş" gibi.

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: Evet. Online Store kullanan mağazalarda Shopify, Mayıs 2026'dan beri /llms.txt dosyasını yerel olarak sunuyor; içeriği templates/llms.txt.liquid şablonuyla özelleştirilir. Headless gibi özel kurulumlarda 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.

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. Google Search (AI Overviews dahil) de llms.txt'yi kullanmıyor; dosya 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, Mayıs 2026'dan beri her Online Store mağazasında /llms.txt, /llms-full.txt ve /agents.md dosyalarını yerel olarak sunuyor; içeriği değiştirmek için temaya templates/llms.txt.liquid şablonu eklenir. Tema editörüne Assets olarak yüklenen dosyalar ise Shopify CDN'inden sunulur, mağaza domain kökünden erişilemez. Vitrini Shopify dışında barındırılan headless kurulumlarda alternatif yöntem Cloudflare Worker kullanmaktır: /llms.txt isteğini vitrin sunucusuna 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 ve Perplexity gibi sistemlerin siteyi doğru bağlamda alıntılamasına yardımcı olmayı amaçlar; Google Search (AI Overviews dahil) bu dosyayı kullanmaz.

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 vitrininizin barındırıldığı sunucuya iletilir. Ardından Worker Triggers bölümünden yourstore.com/llms.txt route'unu tanımlayın. Headless vitrininize yönlenen DNS kaydında Cloudflare proxy (turuncu bulut) aktif olmalıdır. Shopify Online Store'a bağlı domainde proxy açılmaz: Shopify proxy'yi desteklemez, Shopify'a yönlenen kayıtlar DNS only kalmalı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. Mayıs 2026'dan beri Shopify bu dosyayı domain kökünden yerel olarak sunuyor; içeriği templates/llms.txt.liquid şablonuyla özelleştirilir, Cloudflare Worker ise yalnız vitrini Shopify dışında barındırılan headless kurulumlar için alternatiftir. 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.