البيانابحثاسألالمقالاتالمعاجمالرواةالموضوعات

للمطوّرين: واجهة البيان البرمجية وخادم MCP

Free, keyless Hadith & Qur'an tafsir API and remote MCP server — Arabic

محتوى البيان متاح للتطبيقات والمواقع ومساعدات الذكاء الاصطناعي مجانًا، بلا تسجيل ولا مفتاح: الأحاديث بدرجاتها وتخريجها ورواتها، والآيات بتفسيرها، والرواة، والمقالات. كل نتيجة تحمل رابط صفحتها في الموقع.

جرّبه الآن

افتح هذا الرابط في المتصفح، أو اطلبه من أي برنامج:

https://bayan.alwa7i.com/api/hadith/sahih-al-bukhari?number=1

ومن JavaScript:

const res = await fetch("https://bayan.alwa7i.com/api/search?q=" + encodeURIComponent("الصبر"));
const { verses, hadith, articles } = await res.json();

نقاط الواجهة (Endpoints)

/api/search?q={كلمات}بحث في الآيات وأحاديث «سبيل الرشاد» والصحيحين والمقالات
/api/hadith/{book}?number={n}الحديث برقمه كما يُعزى إليه: نصه ودرجته ورواته وتخريجه
/api/hadith/{book}/{seq}الحديث بموضعه في الكتاب، كما في روابط الموقع
/api/quran/{surah}/{ayah}الآية مع مقاطع تفسيرها من كتب التفسير
/api/narrator?name={الاسم}الراوي: رابط صفحته عند أئمة الجرح والتعديل ومقالات البيان عنه
/api/articlesالمقالات والأجوبة المنشورة، الأحدث أولًا
/api/articles/{slug}مقالة كاملة
/feed.xmlخلاصة RSS لأحدث المقالات

كتب الحديث: sabil-al-rashad، sahih-al-bukhari، sahih-muslim، sunan-abi-dawud، jami-al-tirmidhi، sunan-al-nasai، sunan-ibn-majah، musnad-ahmad، al-muwatta

التوثيق الكامل بصيغة JSON: /api — ومواصفات OpenAPI (لـ GPT Actions وغيرها): /openapi.json

خادم MCP لمساعدات الذكاء الاصطناعي

أضف هذا الرابط في مساعدك (Claude أو ChatGPT أو Cursor أو غيرها) بوصفه موصلًا مخصّصًا (custom connector / remote MCP server)، فيستطيع المساعد البحث في البيان وجلب الأحاديث والآيات مباشرة:

https://bayan.alwa7i.com/mcp
  • search — البحث بالكلمات
  • get_hadith — حديث برقمه أو موضعه
  • get_verse — آية وتفسيرها
  • get_narrator — راوٍ
  • list_articles — قائمة المقالات
  • get_article — مقالة

مسجَّل في سجل MCP الرسمي باسم com.alwa7i.bayan/bayan. النقل: Streamable HTTP، بلا مصادقة.

الشروط والحدود

  • اذكر «البيان» وضع رابط العنصر (حقل link) بجانب أي نص تأخذه منه.
  • نصوص الكتب من OpenITI برخصة CC BY-NC-SA 4.0 (غير تجاري، مع النسبة)، ونص القرآن من Tanzil بنصه دون تغيير.
  • 120 طلبًا في الدقيقة و5000 في اليوم لكل عنوان IP؛ النتائج مخزّنة مؤقتًا فتأتي سريعة.
  • للقراءة فقط (GET)، وCORS مفتوح للمتصفحات.

لأدوات الذكاء الاصطناعي ملف تعريفي مختصر: /llms.txt