واجهة القرآن البرمجية وخادم MCP للمطورين

لدى معرض القرآن طريقتان للبناء على بياناته: واجهة القرآن البرمجية العامة، وخادم MCP لمساعدي الذكاء الاصطناعي. تغطي كلٌّ منهما بيانات مختلفة ولها قواعد مختلفة، لذلك تفصل هذه الصفحة بينهما.

واجهة القرآن البرمجية

تقدّم الواجهة نص القرآن والترجمات والتفاسير والبحث وبيانات الصوت الوصفية من قاعدة بياناتنا. لا تعتمد أي صفحة قراءة على واجهة طرف ثالث. المرجع هو صفحة المطورين.

العنوان الأساسي هو https://qurangallery.com/quran/api/quran. وتتبع الاستجابات بنية v4 التي تتوقعها أغلب أدوات القرآن. وتوثّق صفحة المطورين نقاط الوصول التالية:

نقطة الوصول	ما تعيده
/chapters	السور الـ١١٤ كلها مع بياناتها
/verses/by_chapter/:id	آيات سورة واحدة
/search	بحث نصي كامل في الترجمات
/resources/recitations	القرّاء وملفات الصوت المتاحة
/resources/translations	الترجمات المتاحة بجميع اللغات

وتقبل معاملات الاستعلام المعتادة: language وtranslations وwords وpage. مثلًا، https://qurangallery.com/quran/api/quran/chapters يسرد السور.

يضم المتن القرآن كاملًا بستة أنماط من الرسم، و١٥٠ ترجمة، و٢٣ تفسيرًا، وموضع الصفحة والسطر لكل كلمة في كل مصحف.

المفاتيح والحدود والترخيص

• التوثيق. لا يتحقق مسار واجهة القرآن البرمجية من مفتاح ولا من تسجيل دخول. لا تحتاج إلى حساب لاستدعائه.
• حدود الطلبات. لا تنشر صفحة المطورين حدًّا للواجهة. اجعل طلباتك معتدلة واحفظ ما تجلبه مؤقتًا. قد تبلغ استجابة سورة كاملة عدة ميغابايتات.
• الترخيص. لا يوجد ترخيص واحد لكل البيانات. يسجّل كل مصدر شروطه الخاصة، وتعرضها صفحة المصادر. والمصادر التي لا يجوز إعادة توزيعها لا تُقدَّم إطلاقًا؛ ويعرض التطبيق بدلًا منها إحالة إلى المرجع. راجع مصدر كل ترجمة أو تفسير قبل إعادة استخدامه.

خادم MCP

خادم MCP مخصص لمساعدي الذكاء الاصطناعي. يبحث في المكتبة الشاملة للكتب العربية التراثية، ويعيد مقاطع حرفية مع الطبعة والمجلد والصفحة.

• العنوان: https://qurangallery.com/mcp/shamela.
• لا حاجة إلى مفتاح للبدء. بلا مفتاح تحصل على ١٠ استدعاءات أدوات في الدقيقة و٢٠٠ في اليوم لكل عنوان IP. ويمنحك المفتاح المجاني ٦٠ طلبًا في الدقيقة. أنشئه في حسابك ضمن المطوّرين؛ انظر مفاتيح API.
• جميع الأدوات للقراءة فقط، ويجب أن تكون الاستعلامات بالعربية.

وتغطي وثائق MCP الباقي: ما الذي يفعله، والبدء، وقائمة الأدوات، والحدود والأخطاء.

ما غير متاح

• نص القرآن عبر MCP. يبحث خادم MCP في كتب التراث لا في متن القرآن. استخدم واجهة القرآن البرمجية لنص القرآن.
• الكتب عبر واجهة القرآن البرمجية. لا تقدّم الواجهة مكتبة الشاملة.
• بيانات الحساب. تُحفظ الإشارات المرجعية والملاحظات والتقدم عبر نقاط وصول التطبيقات نفسها للمستخدمين المسجّلين. ولا توثّق صفحة المطورين أنها واجهة عامة.
• ملفات التلاوة الصوتية. نسرد القرّاء وعناوين الملفات. أما الصوت نفسه فيُبثّ من QuranCDN.
• المصادر المحجوبة. لا يُعاد أبدًا نص المصادر المعلَّمة بأنه غير قابل لإعادة التوزيع.
• التصدير الجماعي للكتب وتصحيح الحديث أو تضعيفه. يعيد خادم MCP الصفحات استدعاءً بعد استدعاء مع حدّ للمعدل، ولا يحكم على أي حديث.
• حزمة SDK أو ملف OpenAPI. لا شيء منهما موثَّق.

كيف تطلب الوصول

لا تحتاج إلى طلب للوصول إلى واجهة القرآن البرمجية ولا إلى مستوى MCP بلا مفتاح. للحصول على حد أعلى في MCP أنشئ مفتاحًا مجانيًا كما سبق. ولأي أمر آخر، مثل استخدام أكبر أو نقطة وصول ناقصة أو سؤال عن الترخيص، اكتب إلى support@qurangallery.com أو استخدم صفحة التواصل.