Darakالمنصة
الاستخداماتالتوثيقالأدلةالباقات
تصفّح الأدلة
الأدلة

ابدأ هنا

  • البدء السريع
  • المصادقة

الذكاء الاصطناعي وMCP

  • ربط مساعد ذكاء اصطناعي
  • البناء باستخدام دارك والذكاء الاصطناعي

عن البيانات

  • ما هو الإعلان العقاري؟
  • التغطية وحداثة البيانات

البناء باستخدام البيانات

  • البحث والتصفية
  • الإشعارات عبر Webhooks
  • مزامنة نسخة محلية
  • التصدير الشامل

التشغيل

  • الحدود والحصص
  • تصفح الصفحات
  • إعادة المحاولة بأمان
  • الأخطاء
  • الإصدارات

السياسات

  • الشروط عمليًا

مرجع API

الأدلة

ابدأ هنا

  • البدء السريع
  • المصادقة

الذكاء الاصطناعي وMCP

  • ربط مساعد ذكاء اصطناعي
  • البناء باستخدام دارك والذكاء الاصطناعي

عن البيانات

  • ما هو الإعلان العقاري؟
  • التغطية وحداثة البيانات

البناء باستخدام البيانات

  • البحث والتصفية
  • الإشعارات عبر Webhooks
  • مزامنة نسخة محلية
  • التصدير الشامل

التشغيل

  • الحدود والحصص
  • تصفح الصفحات
  • إعادة المحاولة بأمان
  • الأخطاء
  • الإصدارات

السياسات

  • الشروط عمليًا

مرجع API

ربط مساعد ذكاء اصطناعي

استخدم Darak في Claude

مدرجة في دليل الموصلات لدى Anthropic. يعمل اتصال واحد في claude.ai وClaude Desktop وClaude على الجوال وClaude Code.

اربط مع Claudeتستخدم تطبيق ذكاء اصطناعي آخر؟
  1. 1

    اربط

    افتح Darak في دليل Claude واختر Connect.

  2. 2

    سجّل الدخول

    أدخل الرمز المكوّن من 6 أرقام الذي ترسله Darak إلى بريدك واختر مساحة عمل.

  3. 3

    اسأل

    اسأل عن الإعلانات والأسعار والأحياء بلغتك المعتادة.

جرّب أن تسأل

  • شقق من غرفتي نوم للإيجار في الياسمين بأقل من 60,000 ريال
  • هل سعر هذه الفيلا مناسب لسوق النرجس؟
  • ما أحياء شمال الرياض ذات أفضل عائد إيجاري؟

يتيح خادم MCP في دارك للمساعد البحث في إعلانات الإيجار والبيع السعودية، والتحقق من ملاءمة الأسعار، ومقارنة الأحياء والبحث في المشاريع العقارية باستخدام بيانات حية.

في Claude

تتشارك claude.ai وClaude Desktop وClaude على الجوال قائمة موصلات واحدة. افتح دارك في الدليل، أو انتقل إلى تخصيص ← الموصلات، وابحث عن دارك واختر اتصال. بعدها يتوفر دارك في كل محادثة وعلى كل جهاز تستخدم فيه حساب Claude نفسه.

في خطتي Team وEnterprise، يضيف المالك دارك مرة واحدة من إعدادات المؤسسة ← الموصلات، ثم يتصل كل عضو بحسابه الخاص في دارك.

Claude Code:

claude mcp add --transport http darak https://mcp.darak.app/mcp

ثم شغّل /mcp داخل Claude Code واختر دارك لتسجيل الدخول.

تطبيقات ذكاء اصطناعي أخرى

يمكن لأي عميل يدعم خوادم MCP البعيدة عبر Streamable HTTP مع تسجيل دخول OAuth الاتصال. أضف خادمًا بعيدًا بهذا الرابط:

https://mcp.darak.app/mcp

تختلف القوائم بين التطبيقات وإصداراتها؛ ابحث عن خيار إضافة خادم MCP أو موصل مخصص. للتحقق من الاتصال، اطلب «شقق بغرفتي نوم للإيجار في حي الياسمين بالرياض»؛ ينبغي أن يستدعي المساعد search_listings.

إذا كان التطبيق يشغّل خوادم MCP المحلية فقط، استخدم mcp-remote للربط بالخادم البعيد، وهو يتطلب Node.js:

{
  "mcpServers": {
    "darak": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.darak.app/mcp"]
    }
  }
}

العنوان القديم https://darak.app/mcp متوقف. إذا كان التطبيق لا يزال يستخدمه، احذف الخادم وأضفه مجددًا بالرابط الجديد.

تسجيل الدخول والتكلفة

عند أول استخدام، يفتح المساعد صفحة تسجيل الدخول إلى دارك في متصفحك:

  1. أدخل بريدك الإلكتروني. يرسل دارك رمزًا من 6 أرقام؛ لا توجد كلمة مرور.
  2. اختر مساحة العمل التي سيستخدمها الاتصال. إذا كنت مستخدمًا جديدًا، تُنشأ مساحة عمل مجانية في الخطوة نفسها.
  3. وافق على الوصول للقراءة فقط.

تُحتسب الطلبات على خطة مساحة العمل وتظهر في الاستخدام وسجلات الطلبات مثل طلبات مفاتيح API. تشمل الخطة المجانية 250 وحدة شهريًا؛ وتعتمد تكلفة الطلب على الأداة وعدد النتائج. يمكن لكل خطة استخدام كل الأدوات: إحصاءات السوق والتقييمات والمشاريع غير المتاحة لمفاتيح API المجانية متاحة عبر MCP ضمن الوحدات الشهرية للخطة، بحد أقصى 1,000 وحدة شهريًا. بعد بلوغ حد، تجيب الأداة برابط ترقية بدل البيانات.

لا تضع مفتاح API في إعدادات MCP لتطبيق ذكاء اصطناعي؛ تسجيل الدخول هو الطريقة الوحيدة التي يقبل بها الخادم الاتصال.

الأدوات

كل الأدوات للقراءة فقط. لا تنشئ أو تغيّر أو تحذف أي شيء.

الأداةما تجيب عنه
search_listingsإعلانات إيجار أو بيع نشطة تطابق الحي والسعر والغرف والمساحة والمرافق وغيرها
get_listings_countعدد الإعلانات المطابقة دون إرجاعها
get_listingsالسجلات الكاملة لما يصل إلى 100 إعلان بحسب المعرّف
get_comparable_listingsإعلانات مشابهة قريبة مع ملخص سعري
get_price_historyتغيّرات السعر المسجلة لإعلان
check_listing_priceمدى ارتفاع أو انخفاض سعر إعلان مقارنة بمدينته وحيّه
get_best_value_listingsالإعلانات الأبعد سعرًا تحت أسعار الإعلانات المقارنة
get_market_statsوسطاء الأسعار والتوزيعات والمعروض لشريحة سوق
get_neighborhood_rent_mapوسيط السعر لكل حي في مدينة
compare_neighborhoodsمقارنة حيين إلى خمسة أحياء جنبًا إلى جنب
get_neighborhood_trendsاتجاه أسعار العرض الشهرية خلال آخر شهرين إلى 12 شهرًا
get_rental_yieldتقدير العائد الإيجاري الإجمالي بحسب المدينة والحي
get_reference_dataأسماء الأحياء ومعرّفاتها وجهات المدينة مثل شمال الرياض وغيرها من القيم المرجعية
search_projectsمشاريع عقارية على الخارطة وجاهزة
get_projectالسجل الكامل لمشروع
get_project_unitsالوحدات ضمن مشروع
search_project_unitsالوحدات عبر المشاريع بمرشّحات المشروع والوحدة
list_developersالمطورون الذين لديهم مشاريع نشطة

طبيعة البيانات

  • كل سعر هو سعر العرض لإعلان نشط، لا بيع مكتمل أو عقد إيجار موقّع أو صفقة مسجلة.
  • الأسعار بالريال السعودي، والإيجار سنوي دائمًا حتى لو نُشر الإعلان بسعر شهري. يُحفظ المبلغ الأصلي بجانبه.
  • تصف الوسطاء والاتجاهات أسعار العرض وتتغيّر مع مزيج الإعلانات. ليست توقعات أو تقييمات عقارية معتمدة.
  • لا يملك دارك بيانات الجريمة أو المدارس أو التركيبة السكانية.

يوضح دليل التغطية وحداثة البيانات المدن والمصادر.

قطع الاتصال

في Claude، انتقل إلى تخصيص ← الموصلات، وافتح دارك واختر قطع الاتصال. في التطبيقات الأخرى، احذف خادم MCP. ينتهي أي رمز وصول لا يزال لدى التطبيق خلال ساعة. لقطع الوصول قبل ذلك، راسل [email protected].

توضح سياسة خصوصية دارك ما يسجله خادم MCP. تُسجل الطلبات في سجل مساحة العمل وفق إعداد الاحتفاظ الخاص بها.

لمطوري العملاء

يرد الخادم على الطلب الأول بالحالة 401 وتحدي Bearer. تحدد بيانات المورد المحمي المورد https://mcp.darak.app/mcp والنطاق darak.read وجهة إصدار خادم التفويض https://darak.app/api/auth. يكتشف العميل نقاط التفويض والتسجيل والرموز من جهة الإصدار، ويجب أن يستخدم OAuth 2.1 مع S256 PKCE. تستمر رموز الوصول ساعة ورموز التحديث حتى أسبوع. يستبدل الخادم رمز المستخدم ببيانات اعتماد API قصيرة الأجل مرتبطة بمساحة العمل المختارة عند الموافقة؛ لا يقبل API رموز عملاء MCP مباشرة.

استكشاف الأخطاء. تعني 401 مع resource_metadata أن على العميل اكتشاف جهة الإصدار وعرض تسجيل الدخول. إذا استمر في استخدام المورد القديم أو رمز مخزّن، احذف الخادم وأعد إضافته. لا ترسل رمز DPoP كرمز Bearer. عند فشل طلب بسبب النطاق أو حدود الخطة، راجع الاستخدام وسجلات الطلبات أو راسل [email protected].

Darak API

بيانات العقارات السعودية للمطوّرين.

المنتج
  • مرجع API
  • تغطية البيانات
  • الباقات
  • فحوصات التقييم
  • سجل التحديثات
  • حالة الخدمة
الشركة
  • darak.app
  • تواصل معنا
  • الأمان
الشؤون القانونية
  • الشروط
  • جهات المعالجة الفرعية
© Darak