Alfanous is an Arabic search engine API provides the simple and advanced search in Quran , more features and many interfaces...
# Add to your Claude Code skills
git clone https://github.com/Alfanous-team/alfanousAlfanous is a Quranic search engine API that provides simple and advanced search capabilities for the Holy Qur'an. It enables developers to build applications that search through Quranic text in Arabic, with support for Buckwalter transliteration, advanced query syntax, and rich metadata.
Install from PyPI using pip:
$ pip install alfanous3
>>> from alfanous import api
# Simple search for a word
>>> api.search(u"الله")
# Advanced search with options
>>> api.do({"action": "search", "query": u"الله", "page": 1, "perpage": 10})
# Search using Buckwalter transliteration
>>> api.do({"action": "search", "query": u"Allh"})
# Get suggestions
>>> api.do({"action": "suggest", "query": u"الح"})
# Get metadata information
>>> api.do({"action": "show", "query": "translations"})
No comments yet. Be the first to share your thoughts!
You can also use the public web service:
Or run your own web service locally (see alfanous_webapi).
Search for phrases:
>>> api.search(u'"الحمد لله"')
Boolean search (AND, OR, NOT):
>>> api.search(u'الصلاة + الزكاة') # AND
>>> api.search(u'الصلاة | الزكاة') # OR
>>> api.search(u'الصلاة - الزكاة') # NOT
Fielded search:
>>> api.search(u'سورة:يس') # Search in Sura Yasin
>>> api.search(u'سجدة:نعم') # Search verses with sajda
Wildcard search:
>>> api.search(u'*نبي*') # Words containing "نبي"
Faceted search (aggregate by fields):
>>> api.do({
... "action": "search",
... "query": u"الله",
... "facets": "sura_id,juz"
... })
api.search(query, **options) - Search Quran versesapi.do(params) - Unified interface for all actions (search, suggest, show)api.get_info(category) - Get metadata informationCommon parameters for api.do() with action="search":
query (str): Search query (required)unit (str): Search unit - "aya", "word", or "translation" (default: "aya")page...