Geliştiriciler için Kuran API’si ve MCP Sunucusu

Kuran Galerisi verileriyle geliştirmenin iki yolu vardır: herkese açık bir Kuran API’si ve yapay zekâ asistanları için bir MCP sunucusu. İkisi farklı verileri kapsar ve farklı kurallara sahiptir; bu sayfa onları ayrı tutar.

Kuran API’si

Kuran API’si, Kuran metnini, mealleri, tefsirleri, aramayı ve ses üst verilerini kendi veritabanımızdan sunar. Hiçbir okuma sayfası üçüncü taraf bir API’ye bağlı değildir. Başvuru kaynağı geliştiriciler sayfasıdır.

Temel adres https://qurangallery.com/quran/api/quran şeklindedir. Yanıtlar, çoğu Kuran aracının zaten beklediği v4 yanıt biçimini izler. Geliştiriciler sayfası şu uç noktaları belgeler:

Uç nokta	Döndürdüğü
/chapters	114 surenin tamamı ve üst verileri
/verses/by_chapter/:id	Bir surenin ayetleri
/search	Meallerde tam metin arama
/resources/recitations	Mevcut kârîler ve ses dosyaları
/resources/translations	Mevcut mealler, tüm diller

Olağan sorgu parametrelerini alırlar: language, translations, words ve page. Örneğin https://qurangallery.com/quran/api/quran/chapters sureleri listeler.

Derlem, altı yazı çeşidiyle eksiksiz Kuran’ı, 150 meali, 23 tefsiri ve her mushaftaki her kelimenin sayfa ve satır konumunu içerir.

Anahtarlar, sınırlar ve lisans

• Kimlik doğrulama. Kuran API’si rotası anahtar da oturum açma da kontrol etmez. Çağırmak için hesap gerekmez.
• İstek sınırları. Geliştiriciler sayfası Kuran API’si için bir sınır yayımlamaz. İsteklerinizi ölçülü tutun ve aldıklarınızı önbelleğe alın. Tam bir sure yanıtı birkaç megabayt olabilir.
• Lisans. Tüm veriler için tek bir lisans yoktur. Her kaynak kendi koşullarını kaydeder ve kaynaklar sayfası bunları gösterir. Yeniden dağıtılamayan kaynaklar hiç sunulmaz; uygulama onun yerine bir künye gösterir. Bir meali ya da tefsiri yeniden kullanmadan önce kaynağını kontrol edin.

MCP sunucusu

MCP sunucusu yapay zekâ asistanları içindir. Klasik Arapça kitaplardan oluşan Şamile kütüphanesinde arama yapar; baskı, cilt ve sayfa bilgisiyle birebir alıntılar döndürür.

• Adres: https://qurangallery.com/mcp/shamela.
• Başlamak için anahtar gerekmez. Anahtarsız, IP adresi başına dakikada 10 ve günde 200 araç çağrısı alırsınız. Ücretsiz anahtar dakikada 60 istek verir. Hesabınızda Geliştiriciler bölümünden oluşturun; bkz. API anahtarları.
• Tüm araçlar salt okunurdur ve sorgular Arapça olmalıdır.

MCP belgeleri gerisini kapsar: ne yaptığı, başlarken, araç listesi ve sınırlar ve hatalar.

Neler yok

• MCP üzerinden Kuran metni. MCP sunucusu klasik kitaplarda arar, Kuran derleminde değil. Kuran metni için Kuran API’sini kullanın.
• Kuran API’si üzerinden kitaplar. Kuran API’si Şamile kütüphanesini sunmaz.
• Hesap verileri. Yer imleri, notlar ve ilerleme, oturum açmış kullanıcılar için uygulamaların kendi uç noktalarından kaydedilir. Geliştiriciler sayfası bunları herkese açık API olarak belgelemez.
• Kıraat ses dosyaları. Kârîleri ve dosya adreslerini listeleriz. Ses dosyasının kendisi QuranCDN’den akar.
• Geri tutulan kaynaklar. Yeniden dağıtılamaz olarak işaretlenen kaynakların metni asla döndürülmez.
• Toplu kitap dışa aktarımı ve hadis derecelendirmesi. MCP sunucusu sayfaları bir çağrıda bir kez, istek sınırıyla döndürür ve hiçbir hadisi derecelendirmez.
• SDK veya OpenAPI dosyası. Belgelenmiş bir tane yok.

Erişim nasıl istenir

Kuran API’si ya da anahtarsız MCP katmanı için erişim istemeniz gerekmez. Daha yüksek bir MCP sınırı için yukarıdaki gibi ücretsiz bir anahtar oluşturun. Başka her şey için, örneğin daha yoğun kullanım, eksik bir uç nokta ya da lisans sorusu, support@qurangallery.com adresine yazın veya iletişim sayfasını kullanın.