shamela_search_library: بحث في الكتب التراثية مع التوثيق
معاملات shamela_search_library وحقول نتيجتها، أداة MCP التي تعيد مقاطع عربية حرفية مع الطبعة والصفحة المطبوعة ورابط المكتبة.
في هذه الصفحة
ثلاثة معاملات. تبحث في شريحة مسماة من المكتبة وتعيد مقاطع مرفقة بتوثيقها.
هذه إحدى 15 أداة، وهي التي ينبغي تجربتها أولًا — فهي البحث الوحيد الذي يرفض العمل بلا نطاق ويخبرك كيف طابق. وللمهام التي تعجز عنها انظر قائمة الأدوات الكاملة.
المعاملات
| المعامل | مطلوب | النوع | ملاحظات |
|---|---|---|---|
query | نعم | string | نص عربي فقط. الأفضل لفظ بين علامتي تنصيص؛ ويصلح موضوع أيضًا. |
scope | نعم | string | أحد اثني عشر اسمًا — انظر اختيار النطاق. لا تعمل هذه الأداة بدونه. |
limit | لا | integer | عدد المقاطع المعادة، من 1 إلى 10. الافتراضي 5. |
كون scope مطلوبًا هو أهم ما في هذه الأداة، وتشرح صفحة النطاقات السبب كاملًا: فبلا نطاق ترتّب هذه المكتبة بحسب كثرة ورود الكلمة، فتدفن الكتب التي تريدها فعلًا.
يجب أن يكون الاستعلام بالعربية
المكتبة عربية والفهرس كذلك. والاستعلام الذي لا كلمات عربية فيه يُرفض مباشرة — فهو خطأ في الأداة (isError) لا نتيجة فارغة، وتخبر الرسالة النموذج بما يفعله:
The library is Arabic, so the query must contain Arabic words. Translate the search terms into Arabic and call again, for example «إنما الأعمال بالنيات» for “actions are judged by intentions”.
وينطبق هذا على الإنجليزية (prayer intention) وعلى الحروف اللاتينية المنقولة (innama al-a'mal bil-niyyat) سواء. وإن كان مساعدك ينطلق من سؤال بالإنجليزية فعليه أن يترجم ألفاظ البحث إلى العربية قبل استدعاء هذه الأداة. فلا شيء يترجمها عنه. وأداة search غير المقيّدة بنطاق تسلك السلوك نفسه.
التشكيل لا يؤثر. انما الاعمال بالنيات وإِنَّمَا الْأَعْمَالُ بِالنِّيَّاتِ يعيدان النتائج نفسها، فلا حاجة إلى تشكيل استعلام ولا إلى تجريد ما نسخته من تشكيل.
ما يعود
كائن نتيجة فيه المقاطع وبعض السياق عن البحث نفسه:
| الحقل | المعنى |
|---|---|
passages | النتائج، موصوفة أدناه. |
relaxedToTokens | true حين لم توجد العبارة بنصها وأجاب بحث ألفاظ أوسع بدلًا منها. |
scope | النطاق الذي جرى البحث فيه، مُعادًا. |
booksSearched | عدد الكتب في ذلك النطاق. |
totalMatches | إجمالي الصفحات المطابقة، تتلقى منها حتى limit. وقد يكون null في المرحلة الاحتياطية. |
note | لا تظهر إلا حين تحتاج النتيجة إلى تنبيه — انظر أدناه. |
وكل عنصر في passages:
| الحقل | المعنى |
|---|---|
book | العنوان متضمنًا الطبعة، مثل صحيح البخاري - ط السلطانية. |
author | اسم المؤلف. |
authorDied | سنة الوفاة بالهجري، أو null إن جُهلت. |
printedPage | المجلد والصفحة كما تُرقّمهما تلك الطبعة، مثل 1/ 6. |
arabic | المقطع نفسه، حرفيًا، بعد إزالة كل الوسوم. |
matchedIn | body أو footnote أو both أو unknown — موضع العثور على الألفاظ. |
matchQuality | كيف جرت المطابقة، مثل exact_phrase. |
bookId وpageId | معرّفا الصفحة في الشاملة. |
edition وeditor وpublisher | البيانات الببليوغرافية لتلك الطبعة. لا تظهر إلا إذا كانت لدى المكتبة؛ ولا تُخمَّن أبدًا. |
sourceUrl | https://qurangallery.com/maktabah/book/{bookId}/{pageId}، الصفحة نفسها في قارئ المكتبة. انسب النص إلى المكتبة الشاملة عند الاقتباس. |
المرحلتان
يجري البحث المرحلة الصارمة أولًا ثم يرجع إلى الاحتياطية:
- العبارة بنصها. ألفاظك، بترتيبها، كما كتبتها.
- الألفاظ معًا، إن لم تجد العبارة شيئًا — الألفاظ نفسها في أي موضع من الصفحة وبأي ترتيب.
ويُخبرك دائمًا أي المرحلتين أجابت، عبر relaxedToTokens. وهذه الراية ليست حسابات داخلية؛ فهي تغيّر معنى النتيجة، وتتناول قراءة النتيجة كيفية ذلك.
وسبب المرحلة الاحتياطية أن ألفاظ الرواية تختلف بين الطبعات. فالبحث عن إنما الأعمال بالنيات عبارةً صارمة يجد كتابًا واحدًا ويفوّت صحيح البخاري الذي يطبع بالنية. أما المرحلة الأوسع فتجد البخاري وابن ماجه وأبا داود والنسائي. ولو اقتصر على المرحلة الصارمة لتحوّل حديث مشهور موثّق إلى «لم يوجد» — وهذا في هذا الباب ضرب من الادعاء الباطل.
مثال تطبيقي
البحث عن إنما الأعمال بالنيات في نطاق hadith-primary يعيد، من بين ما يعيد:
| الحقل | القيمة |
|---|---|
book | صحيح البخاري - ط السلطانية |
author | البخاري |
authorDied | 256 |
printedPage | 1/ 6 |
matchedIn | body |
matchQuality | exact_phrase |
arabic | …عُمَرَ بْنَ الْخَطَّابِ ﵁ عَلَى الْمِنْبَرِ، قَالَ: سَمِعْتُ رَسُولَ اللهِ ﷺ، يَقُولُ: «إِنَّمَا الْأَعْمَالُ بِالنِّيَّاتِ… |
مع booksSearched: 8 وrelaxedToTokens: false — ثمانية مجاميع مثبّتة على طبعات، ووُجدت العبارة بنصها.
و… في البداية مقصودة: فهي تدل على مقطع يبدأ من منتصف جملة، لأن المقتطف نافذة على الصفحة لا الصفحة كلها.
طول المقتطف
تُقيَّد المقاطع بنحو 1,600 حرف عربي وتُقتطع بـ… في آخرها إن زادت. وهذه الأداة تعيد اقتباسات لا كتبًا.
وإن احتجت الصفحة كاملة لا نافذة المطابقة فخذ bookId وpageId من النتيجة ومرّرهما إلى shamela_read (unit: 'page'). وتقرأ shamela_read (unit: 'range') وshamela_read (unit: 'section') أبعد من ذلك — انظر قائمة الأدوات الكاملة.