llms.txt et llms-full.txt

llms.txt et llms-full.txt sont deux fichiers texte qui donnent la documentation à une IA. Ils ne contiennent aucune donnée de ton compte et se lisent sans clé. Pour que l'IA lise tes élèves, branche le serveur MCP.

Le MCP convient à un assistant avec qui tu discutes. Pour un script ou un outil, comme un agent qui code dans ton terminal, donne-lui plutôt la CLI : fitdistance docs lui affiche son propre guide.

Les deux fichiers

• https://fitdistance.io/documentation/api/llms.txt est l'index. Il donne l'adresse de base de l'API et la façon de s'authentifier, puis un lien et une phrase pour chaque page de guide, chaque famille de routes et chaque fichier pour les machines : le contrat OpenAPI, llms-full.txt, GET /operations et le serveur MCP.
• https://fitdistance.io/documentation/api/llms-full.txt contient tout dans un seul fichier. Un en-tête rappelle l'adresse de base, l'authentification et la facturation. Viennent ensuite toutes les pages de guide, puis la référence complète de chaque route, avec ses paramètres, ses exemples et ses erreurs.

Les deux sont en anglais, quelle que soit la langue du site. Leurs liens sont des adresses complètes.

Prends llms.txt quand ton IA sait ouvrir un lien : elle suit seule ceux dont elle a besoin. Prends llms-full.txt quand elle ne sait pas, ou pour tout lui donner d'un coup. Il est long et demande une grande fenêtre de contexte.

Une page en Markdown

Ajoute .md à l'adresse d'une page, de guide ou de référence, pour la lire en Markdown :

https://fitdistance.io/documentation/api/demarrer/premier-appel.md
https://fitdistance.io/documentation/api/reference/students.md

Le même texte est aussi à l'adresse https://fitdistance.io/documentation/api/md/demarrer/premier-appel, avec /md après /documentation/api. Pour une page de guide, il commence par le titre, la description et l'adresse de la page, et ses liens internes sont des adresses complètes.

Le Markdown d'une page de guide garde la langue de son adresse : sans préfixe, il est en français, et avec /en devant /documentation, il est en anglais. Celui de la référence est en anglais dans les deux cas.

Le menu « Copier la page »

Chaque page de guide a un menu Copier la page qui fait tout cela pour toi : Copier en Markdown, Voir en Markdown, Ouvrir dans Claude, Ouvrir dans ChatGPT et Copier le lien llms.txt. Les deux boutons « Ouvrir » lancent l'assistant avec un message qui lui demande de lire la page et contient son adresse, pas son texte. Le pas-à-pas est dans Donner la doc à ton IA.

Les donner à une IA

Colle l'adresse dans la conversation, avec ta demande :

Lis https://fitdistance.io/documentation/api/llms.txt, puis aide-moi à écrire un script qui liste mes élèves.

Un agent qui sait lancer des commandes peut aussi lire le fichier lui-même :

curl -s https://fitdistance.io/documentation/api/llms.txt

Ne donne pas ta clé à l'IA pour lire ces fichiers : ils n'en ont pas besoin.

La suite

Le contrat qui sert de source à tous ces textes est décrit dans le contrat OpenAPI. Pour qu'une IA agisse sur tes données avec ta clé, lis le serveur MCP.