API Coran et serveur MCP pour développeurs

Quran Gallery offre deux façons de créer avec ses données : une API Coran publique et un serveur MCP pour assistants IA. Elles couvrent des données différentes et suivent des règles différentes ; cette page les distingue.

L’API Coran

L’API Coran fournit le texte du Coran, les traductions, les tafsirs, la recherche et les métadonnées audio depuis notre propre base de données. Aucune page de lecture ne dépend d’une API tierce. La page développeurs est la référence.

L’adresse de base est https://qurangallery.com/quran/api/quran. Les réponses suivent la structure v4 que la plupart des outils Coran attendent déjà. La page développeurs documente ces points d’accès :

Point d’accès	Ce qu’il renvoie
/chapters	Les 114 sourates avec leurs métadonnées
/verses/by_chapter/:id	Les versets d’une sourate
/search	Recherche plein texte dans les traductions
/resources/recitations	Récitants et fichiers audio disponibles
/resources/translations	Traductions disponibles, toutes langues

Ils acceptent les paramètres de requête habituels : language, translations, words et page. Par exemple, https://qurangallery.com/quran/api/quran/chapters liste les sourates.

Le corpus contient le Coran complet en six variantes d’écriture, 150 traductions, 23 tafsirs, et la position de page et de ligne de chaque mot dans chaque mushaf.

Clés, limites et licence

• Authentification. La route de l’API Coran ne vérifie ni clé ni connexion. Aucun compte n’est nécessaire pour l’appeler.
• Limites de débit. La page développeurs n’en publie aucune pour l’API Coran. Restez raisonnable et mettez en cache ce que vous récupérez. Une réponse de chapitre complet peut peser plusieurs mégaoctets.
• Licence. Il n’existe pas de licence unique pour toutes les données. Chaque source consigne ses propres conditions, et la page des sources les affiche. Les sources non redistribuables ne sont pas servies du tout ; l’application affiche une citation à la place. Vérifiez la source de chaque traduction ou tafsir avant de la réutiliser.

Le serveur MCP

Le serveur MCP s’adresse aux assistants IA. Il interroge la bibliothèque Shamela de livres arabes classiques et renvoie des passages textuels avec l’édition, le volume et la page.

• Adresse : https://qurangallery.com/mcp/shamela.
• Aucune clé n’est nécessaire pour commencer. Sans clé, vous avez 10 appels d’outils par minute et 200 par jour et par adresse IP. Une clé gratuite donne 60 requêtes par minute. Créez-la dans votre compte, sous Développeurs ; voir Clés d’API.
• Tous les outils sont en lecture seule, et les requêtes doivent être en arabe.

La documentation MCP couvre le reste : ce qu’il fait, prise en main, la liste des outils et limites et erreurs.

Ce qui n’est pas disponible

• Le texte du Coran via MCP. Le serveur MCP cherche dans les livres classiques, pas dans le corpus coranique. Utilisez l’API Coran pour le texte du Coran.
• Les livres via l’API Coran. L’API Coran ne sert pas la bibliothèque Shamela.
• Les données de compte. Favoris, notes et progression passent par les propres points d’accès des applications, pour les utilisateurs connectés. La page développeurs ne les documente pas comme une API publique.
• Les fichiers audio de récitation. Nous listons les récitants et les adresses de fichiers. L’audio lui-même est diffusé par QuranCDN.
• Les sources retenues. Le texte des sources marquées comme non redistribuables n’est jamais renvoyé.
• L’export en masse de livres et le classement des hadiths. Le serveur MCP renvoie les pages un appel à la fois, avec une limite de débit, et ne classe jamais un hadith.
• Un SDK ou un fichier OpenAPI. Aucun n’est documenté.

Comment demander l’accès

Vous n’avez rien à demander pour l’API Coran ni pour le niveau MCP sans clé. Pour une limite MCP plus haute, créez une clé gratuite comme ci-dessus. Pour tout le reste, comme un usage plus intensif, un point d’accès manquant ou une question de licence, écrivez à support@qurangallery.com ou utilisez la page de contact.