Aller au contenu

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ètreRequisTypeNotes
queryouichaîneTexte arabe uniquement. Une formulation entre guillemets fonctionne mieux ; un sujet fonctionne aussi.
scopeouichaîneL’un de douze noms — voir Choisir une portée. Cet outil ne s’exécute pas sans portée.
limitnonentierNombre 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 :

ChampSignification
passagesLes résultats, décrits ci-dessous.
relaxedToTokenstrue quand la phrase exacte n’a pas été trouvée et qu’une recherche de mots plus large a répondu.
scopeLa portée qui a été cherchée, renvoyée en écho.
booksSearchedCombien de livres comptait cette portée.
totalMatchesCombien de pages ont correspondu au total, dont vous recevez jusqu’à limit. Peut valoir null à la passe de repli.
notePrésent seulement quand le résultat appelle une réserve — voir plus bas.

Chaque entrée de passages :

ChampSignification
bookTitre avec l’impression, par exemple صحيح البخاري - ط السلطانية.
authorLe nom de l’auteur.
authorDiedAnnée du décès en AH, ou null si inconnue.
printedPageVolume et page tels que cette impression les pagine, par exemple 1/ 6.
arabicLe passage lui-même, exact, sans aucun balisage.
matchedInbody, footnote, both ou unknown — où les mots ont été trouvés.
matchQualityComment l’appariement a été fait, par exemple exact_phrase.
bookId, pageIdLes identifiants Shamela de la page.
edition, editor, publisherDonnées bibliographiques de cette impression. Présentes seulement quand la bibliothèque les possède ; jamais devinées.
sourceUrlhttps://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 :

  1. Phrase exacte. Vos mots, dans l’ordre, tels qu’écrits.
  2. 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 :

ChampValeur
bookصحيح البخاري - ط السلطانية
authorالبخاري
authorDied256
printedPage1/ 6
matchedInbody
matchQualityexact_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.

Étapes suivantes

Modifier cette page sur GitHub