# Quran Search

> Quran verse search and lookup via AlQuran Cloud API

- **Type:** Skill
- **Install:** `agentstack add skill-moshe-ship-hurmoz-quran-search`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Moshe-ship](https://agentstack.voostack.com/s/moshe-ship)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Moshe-ship](https://github.com/Moshe-ship)
- **Source:** https://github.com/Moshe-ship/hurmoz/tree/main/quran-search

## Install

```sh
agentstack add skill-moshe-ship-hurmoz-quran-search
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# بحث في القرآن الكريم

## جلب آية بالرقم

```bash
curl -s "https://api.alquran.cloud/v1/ayah/SURAH:AYAH/ar.alafasy"
```

مثال — الآية 255 من البقرة (آية الكرسي):
```bash
curl -s "https://api.alquran.cloud/v1/ayah/2:255/editions/quran-uthmani,ar.alafasy" | jq '.data[0].text'
```

النتيجة المتوقعة:
```
"اللَّهُ لَا إِلَٰهَ إِلَّا هُوَ الْحَيُّ الْقَيُّومُ ۚ لَا تَأْخُذُهُ سِنَةٌ وَلَا نَوْمٌ ..."
```

## جلب سورة كاملة

```bash
curl -s "https://api.alquran.cloud/v1/surah/SURAH_NUMBER/quran-uthmani"
```

مثال — سورة الفاتحة:
```bash
curl -s "https://api.alquran.cloud/v1/surah/1/quran-uthmani" | jq '.data.ayahs[].text'
```

مثال — سورة يس (السورة 36):
```bash
curl -s "https://api.alquran.cloud/v1/surah/36/quran-uthmani" | jq '.data.name,.data.ayahs | length'
```

## جلب جزء كامل

```bash
curl -s "https://api.alquran.cloud/v1/juz/JUZ_NUMBER/quran-uthmani"
```

مثال — الجزء 30 (جزء عمّ):
```bash
curl -s "https://api.alquran.cloud/v1/juz/30/quran-uthmani" | jq '.data.ayahs | length'
```

## بحث بالكلمة

```bash
curl -s "https://api.alquran.cloud/v1/search/KEYWORD/all/ar"
```

مثال — البحث عن "الرحمن":
```bash
curl -s "https://api.alquran.cloud/v1/search/الرحمن/all/ar" | jq '.data.count, .data.matches[:3]'
```

مثال — البحث عن "صبر":
```bash
curl -s "https://api.alquran.cloud/v1/search/صبر/all/ar" | jq '.data.count'
```

## البحث في سورة محددة

```bash
curl -s "https://api.alquran.cloud/v1/search/KEYWORD/SURAH_NUMBER/ar"
```

مثال — البحث عن "نور" في سورة النور فقط:
```bash
curl -s "https://api.alquran.cloud/v1/search/نور/24/ar" | jq '.data.matches[]'
```

## جلب آية مع الترجمة

```bash
curl -s "https://api.alquran.cloud/v1/ayah/SURAH:AYAH/editions/quran-uthmani,en.sahih"
```

مثال — آية الكرسي مع الترجمة الإنجليزية:
```bash
curl -s "https://api.alquran.cloud/v1/ayah/2:255/editions/quran-uthmani,en.sahih" \
  | jq '{arabic: .data[0].text, english: .data[1].text}'
```

## الطبعات المتاحة

| الطبعة | الوصف |
|--------|-------|
| `quran-uthmani` | الرسم العثماني (الأساسي) |
| `quran-simple` | بدون تشكيل |
| `ar.alafasy` | تلاوة العفاسي (رابط صوتي) |
| `ar.husary` | تلاوة الحصري |
| `en.sahih` | ترجمة صحيح إنترناشيونال |
| `en.pickthall` | ترجمة بيكثال |
| `ur.ahmedali` | ترجمة أوردو |

لعرض جميع الطبعات المتاحة:
```bash
curl -s "https://api.alquran.cloud/v1/edition" | jq '.data | length'
```

## عرض النتيجة

عند عرض آية:

سورة [اسم السورة] — آية [رقم]

﴿ نص الآية ﴾

## قواعد شرعية مهمة

- ما تفسّر من عندك — قل "للتفسير المفصل ارجع لتفسير ابن كثير أو الطبري"
- إذا طلب تفسير مختصر، اعطِ المعنى العام المتفق عليه فقط
- لا تجتهد في أحكام فقهية
- عند ذكر آية، تأكد من دقة النص بمراجعة API
- استخدم الأقواس القرآنية ﴿ ﴾ دائما عند عرض الآيات
- إذا طلب المستخدم "سورة كذا" بدون تحديد آية، اعرض أول 5 آيات واسأل إذا يريد المزيد

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Moshe-ship](https://github.com/Moshe-ship)
- **Source:** [Moshe-ship/hurmoz](https://github.com/Moshe-ship/hurmoz)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-moshe-ship-hurmoz-quran-search
- Seller: https://agentstack.voostack.com/s/moshe-ship
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.