Lighthouse, Markdown Bağlantıları Olmadan Llms.txt Dosyanızda Başarısız Oluyor

Chrome'un yeni Lighthouse Aracılı Tarama denetimi, .txt işaretleme belgesi olarak dosya. Eğer llms.txt dosyanız işaretleme bağlantısı sözdizimini kullanmıyorsa, dosyadaki her bağlantı doğru ve çalışıyor olsa bile denetimde başarısız olursunuz. Denetimi nohacks.co'da gerçekleştirdim. Altı denetimden ikisi geçti. Üçü uygulanamaz olarak geri geldi. Biri başarısız oldu: llms.txt denetimi, birebir hatayla birlikte “Dosya herhangi bir bağlantı içermiyor gibi görünüyor.” Düzeltme, bağlantı başına beş karakterdi. Dosya hâlâ düz metin olarak sunuluyor. Yalnızca denetim sonucu değişti.

Lighthouse 13.3.0, Performans, Erişilebilirlik, SEO ve En İyi Uygulamaların yanı sıra Aracılı Tarama kategorisini de sundu. Varsayılan sette altı denetim: erişilebilirlik ağacının iyi biçimlendirilmişliği (agent-accessibility-tree), kümülatif düzen değişikliği (cumulative-layout-shift), llms.txt keşfedilebilirliği (llms-txt) ve üç WebMCP kontrolü (webmcp-registered-tools, webmcp-form-coverage, webmcp-schema-validity). Kategori, 0'dan 100'e kadar puan yerine kesirli bir geçiş oranı döndürür çünkü aracılı web'e yönelik standartlar hâlâ yürürlüktedir.

Nohacks.co'da Yapılan 6 Denetimden 1'i Başarısız Oldu

Denetimi Lighthouse CLI aracılığıyla gerçekleştirdim: npx lighthouse@latest https://nohacks.co --only-categories=agentic-browsing. Altı denetim geri döndü. Üçü geçersiz olarak geri döndü, tümü WebMCP: webmcp-registered-tools, webmcp-form-coverageVe webmcp-schema-validity. Lighthouse, uygulanamayan bir sonuç için hiçbir neden göstermez, sadece denetimi işaretler ve yoluna devam eder. nohacks.co WebMCP'yi ifşa ediyor, ancak yalnızca deneysel zorunluluk yoluyla navigator.modelContext API (iki sözlük aracı, ikisi aracılı tarayıcı dizini için), bildirim niteliğinde form açıklamaları olmadan. Tarama, WebMCP bayrağı olmayan varsayılan başsız bir Chrome 150'de gerçekleştirildi; dolayısıyla geçerli olmayan karar, web sitesinin bu denetimlerin tanıdığı hiçbir şeyi açığa çıkarmadığı veya tarama ortamında o sırada etkin bir WebMCP API'sinin olmadığı anlamına gelebilir. Deniz Feneri hangisi olduğunu söylemiyor. İki denetim temiz bir şekilde geçti: agent-accessibility-tree rapor edildi “Tüm denetimler geçti” anlamsal HTML ve ARIA yapısının, aracıların gezinebilmesi için yeterince iyi biçimlendirilmiş olduğunu doğrulamak ve cumulative-layout-shift sıfıra döndü.

Bir denetim başarısız oldu: llms-txt. Lighthouse'un birebir hata mesajı şuydu:

Dosya herhangi bir bağlantı içermiyor gibi görünüyor.

Kategori puanı 0,67 oldu. İlk sürpriz buydu. nohacks.co/llms.txt adresindeki dosyada birçok bağlantı bulunmaktadır. Makalelere, bölümlere, konuklara ve sözlüğe giden gezinme yolları. RSS beslemesi URL'leri. Ses dosyası URL kalıpları. Dosya beş kilobayttan fazla yapılandırılmış içerik içeriyor. Peki Lighthouse neden sıfır bağlantı rapor ediyordu?

Deniz Feneri Ayrıştırmaları .txt İşaretleme ve Düz Metin Bağlantılarını Reddetme Olarak

Dosya uzantısı .txtancak Lighthouse, içeriği işaretleme olarak ayrıştırır ve bağlantı olarak sayılacak herhangi bir metin için işaretleme bağlantısı söz dizimini talep eder. Dosyanın adı llms.txt. HTTP sunucusu bunu bir text/plain MIME türü. Bir tarayıcıda açtığınızda düz metin görürsünüz. Ancak llmstxt.org'daki llms.txt spesifikasyonu, formatı bir işaretleme belgesi olarak tanımlar. Spesifikasyon açıktır: “Her bölüm, bağlantıların işaretli bir madde işareti listesini içerir. Her liste öğesinde, bağlantıdan iki nokta üst üste ile ayrılmış, bağlantı hakkında isteğe bağlı notların takip ettiği bir bağlantı bulunur.” Lighthouse'un ayrıştırıcısı bunu kesinlikle uygular. Her bağlantı, işaretleme bağlantısı sözdizimi olarak kodlanmalıdır, [text](url)bağlantı metninin etrafında köşeli parantezler ve URL'nin etrafında parantezlerle.

Dosyam daha doğal bir düz metin biçimi kullanıyordu:

- Homepage: / - Publication masthead, cornerstone series, latest articles and episodes
- Articles: /blog - All articles on AXO, the agentic web, and AI agents
- Episode: /episode/[slug] - Full show notes, transcript, audio player

Aynı varış noktaları. Aynı açıklamalar. Aynı bilgi. Lighthouse'un ayrıştırıcısı bu satırları bağlantı olarak kaydetmez. Dosyanın tamamında tam olarak sıfır kayıtlıydı. Denetim başarısız olur.

Bir dosya .txt uzatma ile servis edilir text/plain Markdown olarak biçimlendirilmediği sürece denetimde başarısız olan MIME türü. Bu, denetim katmanının daha dürüst olması gereken bir uyumsuzluktur. Uzantı bir şey söylüyor. MIME türü bir şey söylüyor. Ayrıştırıcı gerçeğin kaynağıdır ve ayrıştırıcı işaretleme talep eder.

Düzeltme Bağlantı Başına 5 Karakterdir

Her bağlantı hedefini işaretleme parantezi-paren sözdizimine sarın, [text](url)ve şunu değiştirin: - her açıklamadan önce ayırıcı : . Bağlantı başına beş karakter. Dosya boyunca tekrarlanan mekanik dönüşüm.

- [Homepage](/): Publication masthead, cornerstone series, latest articles and episodes
- [Articles](/blog): All articles on AXO, the agentic web, and AI agents
- [Episode](/episode/[slug]): Full show notes, transcript, audio player

Düzenlemeyi yaptım. Denetimi yeniden gerçekleştirdik. Skor 0,67'den 1,0'a çıktı. Denetim başlığı ters çevrildi “llms.txt önerilere uymuyor” ile “llms.txt önerilere uyuyor.” Sonrası raporda ayrıntı öğesi yok. Temiz geçiş.

Dosya hâlâ şu şekilde sunuluyor: text/plain. Dosya uzantısı hala .txt. Dosya içeriği hala aynı içeriktir. Yalnızca bağlantı kodlaması değişti.

Lighthouse Dosya Kalitesini Değil, Ayrıştırılabilir Bağlantı Sözdizimini Ölçer

Denetim, dosyanızın mekanik olarak ayrıştırılabilir olup olmadığını kontrol eder. Dosyanın web sitenizi yararlı bir şekilde tanımlayıp tanımlamadığını kontrol etmez. Her iki okuma da aynı anda doğrudur.

İlk okuma: Denetim gerçek bir şeyi ölçüyor. Markdown bağlantısı sözdizimi mekanik olarak ayrıştırılabilir. Düz metin açıklayıcı satırlar değildir. Bir AI aracısının (veya aracının yerine geçen Lighthouse ayrıştırıcısının) dosyadan bağlantıları programlı olarak çıkarması gerekiyorsa işaretleme formatı gereklidir. Denetim, düzeltmemden önceki dosyanın standart araçlarla bağlantılar için ayrıştırılamadığı yönünde doğrudur. Markdown bağlantısı sözdizimine dönüşüm, gerçek bir birlikte çalışabilirlik açığını giderir.

İkinci okuma: format uyumluluğu dosya kalitesiyle aynı değildir. Düz metin açıklamaları kullanan, özenle yazılmış, doğru ve kapsamlı bir llms.txt dosyası bu denetimde başarısız olur. Markdown bağlantısı sözdizimine sahip ince, otomatik olarak oluşturulmuş bir llms.txt dosyası geçer. Denetim ikisi arasındaki farkı söyleyemez. WordPress.org listesine göre 3 milyondan fazla web sitesi tarafından kullanılan WordPress eklentisi AIOSEO, varsayılan olarak işaretleme bağlantısı sözdizimine sahip llms.txt dosyaları oluşturuyor; Glenn Gabe varsayılan olarak açık bir davranış ortaya çıkardı ve eklentinin kendi belgeleri bunu doğruluyor. Otomatik olarak oluşturulan dosyalar, işaretleme bağlantısı sözdizimini kullanır çünkü oluşturucunun yaydığı şey budur. Çoğu muhtemelen bu denetimi geçiyor. Elle seçilmiş, sahibinin farkında olduğu llms.txt dosyalarının çoğu muhtemelen başarısız olur.

Bu boşluk, denetimin başarılı/başarısız durumunu web sitenizin gerçekte aracılara ne kadar hazır olduğunun bir ölçüsü olarak ele almadan önce düşünmeye değer. Denetim, dosyanızın ayrıştırılabilir olup olmadığını kontrol ediyor. Dosyanızın yararlı olup olmadığını kontrol etmiyor.

Lighthouse Agentic Browsing'in Llms.txt Kontrolünü Önemsemeli misiniz?

Evet ama dar anlamda. Lighthouse size llms.txt dosyanızın işaretleme olarak ayrıştırılabilir olup olmadığını söyleyebilir. Dosyanın web sitenizi dürüstçe tanımlayıp tanımlamadığını size söyleyemez. O çek senin. Chrome DevTools'u açın, Lighthouse sekmesine tıklayın, Aracılı Tarama kategorisinin işaretli olduğunu doğrulayın ve URL'nizde Analiz'i çalıştırın. Denetim bir dakikadan az sürer. Bağlantı yok hatası başarısız olursa, düzeltme bağlantı başına beş karakter ve beş dakikalık düzenlemedir. Eğer geçerse, Lighthouse'un soramayacağı daha zor soru olacak. Dosya, yapılandırmadığınız bir eklenti tarafından otomatik olarak mı oluşturuldu, yoksa kendiniz mi yazdınız; her iki durumda da, web sitenizin gerçekte ne olduğunu açıklıyor mu?

Makine Öncelikli Mimari Yapı sütunu Tüm bunların altında yatan şey şu: sayfa düzenlerinden önceki veri modelleri, bağımsız oluşturma, istemci tarafı JavaScript'e bağlı olmayan içerik veya makine tarafından okunabilen insan ekranı varsayılanları. llms.txt denetimi bu katmandaki dar kapsamlı bir denetimdir. Makine tarafından okunabilen yüzeyinizin web sitenizi doğru bir şekilde tanımlayıp tanımlamadığı gibi daha büyük yapısal soru sizindir.

Daha Fazla Kaynak:


Bu yazı ilk olarak No Hacks'te yayınlandı.


Öne Çıkan Görsel: Darko 1981/Shutterstock


Yayımlandı

kategorisi

yazarı:

Etiketler:

Yorumlar

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir