ডেভেলপারদের জন্য কুরআন API ও MCP সার্ভার

কুরআন গ্যালারির ডেটা দিয়ে তৈরি করার দুটি উপায় আছে: সবার জন্য উন্মুক্ত কুরআন API এবং AI সহকারীর জন্য MCP সার্ভার। দুটির ডেটা আলাদা এবং নিয়মও আলাদা, তাই এই পেজ দুটিকে আলাদা রাখে।

কুরআন API

কুরআন API আমাদের নিজস্ব ডেটাবেস থেকে কুরআনের পাঠ, অনুবাদ, তাফসির, অনুসন্ধান ও অডিও মেটাডেটা দেয়। কোনো পড়ার পেজ তৃতীয় পক্ষের API-র ওপর নির্ভর করে না। রেফারেন্স হলো ডেভেলপার পেজ।

বেস ঠিকানা 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 সূরাগুলোর তালিকা দেয়।

সংগ্রহে ছয়টি লিপিধরনে পূর্ণ কুরআন, ১৫০টি অনুবাদ, ২৩টি তাফসির এবং প্রতিটি মুসহাফে প্রতিটি শব্দের পৃষ্ঠা ও লাইনের অবস্থান আছে।

কী, সীমা ও লাইসেন্স

• যাচাই। কুরআন API-র রুট কোনো কী বা সাইন-ইন যাচাই করে না। কল করতে অ্যাকাউন্ট লাগে না।
• রেট লিমিট। ডেভেলপার পেজ কুরআন API-র জন্য কোনো সীমা প্রকাশ করে না। অনুরোধ পরিমিত রাখুন এবং যা আনবেন তা ক্যাশ করুন। একটি পূর্ণ সূরার উত্তর কয়েক মেগাবাইট হতে পারে।
• লাইসেন্স। সব ডেটার জন্য একটি লাইসেন্স নেই। প্রতিটি উৎস নিজের শর্ত নথিভুক্ত করে, আর উৎস পেজ সেগুলো দেখায়। যে উৎস পুনর্বিতরণ করা যায় না, তা মোটেই দেওয়া হয় না; অ্যাপ তার বদলে সূত্র দেখায়। কোনো অনুবাদ বা তাফসির আবার ব্যবহারের আগে তার উৎস দেখে নিন।

MCP সার্ভার

MCP সার্ভার AI সহকারীর জন্য। এটি ক্লাসিক্যাল আরবি বইয়ের শামেলা লাইব্রেরিতে অনুসন্ধান করে এবং সংস্করণ, খণ্ড ও পৃষ্ঠাসহ হুবহু উদ্ধৃতি ফেরত দেয়।

• ঠিকানা: https://qurangallery.com/mcp/shamela।
• শুরু করতে কী লাগে না। কী ছাড়া প্রতি IP ঠিকানায় প্রতি মিনিটে ১০ ও প্রতিদিন ২০০টি টুল কল পান। বিনামূল্যের কী দিলে প্রতি মিনিটে ৬০টি অনুরোধ পান। এটি আপনার অ্যাকাউন্টে ডেভেলপার অংশে তৈরি করুন; দেখুন API কী।
• সব টুল শুধু পড়ার জন্য, এবং কোয়েরি অবশ্যই আরবিতে হতে হবে।

বাকিটা MCP নথিতে আছে: এটি কী করে, শুরু করা, টুলের তালিকা এবং সীমা ও ত্রুটি।

যা পাওয়া যায় না

• MCP-র মাধ্যমে কুরআনের পাঠ। MCP সার্ভার ক্লাসিক্যাল বইয়ে অনুসন্ধান করে, কুরআনের সংগ্রহে নয়। কুরআনের পাঠের জন্য কুরআন API ব্যবহার করুন।
• কুরআন API-র মাধ্যমে বই। কুরআন API শামেলা লাইব্রেরি দেয় না।
• অ্যাকাউন্টের ডেটা। বুকমার্ক, নোট ও অগ্রগতি সাইন-ইন করা ব্যবহারকারীর জন্য অ্যাপগুলোর নিজস্ব এন্ডপয়েন্টে সংরক্ষিত হয়। ডেভেলপার পেজ এগুলোকে উন্মুক্ত API হিসেবে নথিভুক্ত করে না।
• তিলাওয়াতের অডিও ফাইল। আমরা ক্বারী ও ফাইলের ঠিকানা তালিকাভুক্ত করি। অডিও নিজে QuranCDN থেকে স্ট্রিম হয়।
• আটকে রাখা উৎস। পুনর্বিতরণযোগ্য নয় বলে চিহ্নিত উৎসের পাঠ কখনো ফেরত দেওয়া হয় না।
• বইয়ের বাল্ক এক্সপোর্ট ও হাদিসের মান নির্ণয়। MCP সার্ভার রেট লিমিটসহ একবারে একটি কলে পৃষ্ঠা ফেরত দেয় এবং কোনো হাদিসের মান নির্ণয় করে না।
• SDK বা OpenAPI ফাইল। নথিভুক্ত কিছু নেই।

অ্যাক্সেস কীভাবে চাইবেন

কুরআন API বা কী ছাড়া MCP স্তরের জন্য অ্যাক্সেস চাইতে হয় না। MCP-তে বেশি সীমা চাইলে ওপরের মতো বিনামূল্যের কী তৈরি করুন। অন্য সবকিছুর জন্য, যেমন বেশি ব্যবহার, অনুপস্থিত এন্ডপয়েন্ট বা লাইসেন্স-প্রশ্ন, support@qurangallery.com-এ লিখুন অথবা যোগাযোগ পেজ ব্যবহার করুন।