Plik llms.txt: co to jest, jak go napisać i czego po nim nie oczekiwać

Asystent AI, który szuka odpowiedzi o twojej firmie, czyta twoją stronę przez gąszcz menu, banerów i skryptów. Plik llms.txt to propozycja, żeby podać mu krótką ściągę w markdownie: kim jesteś, co oferujesz i gdzie leżą szczegóły. Napiszesz go w godzinę, ale to nie jest przepis na cytowania. To uporządkowana wizytówka dla maszyn i tak trzeba go traktować.

Ściąga dla agenta, nie mapa całej strony

Propozycję opisuje strona llmstxt.org i zaczyna od prostej obserwacji. Agenci korzystają dziś ze stron nieustannie. Agent programistyczny pobiera dokumentację biblioteki, a asystent czatu z wyszukiwaniem czyta strony, żeby odpowiedzieć na pytanie o produkt. Strony internetowe powstają jednak dla ludzi. HTML owija treść nawigacją, reklamami i JavaScriptem, a odzyskanie z tego czystego tekstu jest trudne i nieprecyzyjne. Okno kontekstu, czyli ilość tekstu, jaką model ogarnia naraz, nadal nie mieści większości serwisów w całości. Każde zmarnowane słowo kosztuje czas i pieniądze.

Pomysł przypomina kartkę na drzwiach biura: godziny otwarcia, telefon, „księgowość na drugim piętrze”. Plik /llms.txt w formacie markdown daje krótkie tło, wskazówki i linki do szczegółowych treści. Agent ma go przejrzeć, znaleźć to, czego potrzebuje, i dopiero wtedy pójść za odpowiednim linkiem. Sam plik ma się zmieścić w kontekście, a szczegóły leżą za linkami i agent pobiera je tylko wtedy, gdy ich potrzebuje.

Autor propozycji pisze, że w drugiej wersji opisu tysiące stron publikują już taki plik. Platformy dokumentacji generują go automatycznie, a Lighthouse w Chrome sprawdza jego obecność w ramach audytów przeglądania agentowego. Własne pliki dla dokumentacji deweloperskiej mają OpenAI, Anthropic i Gemini. Najczęściej używa się go przy dokumentacji oprogramowania. Ta sama struktura sprawdza się jednak wszędzie, gdzie agent potrzebuje prowadzonej ścieżki przez serwis, na przykład gdy firma chce opisać swoją strukturę i zasady.

Format: H1, cytat, linki pod H2

Plik jest zwykłym markdownem, czytelnym dla człowieka i modelu. Ma przy tym na tyle sztywny układ, że da się go przetwarzać parserem albo wyrażeniami regularnymi. Specyfikacja wymienia elementy w ściśle określonej kolejności:

1. Opcjonalny znacznik BOM na początku pliku.
2. Nagłówek H1 z nazwą firmy, projektu lub strony. To jedyny obowiązkowy element.
3. Blok cytatu (>) z krótkim podsumowaniem, które zawiera informacje potrzebne do zrozumienia reszty pliku.
4. Dowolna liczba akapitów lub list bez nagłówków, z dokładniejszymi informacjami i wskazówkami, jak czytać podlinkowane pliki.
5. Dowolna liczba sekcji pod nagłówkami H2 z listami plików. Każda pozycja to hiperlink markdown z nazwą i adresem, a po nim opcjonalnie dwukropek i opis.

Sekcja zatytułowana ## Optional ma umowne znaczenie. Trafiają do niej rzeczy drugorzędne, które agent może pominąć, gdy brakuje mu miejsca w kontekście.

Propozycja idzie o krok dalej. Strony z informacjami, których agent może potrzebować, powinny mieć czystą wersję markdown pod tym samym adresem z dopiskiem .md, czyli strona.html.md albo strona.md. Adres bez nazwy pliku dostaje index.html.md lub index.md. Linki w llms.txt powinny prowadzić właśnie do takich wersji. Jeśli twój CMS ich nie tworzy, linkuj do zwykłych stron. Plik nadal będzie poprawny, tylko agent dostanie mniej wygodną treść.

Gotowy przykład dla firmy usługowej

Wyobraź sobie pracownię stolarską, która robi meble na wymiar. Klient pyta asystenta, czy firma obsługuje jego miasto, ile trwa realizacja i jak wygląda wycena. Plik powinien prowadzić prosto do tych odpowiedzi:

# Pracownia Kowalski

> Pracownia Kowalski projektuje i wykonuje meble na wymiar: kuchnie, zabudowy wnękowe i szafy. Działamy w województwie małopolskim, wycena jest bezpłatna po pomiarze.

Nie sprzedajemy gotowych mebli z katalogu ani nie wykonujemy samego montażu mebli kupionych gdzie indziej. Ceny w cenniku są orientacyjne, ostateczną kwotę ustalamy po pomiarze.

## Usługi

- [Kuchnie na wymiar](https://przyklad.pl/kuchnie.md): materiały, etapy realizacji, typowy czas wykonania
- [Szafy i zabudowy](https://przyklad.pl/szafy.md): rodzaje frontów i systemów drzwi przesuwnych
- [Cennik orientacyjny](https://przyklad.pl/cennik.md): widełki cen za metr bieżący zabudowy

## Współpraca

- [Jak przebiega zamówienie](https://przyklad.pl/proces.md): od pomiaru do montażu, krok po kroku
- [Obszar działania](https://przyklad.pl/obszar.md): miejscowości, w których robimy pomiar i montaż
- [Kontakt](https://przyklad.pl/kontakt.md): telefon, adres, godziny pracy

## Optional

- [Realizacje](https://przyklad.pl/realizacje.md): opisy wybranych projektów ze zdjęciami
- [Gwarancja i reklamacje](https://przyklad.pl/gwarancja.md): zasady i terminy

Najwięcej daje tu akapit bez nagłówka, w którym piszesz, czego firma nie robi. Model, który zgaduje, chętnie dopowiada. Jedno jasne zdanie o granicach oferty zabiera mu pole do zgadywania.

Gotowy przykład dla sklepu

W sklepie nie wypisujesz tysięcy produktów. Od listy wszystkiego jest mapa strony, o czym niżej. W llms.txt pokazujesz kategorie, zasady i odpowiedzi na pytania, które padają przed zakupem:

# Sklep Pracowni Kowalski

> Sklep internetowy z akcesoriami do pielęgnacji drewna: olejami, woskami i lakierami. Wysyłka na terenie Polski, zwroty do 14 dni od odbioru.

Asortyment dotyczy wyłącznie drewna. Doradztwo w doborze produktu prowadzimy mailowo i telefonicznie w dni robocze.

## Kategorie

- [Oleje do drewna](https://przyklad.pl/sklep/oleje.md): do mebli, blatów i tarasów, z opisem zastosowań
- [Woski i pasty](https://przyklad.pl/sklep/woski.md): do konserwacji i odświeżania powierzchni
- [Lakiery](https://przyklad.pl/sklep/lakiery.md): wodne i rozpuszczalnikowe, porównanie właściwości

## Zakupy

- [Dostawa i płatności](https://przyklad.pl/dostawa.md): przewoźnicy, koszty, czas wysyłki
- [Zwroty i reklamacje](https://przyklad.pl/zwroty.md): procedura i formularz
- [Jak dobrać olej](https://przyklad.pl/poradnik-olej.md): krótki przewodnik dla klienta

## Optional

- [Regulamin sklepu](https://przyklad.pl/regulamin.md)
- [O firmie](https://przyklad.pl/o-nas.md)

Jeśli sklep stoi na WordPressie albo Wiksie, możesz nie pisać pliku ręcznie. llmstxt.org wymienia narzędzia, które generują go automatycznie: wtyczki Yoast SEO i AIOSEO dla WordPressa, a Wix tworzy taki plik dla każdej strony. Wygenerowany plik i tak przejrzyj. Automat nie wie, że nie wozisz mebli do Gdańska.

Napisz i opublikuj plik dziś

1. Wypisz trzy do pięciu pytań, które klienci najczęściej zadają przed zakupem. Każde powinno mieć stronę z odpowiedzią. Jeśli którejś brakuje, dopisz ją.
2. Ułóż tekst w kolejności ze specyfikacji: H1, cytat z podsumowaniem, akapit o granicach oferty, sekcje H2 z linkami i krótkimi opisami.
3. Pisz prosto. Wytyczne propozycji radzą używać zwięzłego, jasnego języka, dawać informacyjne opisy linków i unikać niewyjaśnionego żargonu.
4. Zapisz plik jako llms.txt i wgraj go do katalogu głównego, żeby był dostępny pod https://przyklad.pl/llms.txt. Plik może też leżeć w podkatalogu, na przykład /docs/llms.txt, i wtedy opisuje tylko strony pod tą ścieżką. Gdy pasuje więcej niż jeden plik, agent powinien wybrać najbardziej szczegółowy.
5. Otwórz adres w przeglądarce i sprawdź, czy widzisz czysty tekst, a nie stronę błędu.
6. Przetestuj plik tak, jak radzą autorzy. Daj agentowi tylko swój llms.txt i zadaj mu pytania o swoją ofertę. Błędne odpowiedzi pokażą ci, czego w pliku brakuje.

Chętni technicznie mogą dodać nagłówek HTTP, który wskazuje wersję markdown strony i plik, który ją opisuje. Propozycja podaje taki wzór:

Link: </docs/strona.html.md>; rel="alternate"; type="text/markdown", </docs/llms.txt>; rel="describedby"

To samo da się zapisać jako elementy <link> w HTML. Wersja nagłówkowa działa też dla plików innych niż HTML i można ją ustawić w serwerze albo CDN bez ruszania stron.

Sąsiedzi: robots.txt, sitemap i Google

Trzy pliki w katalogu głównym często się mylą, a każdy robi co innego.

robots.txt jest standardem, opisanym w RFC 9309 jako Robots Exclusion Protocol. Według RFC plik musi leżeć pod /robots.txt w głównej ścieżce serwisu, być zakodowany w UTF-8 i mieć typ text/plain. Same reguły nie są formą autoryzacji dostępu. Dokumentacja Google o robots.txt dodaje, że plik służy głównie do zarządzania ruchem robotów, a nie do ukrywania stron. Robot musi sam zdecydować, że reguł posłucha. llms.txt działa inaczej. Nikomu niczego nie zabrania, tylko podpowiada, gdzie szukać. Według autorów propozycji może uzupełniać robots.txt kontekstem dla treści, które i tak są dostępne. Jeśli w robots.txt zablokujesz katalog, link do niego w llms.txt tylko wprowadzi zamieszanie.

Mapa strony też go nie zastąpi. Zwykle nie zawiera wersji markdown, nie linkuje do zewnętrznych źródeł i obejmuje tyle dokumentów, że razem nie zmieszczą się w kontekście modelu.

Teraz najważniejsze zastrzeżenie. llms.txt to propozycja standardu, otwarta na uwagi społeczności, a nie norma, do której ktoś musi się stosować. Nie ma gwarancji, że dany asystent go przeczyta, a tym bardziej że zacytuje cię częściej. Google w poradniku o funkcjach AI w wyszukiwarce pisze wprost, że nie trzeba tworzyć nowych plików czytelnych maszynowo, plików tekstowych dla AI ani znaczników, żeby pojawić się w AI Overviews czy AI Mode. Liczą się tam zwykłe podstawy SEO, o których piszemy w poradniku AI Overviews w Google: jak trafić do źródeł. Autorzy propozycji zakładali, że plik przyda się głównie przy generowaniu odpowiedzi, nie przy trenowaniu modeli, i według nich tak właśnie jest używany.

Każdy silnik zachowuje się po swojemu, dlatego efekt trzeba mierzyć osobno dla każdego. W naszym teście serwisu promptowy.com z 14 października 2026 ta sama strona była źródłem w 3 z 3 odpowiedzi Groka i w 0 z 3 odpowiedzi ChatGPT oraz Perplexity. Ogólna widoczność wyniosła 33%, czyli 5 cytowań na 15 odpowiedzi. Po dodaniu llms.txt sprawdzaj każdy silnik z osobna, bo zmiana w jednym nie mówi nic o pozostałych.

Źródła

• llmstxt.org - specyfikacja formatu, kolejność sekcji, lokalizacja pliku, wersje markdown, nagłówek Link, porównanie z robots.txt i sitemap, lista generatorów.
• Introduction to robots.txt, Google Search Central - do czego służy robots.txt i czego nie załatwia.
• AI features and your website, Google Search Central - stanowisko Google, że AI Overviews i AI Mode nie wymagają osobnych plików dla AI.
• RFC 9309: Robots Exclusion Protocol - formalne wymagania co do lokalizacji, kodowania i charakteru reguł robots.txt.

Zanim cokolwiek zmienisz, sprawdź, w których silnikach twoja strona już jest źródłem, a w których jej nie ma. Pomoże w tym darmowy test SEO Maestro. Po wdrożeniu llms.txt powtórz pomiar i porównaj wyniki.