shamela_search_library : chercher dans les livres arabes classiques avec citations
Paramètres et champs de résultat de shamela_search_library, l'outil MCP qui renvoie des passages arabes exacts avec édition, page et lien Maktabah.
Sur cette page
Trois paramètres. Il cherche dans une tranche nommée de la bibliothèque et renvoie des passages avec leurs citations attachées.
C’est l’un des 15 outils, et celui à essayer en premier — c’est la seule recherche qui refuse de s’exécuter sans portée et qui vous dit comment elle a apparié. Pour tout ce qu’il ne sait pas faire, voir la liste complète des outils.
Paramètres
| Paramètre | Requis | Type | Notes |
|---|---|---|---|
query | oui | chaîne | Texte arabe uniquement. Une formulation entre guillemets fonctionne mieux ; un sujet fonctionne aussi. |
scope | oui | chaîne | L’un de douze noms — voir Choisir une portée. Cet outil ne s’exécute pas sans portée. |
limit | non | entier | Nombre de passages à renvoyer, de 1 à 10. 5 par défaut. |
Que scope soit obligatoire est le point le plus important de cet outil, et la page des portées en explique la raison en détail : sans portée, cette bibliothèque classe selon la fréquence d’un mot, ce qui enfouit les livres que vous voulez réellement.
La requête doit être en arabe
La bibliothèque est arabe, et l’index aussi. Une requête sans aucun mot arabe est rejetée d’emblée — c’est une erreur d’outil (isError), pas un résultat vide, et le message dit au modèle quoi faire :
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”.
Cela vaut pour le français (intention de la prière) comme pour la translittération (innama al-a'mal bil-niyyat). Si votre assistant part d’une question en français, il doit traduire les termes de recherche en arabe avant d’appeler cet outil. Rien ne les traduit à sa place. L’outil search sans portée se comporte de la même manière.
Les signes diacritiques n’ont pas d’importance. انما الاعمال بالنيات et إِنَّمَا الْأَعْمَالُ بِالنِّيَّاتِ renvoient les mêmes résultats ; inutile donc de vocaliser une requête ou de retirer les voyelles d’une requête copiée.
Ce qui revient
Un objet de résultat avec les passages et un contexte sur la recherche elle-même :
| Champ | Signification |
|---|---|
passages | Les résultats, décrits ci-dessous. |
relaxedToTokens | true quand la phrase exacte n’a pas été trouvée et qu’une recherche de mots plus large a répondu. |
scope | La portée qui a été cherchée, renvoyée en écho. |
booksSearched | Combien de livres comptait cette portée. |
totalMatches | Combien de pages ont correspondu au total, dont vous recevez jusqu’à limit. Peut valoir null à la passe de repli. |
note | Présent seulement quand le résultat appelle une réserve — voir plus bas. |
Chaque entrée de passages :
| Champ | Signification |
|---|---|
book | Titre avec l’impression, par exemple صحيح البخاري - ط السلطانية. |
author | Le nom de l’auteur. |
authorDied | Année du décès en AH, ou null si inconnue. |
printedPage | Volume et page tels que cette impression les pagine, par exemple 1/ 6. |
arabic | Le passage lui-même, exact, sans aucun balisage. |
matchedIn | body, footnote, both ou unknown — où les mots ont été trouvés. |
matchQuality | Comment l’appariement a été fait, par exemple exact_phrase. |
bookId, pageId | Les identifiants Shamela de la page. |
edition, editor, publisher | Données bibliographiques de cette impression. Présentes seulement quand la bibliothèque les possède ; jamais devinées. |
sourceUrl | https://qurangallery.com/maktabah/book/{bookId}/{pageId}, la même page dans le lecteur Maktabah. Citez al-Maktaba al-Shamela. |
Les deux passes
La recherche exécute d’abord la passe stricte, puis se replie :
- Phrase exacte. Vos mots, dans l’ordre, tels qu’écrits.
- Mots ensemble, si la phrase n’a rien trouvé — les mêmes mots n’importe où sur une page, dans n’importe quel ordre.
On vous dit toujours laquelle a répondu, via relaxedToTokens. Ce drapeau n’est pas de la comptabilité ; il change le sens du résultat, et Lire un résultat explique comment.
Le repli existe parce que la formulation transmise varie d’une impression à l’autre. Chercher إنما الأعمال بالنيات comme phrase stricte trouve un livre et manque Sahih al-Bukhari, qui imprime بالنية. La passe plus large trouve al-Bukhari, Ibn Majah, Abu Dawud et al-Nasa’i. N’exécuter que la passe stricte transformerait un hadith célèbre et bien attesté en « introuvable » — ce qui, dans ce domaine, est en soi une sorte de fausse affirmation.
Un exemple détaillé
Chercher إنما الأعمال بالنيات dans la portée hadith-primary renvoie, entre autres :
| Champ | Valeur |
|---|---|
book | صحيح البخاري - ط السلطانية |
author | البخاري |
authorDied | 256 |
printedPage | 1/ 6 |
matchedIn | body |
matchQuality | exact_phrase |
arabic | …عُمَرَ بْنَ الْخَطَّابِ ﵁ عَلَى الْمِنْبَرِ، قَالَ: سَمِعْتُ رَسُولَ اللهِ ﷺ، يَقُولُ: «إِنَّمَا الْأَعْمَالُ بِالنِّيَّاتِ… |
Avec booksSearched: 8 et relaxedToTokens: false — huit recueils épinglés à une édition, et la phrase exacte a été trouvée.
Le … initial est voulu : il marque un passage qui commence au milieu d’une phrase, parce que l’extrait est une fenêtre sur la page et non la page entière.
Longueur de l’extrait
Les passages sont plafonnés à environ 1 600 caractères arabes et tronqués par un … final s’ils sont plus longs. Cet outil renvoie des citations, pas des livres.
Si vous voulez la page entière plutôt que la fenêtre qui correspond, prenez le bookId et le pageId d’un résultat et passez-les à shamela_read (unit: 'page'). shamela_read (unit: 'range') et shamela_read (unit: 'section') lisent plus loin — voir la liste complète des outils.