← Back to portfolio
🌐
Web App

Rukhas: AI Business Licensing Agent for Saudi Arabia

An AI agent that searches every Saudi government source and compiles the full licensing requirements for any business — documents, fees, steps, and official links — in one bilingual report.

🌐 Visit Website ✉️ Contact Me

Rukhas (رُخَص, "licenses") is an AI agent that answers a deceptively hard question: "What do I actually need to license this business in Saudi Arabia?" You type a business type — a restaurant, a pharmacy, an engineering office — and the agent does the research for you.
How It Works:
- Validates that the input is a real, licensable business activity
- Classifies the industry to target the right authorities
- Runs multiple autonomous rounds of web search across government sources
- Reads the official pages, extracts requirements, then searches again to fill any gaps
- Compiles a single structured report: requirements, required documents, fees, timeline, and direct official links
Sources Searched:
Ministry of Commerce, Balady (municipal), Ministry of Investment, Human Resources, ZATCA, GOSI, the Food and Drug Authority, Civil Defense, and more — whichever apply to the activity.
Key Features:
- Bilingual output — results in Arabic or English
- Up to 16 autonomous search iterations per query
- Anti-injection input sanitization and a lightweight LLM validation gate
- Shareable, printable reports
- Result caching to keep repeat lookups fast
The Stack:
- Node.js and Express backend running an agentic search loop
- OpenRouter LLM API for validation, planning, and synthesis
- A self-hosted SearXNG metasearch instance for web queries
- Cheerio for parsing official pages
- Dockerized and served behind Nginx

رُخَص هو وكيل ذكاء اصطناعي يجيب عن سؤال أصعب مما يبدو: «ما الذي أحتاجه فعلاً لترخيص هذا النشاط التجاري في السعودية؟» تكتب نوع النشاط — مطعم، صيدلية، مكتب هندسي — فيقوم الوكيل بالبحث نيابةً عنك.
كيف يعمل:
- يتحقق من أن المُدخل نشاط تجاري حقيقي قابل للترخيص
- يصنّف القطاع لاستهداف الجهات الصحيحة
- يُجري جولات بحث ذاتية متعددة عبر المصادر الحكومية
- يقرأ الصفحات الرسمية، ويستخرج المتطلبات، ثم يبحث مجدداً لسدّ أي نقص
- يجمّع تقريراً منظّماً واحداً: المتطلبات والوثائق المطلوبة والرسوم والجدول الزمني وروابط رسمية مباشرة
الجهات التي يبحث فيها:
وزارة التجارة، بلدي، وزارة الاستثمار، الموارد البشرية، هيئة الزكاة والضريبة والجمارك، التأمينات الاجتماعية، هيئة الغذاء والدواء، الدفاع المدني، وغيرها — بحسب ما ينطبق على النشاط.
أبرز المميزات:
- مخرجات ثنائية اللغة — نتائج بالعربية أو الإنجليزية
- حتى 16 جولة بحث ذاتية لكل استعلام
- تنقية للمُدخلات ضد الحقن وبوابة تحقق ذكية خفيفة
- تقارير قابلة للمشاركة والطباعة
- تخزين مؤقت للنتائج لتسريع عمليات البحث المتكررة
التقنيات:
- خلفية Node.js وExpress تشغّل حلقة بحث وكيلية
- واجهة OpenRouter لنماذج اللغة للتحقق والتخطيط والتوليف
- نسخة SearXNG مستضافة ذاتياً للبحث في الويب
- مكتبة Cheerio لتحليل الصفحات الرسمية
- مُحزَّم بـ Docker ويُقدَّم خلف Nginx

Node.js Express OpenRouter (LLM) SearXNG Cheerio Docker Nginx

Get in
touch
تواصل
معي

Interested in this project? Want source code, deployment, or collaboration? Reach out.