Leitores automáticos
O que um modelo recebe — llms.txt, o Markdown em bruto de qualquer página e um verdadeiro servidor MCP.
A documentação é lida por modelos tanto quanto por pessoas, e as quatro respostas abaixo são geradas a partir das mesmas coleções de que as páginas são apresentadas — nenhuma delas pode, portanto, divergir do que está publicado.
| Caminho | O que é |
|---|---|
/llms.txt | Um índice: nome do site, resumo, e cada página como entrada com ligação |
/llms-full.txt | As mesmas páginas, inteiras, concatenadas num único ficheiro Markdown |
<page>.md | O código Markdown de qualquer página |
/mcp | Um servidor MCP — list_pages, search_docs, read_page |
Markdown, não HTML
Tudo aqui entrega o Markdown tal como foi escrito, e é por isso que o esquema da
coleção pede ao Content que guarde rawbody. Um modelo a quem se dá HTML
apresentado tem de desfazer um layout para encontrar um cabeçalho; um a quem se
dá a fonte lê o que o autor escreveu, com os blocos de código ainda blocos e um
bloco MDC ainda uma chamada de componente.
<page>.md é servido por um middleware em vez de uma rota, porque .md é
um sufixo do último segmento do caminho e não um segmento próprio — não existe
padrão de rota do Nitro que signifique «qualquer caminho terminado em .md».
Porquê os dois ficheiros llms
A convenção de llmstxt.org nomeia dois, e respondem a perguntas diferentes: um modelo que leu o índice ainda tem de ir buscar sessenta páginas, e um modelo a quem se entrega o ficheiro completo já as leu. Qual sai mais barato depende da pergunta, por isso o site publica ambos.
Porquê um servidor MCP a sério
/mcp fala o protocolo através do SDK oficial em vez de ser um endpoint JSON de
desenho próprio do duxt. Um cliente liga-se-lhe como se liga a qualquer outra
coisa, em vez de alguém escrever um adaptador à volta de uma forma que só este
tema tem.
A sua pesquisa é um LIKE sobre títulos e descrições, não o índice que o
browser usa: esse é construído do lado do cliente a partir do despejo da
coleção, e uma ferramenta de servidor tem a própria base de dados.