search_library: উদ্ধৃতিসহ ক্লাসিক্যাল আরবি বইয়ে সার্চ
search_library-র প্যারামিটার ও ফলাফলের ক্ষেত্র: সংস্করণ, ছাপা পৃষ্ঠা ও shamela.ws লিংকসহ হুবহু আরবি অংশ ফেরত দেওয়া MCP টুল।
এই পাতায়
তিনটি প্যারামিটার। এটি লাইব্রেরির একটি নামযুক্ত অংশে খোঁজে এবং উদ্ধৃতি সংযুক্ত করে অংশগুলো ফেরত দেয়।
এটি ৩৯টি টুলের একটি, এবং প্রথমে চেষ্টা করার মতো — এটিই একমাত্র সার্চ যা স্কোপ ছাড়া চলতে অস্বীকার করে এবং কীভাবে মিলিয়েছে তা জানায়। এটি যা পারে না তার জন্য দেখুন পূর্ণ টুল তালিকা।
প্যারামিটার
| প্যারামিটার | আবশ্যক | ধরন | মন্তব্য |
|---|---|---|---|
query | হ্যাঁ | string | শুধু আরবি পাঠ। উদ্ধৃতি চিহ্নে একটি শব্দবিন্যাস সবচেয়ে ভালো কাজ করে; একটি বিষয়ও কাজ করে। |
scope | হ্যাঁ | string | বারোটি নামের একটি — দেখুন স্কোপ বেছে নেওয়া। এই টুল একটি ছাড়া চলবে না। |
limit | না | integer | ফেরত দেওয়ার অংশের সংখ্যা, ১–১০। ডিফল্ট ৫। |
scope আবশ্যক হওয়াই এই টুল সম্পর্কে সবচেয়ে গুরুত্বপূর্ণ বিষয়, এবং স্কোপ পৃষ্ঠা কেন তা পূর্ণ ব্যাখ্যা করে: স্কোপ ছাড়া এই লাইব্রেরি একটি শব্দ কতবার আসে তা দিয়ে র্যাঙ্ক করে, যা আপনি আসলে যে বইগুলো চান সেগুলোকে চাপা দেয়।
কুয়েরি অবশ্যই আরবিতে হতে হবে
লাইব্রেরি আরবি এবং ইনডেক্সও আরবি। আরবি শব্দহীন কুয়েরি সরাসরি প্রত্যাখ্যাত হয় — এটি একটি ত্রুটি, খালি ফলাফল নয়:
Query has no searchable Arabic words.
এটি ইংরেজি (prayer intention) এবং লিপ্যন্তর (innama al-a'mal bil-niyyat) উভয়ের ক্ষেত্রেই প্রযোজ্য। আপনার অ্যাসিস্ট্যান্ট ইংরেজি প্রশ্ন থেকে কাজ করলে এই টুল কল করার আগে তাকে সার্চের শব্দগুলো আরবিতে অনুবাদ করতে হবে। তার জন্য কেউ অনুবাদ করে না।
হরকত গুরুত্বপূর্ণ নয়। انما الاعمال بالنيات ও إِنَّمَا الْأَعْمَالُ بِالنِّيَّاتِ একই ফলাফল দেয়, তাই কুয়েরিতে হরকত দেওয়ার বা কপি করা কুয়েরি থেকে হরকত সরানোর দরকার নেই।
ফেরত আসে যা
অংশগুলো এবং সার্চ সম্পর্কে কিছু প্রসঙ্গসহ একটি ফলাফল অবজেক্ট:
| ক্ষেত্র | অর্থ |
|---|---|
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://shamela.ws/book/{bookId}/{pageId}, shamela.ws-এ একই পৃষ্ঠা। উদ্ধৃত করার সময় shamela.ws-কে কৃতজ্ঞতা জানান। |
দুটি পাস
সার্চ প্রথমে কঠোর পাস চালায়, তারপর ফলব্যাক করে:
- হুবহু বাক্যাংশ। আপনার শব্দগুলো, ক্রমানুসারে, যেমন লেখা।
- শব্দগুলো একসাথে, বাক্যাংশ কিছু না পেলে — একই শব্দ একটি পৃষ্ঠার যেকোনো জায়গায়, যেকোনো ক্রমে।
কোনটি উত্তর দিয়েছে তা relaxedToTokens-এর মাধ্যমে সবসময় আপনাকে জানানো হয়। এই ফ্ল্যাগ হিসাব রাখার জন্য নয়; এটি ফলাফলের অর্থ বদলে দেয়, এবং ফলাফল পড়া তা কীভাবে তা ব্যাখ্যা করে।
ফলব্যাক আছে কারণ বর্ণিত শব্দবিন্যাস মুদ্রণ ভেদে ভিন্ন হয়। إنما الأعمال بالنيات কঠোর বাক্যাংশ হিসেবে খুঁজলে একটি বই পাওয়া যায় এবং সহীহ বুখারী বাদ পড়ে, যা بالنية ছাপে। শিথিল পাস পায় বুখারী, ইবনে মাজাহ, আবু দাউদ ও নাসাঈ। কেবল কঠোর পাস চালালে একটি বিখ্যাত, সুপ্রমাণিত হাদীস “পাওয়া যায়নি” হয়ে যেত — এই বিষয়ে যা নিজেই এক ধরনের মিথ্যা দাবি।
একটি কাজের উদাহরণ
hadith-primary স্কোপে إنما الأعمال بالنيات খুঁজলে অন্যান্যের মধ্যে ফেরত আসে:
| ক্ষেত্র | মান |
|---|---|
book | صحيح البخاري - ط السلطانية |
author | البخاري |
authorDied | 256 |
printedPage | 1/ 6 |
matchedIn | body |
matchQuality | exact_phrase |
arabic | …عُمَرَ بْنَ الْخَطَّابِ ﵁ عَلَى الْمِنْبَرِ، قَالَ: سَمِعْتُ رَسُولَ اللهِ ﷺ، يَقُولُ: «إِنَّمَا الْأَعْمَالُ بِالنِّيَّاتِ… |
booksSearched: 8 এবং relaxedToTokens: false সহ — আটটি সংস্করণ-স্থির সংকলন, এবং হুবহু বাক্যাংশ পাওয়া গেছে।
শুরুর … ইচ্ছাকৃত: এটি এমন একটি অংশ চিহ্নিত করে যা বাক্যের মাঝখান থেকে শুরু, কারণ উদ্ধৃতাংশটি পৃষ্ঠার একটি জানালা, পুরো পৃষ্ঠা নয়।
উদ্ধৃতাংশের দৈর্ঘ্য
অংশগুলো প্রায় ১,৬০০ আরবি অক্ষরে সীমিত এবং দীর্ঘ হলে শেষে … দিয়ে কাটা হয়। এই টুল উদ্ধৃতি ফেরত দেয়, বই নয়।
মিলে যাওয়া জানালার বদলে পূর্ণ পৃষ্ঠা দরকার হলে ফলাফল থেকে bookId ও pageId নিয়ে shamela_get_page-এ দিন। shamela_get_pages_range ও shamela_get_book_section আরো এগিয়ে পড়ে — দেখুন পূর্ণ টুল তালিকা।