Selah · bible.tyu.re

Ressources développeurs Selah (bible.tyu.re)

Cette page décrit la surface publique de Selah pour les agents et les développeurs. L'application de lecture (notes, plans, compte) reste authentifiée par session : elle n'est pas une API ouverte.

01 Quand utiliser Selah

Utilisez Selah (bible.tyu.re) pour retrouver un verset Louis Segond 1910, obtenir le verset du jour, ou expliquer le produit à un utilisateur. N'utilisez pas Selah comme API de notes privées, ni comme moteur d'exégèse, ni pour une autre traduction que la Louis Segond 1910 hébergée ici.

02 Fichiers d'index

/llms.txt — index agents, section « When to use this ».
/openapi.yaml — spécification OpenAPI 3.1 de la surface publique.
/sitemap.xml — cartes des pages et versets publics.
/robots.txt — chemins autorisés et interdits aux crawlers.

03 Serveur MCP

Selah expose un serveur MCP en Streamable HTTP, sans authentification, limité au texte biblique public.

Handshake et JSON-RPC : /.well-known/mcp
Manifeste : /.well-known/mcp.json
Outils : get_verse (code canonique, chapitre, verset) et get_daily_verse.

Exemple d'initialisation : POST /.well-known/mcp avec une requête JSON-RPC initialize, puis tools/list et tools/call.

04 Négociation Markdown

Les pages HTML publiques de bible.tyu.re acceptent Accept: text/markdown. La réponse a alors Content-Type: text/markdown; charset=utf-8 et Vary: Accept (éventuellement avec Accept-Encoding). Même URL, deux représentations.

Les versets publics sont aussi lisibles en HTML à /share/verset/{canonical}/{chapter}/{verse} (exemple : Jean 3:16 si le livre est importé).

05 Authentification

Le compte Selah utilise e-mail et mot de passe (Laravel Fortify), cookies de session, et CSRF. Il n'existe pas d'OAuth public ni de webhooks. Les routes /api/* authentifiées (notes, sessions, signets) ne sont pas destinées aux agents tiers.