API Quran dan Server MCP untuk Developer

Quran Gallery punya dua cara membangun dengan datanya: API Quran publik dan server MCP untuk asisten AI. Keduanya mencakup data berbeda dan punya aturan berbeda, jadi halaman ini memisahkannya.

API Quran

API Quran menyajikan teks Quran, terjemahan, tafsir, pencarian, dan metadata audio dari basis data kami sendiri. Tidak ada halaman baca yang bergantung pada API pihak ketiga. Halaman developer adalah rujukannya.

Alamat dasarnya https://qurangallery.com/quran/api/quran. Respons mengikuti bentuk v4 yang sudah diharapkan kebanyakan alat Quran. Halaman developer mendokumentasikan endpoint berikut:

Endpoint	Yang dikembalikan
/chapters	Semua 114 surah beserta metadatanya
/verses/by_chapter/:id	Ayat-ayat satu surah
/search	Pencarian teks penuh di terjemahan
/resources/recitations	Qari dan berkas audio yang tersedia
/resources/translations	Terjemahan yang tersedia, semua bahasa

Endpoint ini menerima parameter kueri yang lazim: language, translations, words, dan page. Misalnya, https://qurangallery.com/quran/api/quran/chapters menampilkan daftar surah.

Korpusnya memuat Quran lengkap dalam enam varian tulisan, 150 terjemahan, 23 tafsir, serta posisi halaman dan baris setiap kata di tiap mushaf.

Kunci, batas, dan lisensi

• Autentikasi. Rute API Quran tidak memeriksa kunci atau login. Anda tidak perlu akun untuk memanggilnya.
• Batas laju. Halaman developer tidak mencantumkannya untuk API Quran. Gunakan secukupnya dan simpan hasil yang Anda ambil. Respons satu surah penuh bisa berukuran beberapa megabyte.
• Lisensi. Tidak ada satu lisensi untuk semua data. Setiap sumber mencatat ketentuannya sendiri, dan halaman sumber menampilkannya. Sumber yang tidak boleh didistribusikan ulang tidak disajikan sama sekali; aplikasi menampilkan kutipan sebagai gantinya. Periksa sumber tiap terjemahan atau tafsir sebelum memakainya ulang.

Server MCP

Server MCP ditujukan untuk asisten AI. Ia mencari di perpustakaan Syamilah berisi kitab Arab klasik dan mengembalikan kutipan verbatim lengkap dengan cetakan, jilid, dan halaman.

• Alamat: https://qurangallery.com/mcp/shamela.
• Tidak perlu kunci untuk mulai. Tanpa kunci Anda mendapat 10 panggilan alat per menit dan 200 per hari per alamat IP. Kunci gratis memberi 60 permintaan per menit. Buat di akun Anda pada Developer; lihat Kunci API.
• Semua alat bersifat baca saja, dan kueri harus berbahasa Arab.

Dokumentasi MCP membahas sisanya: fungsinya, memulai, daftar alat, dan batas dan galat.

Yang tidak tersedia

• Teks Quran lewat MCP. Server MCP mencari di kitab klasik, bukan korpus Quran. Gunakan API Quran untuk teks Quran.
• Kitab lewat API Quran. API Quran tidak menyajikan perpustakaan Syamilah.
• Data akun. Bookmark, catatan, dan progres disimpan lewat endpoint milik aplikasi untuk pengguna yang masuk. Halaman developer tidak mendokumentasikannya sebagai API publik.
• Berkas audio bacaan. Kami mencantumkan qari dan alamat berkas. Audionya sendiri dialirkan dari QuranCDN.
• Sumber yang ditahan. Teks dari sumber yang ditandai tidak boleh didistribusikan ulang tidak pernah dikembalikan.
• Ekspor massal kitab dan penilaian hadis. Server MCP mengembalikan halaman satu panggilan demi satu panggilan dengan batas laju, dan tidak pernah menilai hadis.
• SDK atau berkas OpenAPI. Tidak ada yang didokumentasikan.

Cara meminta akses

Anda tidak perlu meminta akses untuk API Quran atau tingkat MCP tanpa kunci. Untuk batas MCP lebih tinggi, buat kunci gratis seperti di atas. Untuk hal lain, seperti penggunaan lebih berat, endpoint yang belum ada, atau pertanyaan lisensi, tulis ke support@qurangallery.com atau gunakan halaman kontak.