Mkhlab saudi-address

العنوان الوطني -- ابحث وتحقق من العناوين السعودية، حوّل إحداثيات لعنوان، واعثر على أقرب الخدمات

install

source · Clone the upstream repo

git clone https://github.com/Moshe-ship/mkhlab

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/Moshe-ship/mkhlab "$T" && mkdir -p ~/.claude/skills && cp -r "$T/hermes-skills/saudi-address" ~/.claude/skills/moshe-ship-mkhlab-saudi-address && rm -rf "$T"

manifest: hermes-skills/saudi-address/SKILL.md

source content

العنوان الوطني السعودي

واجهة العنوان الوطني الرسمية من البريد السعودي (SPL).

الإعداد

سجّل في بوابة المطورين: https://api.address.gov.sa/
احصل على API key

اضبط المتغير:

export NATIONAL_ADDRESS_API_KEY=your_key

البحث الحر

curl -s "https://api.address.gov.sa/freetextsearch?text=SEARCH_TEXT" \
  -H "api_key: $NATIONAL_ADDRESS_API_KEY"

البحث المحدد

curl -s "https://api.address.gov.sa/fixedsearch?city=Riyadh&district=Al+Olaya&street=King+Fahd+Road" \
  -H "api_key: $NATIONAL_ADDRESS_API_KEY"

أقرب الخدمات

curl -s "https://api.address.gov.sa/nearestpois?lat=24.7136&lng=46.6753&category=mosque" \
  -H "api_key: $NATIONAL_ADDRESS_API_KEY"

التحويل من إحداثيات لعنوان

curl -s "https://api.address.gov.sa/nationaladdress?lat=24.7136&lng=46.6753" \
  -H "api_key: $NATIONAL_ADDRESS_API_KEY"

عرض النتيجة

العنوان الوطني:

الرقم: [رقم المبنى] [رقم العنوان القصير]
الشارع: [اسم الشارع]
الحي: [اسم الحي]
المدينة: [المدينة]
الرمز البريدي: [الرمز]

متى تستخدم

المستخدم يبحث عن عنوان سعودي
يريد تحويل إحداثيات لعنوان
يريد أقرب مسجد/مستشفى/صيدلية
يحتاج العنوان الوطني لتوصيل أو مراسلة

المرجع

بوابة المطورين: https://api.address.gov.sa/