API & MCP

CapBiblique expose son corpus de 1 661 péricopes bibliques avec leurs commentaires catholiques via une API REST publique et un serveur MCP (Model Context Protocol). Pour les développeurs qui veulent intégrer, et pour les LLM/agents qui veulent citer le contenu correctement.

API REST

Base : https://capbiblique.fr/api/v1/ · JSON · pas d'authentification · rate limit 30 r/s par IP. Spec OpenAPI 3.1 : /api/v1/openapi.json.

Trois exemples

# Récupérer une péricope (texte + tous commentaires disponibles)
curl https://capbiblique.fr/api/v1/pericope/jn-11-1-45 | jq .

# Recherche full-text dans les commentaires (accent-insensitive)
curl "https://capbiblique.fr/api/v1/search?q=miséricorde&limit=5" | jq .

# Lister les péricopes d'un chapitre
curl https://capbiblique.fr/api/v1/livre/Mc/chapitre/4/pericopes | jq .

Endpoints disponibles : /pericope/{ref}, /search, /livres, /livre/{code}/pericopes, /livre/{code}/chapitre/{n}/pericopes. Erreurs au format RFC 7807 Problem Details.

Serveur MCP

Endpoint MCP Streamable HTTP : https://capbiblique.fr/api/mcp. Server card : /.well-known/mcp.

Outils exposés

get_pericope(reference, include?) — texte + tous commentaires
search_pericopes(query, limit?) — recherche full-text
list_pericopes(livre, chapitre?) — exploration par livre/chapitre

Plus 73 ressources pericope://{code} (une par livre canonique).

Configuration Claude Desktop

Ajoute ceci dans ton fichier de config (~/Library/Application Support/Claude/claude_desktop_config.json sur macOS, ou équivalent) :

{
  "mcpServers": {
    "capbiblique": {
      "type": "http",
      "url": "https://capbiblique.fr/api/mcp"
    }
  }
}

Puis redémarre Claude Desktop. Tu peux ensuite demander à Claude : « Donne-moi le commentaire de Marie-Noëlle Thabut sur Jn 11,1-45 » ou « cherche-moi les péricopes qui parlent de miséricorde ».

Préférences d'usage IA

CapBiblique déclare ses préférences via les Content Signals dans robots.txt :

Recherche & answer engines (Google, Perplexity…) : autorisée
Citation dans les réponses LLM (Claude, ChatGPT…) : autorisée
Entraînement de modèles : non autorisée — le contenu éditorial reste propriété de ses auteurs

Découverte

/api/v1/openapi.json — spec OpenAPI 3.1
/.well-known/api-catalog — catalogue d'APIs (RFC 9727)
/.well-known/mcp — MCP server card
/robots.txt — règles crawl + Content Signals
Link headers HTTP avec rel="service-desc", "api-catalog", "mcp" sur toutes les pages

Stabilité et contact

L'API et le serveur MCP sont publics, sans authentification, et fournis en l'état : ils peuvent évoluer sans préavis et ne font l'objet d'aucune garantie de service. Si vous reprenez le corpus, citez CapBiblique et l'auteur du commentaire utilisé.

Le site ne publie pas d'adresse de contact. L'origine des contenus est détaillée sur la page À propos, et les mentions légales indiquent la voie à suivre pour une demande d'ayant droit.