جوكر برايس
ابدأ التجربة المجانية
قائمة وثائق المطورين

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

يتيح خادم MCP من جوكر برايس لـ Claude وCodex وCursor وغيرها من تطبيقات Model Context Protocol الاطلاع على الأسواق والإشغال وتقديرات الإيرادات والعقارات في الخليج ومصر، والإجابة بأرقام حقيقية.

ابدأ الإعداداستعرض الأدوات

آلية العمل

للقراءة فقط

8 أدوات تقرأ البيانات فقط، فلا يتغير شيء في حسابك أو على أي منصة.

مستضاف أو محلي

اتصل بـ https://jokerprice.com/mcp بمفتاحك دون تثبيت أي شيء، أو شغّل الخادم على جهازك عبر stdio. وكلاهما يقرأ بيانات واجهة REST API نفسها بمفتاحك الشخصي.

الحدود نفسها

حدود API في خطتك، 120 في الدقيقة و25,000 يوميًا خلال التجربة المجانية، مع رسائل واضحة عند بلوغها.

الأدوات

الأداةما تجيب عنه
list_marketsكل وجهة تضم 20 عقارًا مجمّعًا على الأقل: المعرّف (slug)، وعدد العقارات حسب المصدر، وأرباع السعر المعروض بالريال السعودي، والإشغال ومتوسط السعر اليومي والإيرادات حيث تُتتبَّع التقويمات. يستدعيها المساعد أولًا لمعرفة المعرّفات.
get_marketالتقرير الكامل لوجهة واحدة: العرض، ونطاقات الأسعار حسب عدد غرف النوم، وتوزيع أنواع العقارات، ومتوسط التقييم، والإشغال المتتبَّع ومتوسط السعر اليومي والإيراد لكل وحدة متاحة والإيراد لكل عقار ونسبة الليالي المحجوزة مسبقًا، مع تفصيل حسب أيام الأسبوع والأشهر والمهلة المسبقة للحجز.
get_metricsالإشغال ومتوسط السعر اليومي والإيراد لكل وحدة متاحة والإيراد الشهري لكل عقار ونسبة الليالي المحجوزة مسبقًا لمدينة أو مستطيل، مع تفصيل حسب أيام الأسبوع والأشهر والمهلة المسبقة للحجز.
list_listingsالعقارات المجمّعة مع المصدر والعنوان والحي ومعرّف النوع وعدد غرف النوم والإحداثيات وآخر سعر معروض بالريال السعودي والتقييم من 10 والرابط. ويتنقل المساعد بين الصفحات باستخدام nextCursor.
estimate_revenueالسعر الليلي المتوقع والإشغال والإيرادات الشهرية والسنوية استنادًا إلى العقارات المماثلة القريبة والتقويمات المتتبَّعة، أو سيناريوهات بنسب 40٪ و55٪ و70٪ عندما لا يكون الإشغال مقيسًا.
get_trendsالسجل اليومي لوجهة واحدة ومؤشر واحد من اللقطات المحفوظة، مع التغير مقارنة بالقيم قبل 7 و30 و90 يومًا متى سمح السجل.
get_market_paceنسبة الليالي المحجوزة مسبقًا لكل تاريخ إقامة خلال الأيام الثلاثين القادمة، ومقدار الحجوزات المستجدة (pickup) خلال 7 و14 يومًا، ومنحنى الحجز المتوسط حسب عدد الأيام السابقة للوصول. تبقى البيانات قيد الجمع حتى يتوفر أسبوع من اللقطات.
get_eventsالعطل والمناسبات المحلية الموثّقة المصادر في الأسواق التي نغطيها، بأسمائها العربية والإنجليزية وتواريخها ودرجة تأكيدها وروابط مصادرها، للإجابة عن أسئلة الطلب والتسعير.

التطبيقات

Claude

Claude Desktop وClaude Code.

Codex

Codex CLI وإضافة بيئة التطوير (IDE).

تطبيقات أخرى

Cursor وأي تطبيق يتصل بالخوادم البعيدة (Streamable HTTP) أو يشغّل خوادم stdio.

ابدأ الآن

  • مفتاح API لجوكر برايس من صفحة البيانات وواجهة API (Data & API).
  • للخادم المستضاف: تطبيق MCP يتصل بالخوادم البعيدة (Streamable HTTP) ويستطيع إرسال ترويسة مع الطلب، دون تثبيت أي شيء.
  • للخادم المحلي بديلًا: Node.js 20 أو أحدث، وشيفرة الخادم من مجلد mcp/ في مستودع جوكر برايس مع تشغيل npm install داخله مرة واحدة.

ابدأ التجربة المجانية

بعد إنشاء المفتاح، يكفي أمر واحد لربط Claude Code بالخادم المستضاف:

سطر الأوامر
claude mcp add --transport http jokerprice https://jokerprice.com/mcp --header "Authorization: Bearer ss_your_key_here"

ثم اتبع خطوات الإعداد. لست متأكدًا أيهما يناسبك، MCP أم REST API؟ اقرأ MCP مقابل REST API.