API وMCP

اتصل بكنكافا

اربط كنكافا مرة واحدة، ثم اسأل عن سوقك من تطبيق الذكاء الاصطناعي الذي تستخدمه.

1. أضف كنكافا

أضف هذا العنوان في إعدادات MCP أو الاتصالات بتطبيق الذكاء الاصطناعي.

https://kunkafa.com/mcp

2. أنشئ حسابًا أو سجّل الدخول

تفتح صفحة كنكافا في المتصفح. أنشئ حسابًا أو سجّل الدخول، ثم وافق على الاتصال.

3. اسأل عن سوقك

عُد إلى تطبيق الذكاء الاصطناعي لاستكشاف البيانات وطرح الأسئلة ومواصلة التعلم والبحث.

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

يتطلب تطبيق ذكاء اصطناعي يدعم MCP عن بُعد. راجع خطة مزودك ودليل الإعداد.

ChatGPT

أعدّ تطبيقًا مخصصًا في وضع المطور على موقع ChatGPT، ثم اختره في المحادثة. تُطبق قيود خطة المزود ومساحة العمل.

تعليمات إعداد المزود
Claude

أضف موصلًا مخصصًا برابط MCP لكنكافا في إعدادات Claude وأكمل التفويض في المتصفح. تحقق من إتاحة الموصلات لحسابك.

تعليمات إعداد المزود
Gemini

تُعدّ التطبيقات المخصصة على موقع Gemini حيث تتاح. تقيّد Google هذه الميزة حاليًا حسب الحساب والمنطقة واللغة؛ وليست متاحة لكل مستخدم. ولـGemini CLI إعداد MCP منفصل.

تعليمات إعداد المزود
Grok

استخدم موصلًا بعيدًا مخصصًا حيث يدعمه حساب Grok أو مساحة عملك. إذا لم تظهر أدوات الموصلات، فتحقق من متطلبات حساب المزود.

تعليمات إعداد المزود
OpenClaw

أضف كنكافا خادم MCP خارجيًا في تثبيت OpenClaw لديك، واستخدم تسجيل OAuth في المتصفح. لا يوجد رابط موحد لفتح تطبيق OpenClaw.

تعليمات إعداد المزود
تطبيق آخر يدعم MCP / Grokbot

تحقق من دعم تطبيقك لخوادم MCP البعيدة وOAuth في المتصفح. لا يشير اسم «Grokbot» هنا إلى موصل تم التحقق منه؛ استخدم تعليمات تطبيقك ولا تلصق بيانات اعتماد الحساب في المحادثة.

تعليمات إعداد المزود

جرّب هذا السؤال

استخدم كنكافا لشرح ما قد يحدث في سوقي المختار. اعرض الاتجاهين واشرح ثقة كنكافا.

ابدأ بملف السوق

افتح سوقًا في كنكافا واختر «انقل الحوار إلى تطبيق الذكاء الاصطناعي المفضل لديك». أعدّ ملفه ونزّله، ثم أرفقه في تطبيق الذكاء الاصطناعي والصق السؤال المرفق. لا تحتاج إلى اتصال مخصص. يعتمد توفر رفع الملفات على تطبيق الذكاء الاصطناعي.

يحتوي الملف على ملخصات مؤرخة للسوق في الاتجاهين، والأداء التاريخي المتاح، وما يصل إلى 10 نتائج منشورة، مع إرشادات وروابط المصادر العامة. إنه نسخة من البيانات في وقت محدد؛ أعدّ ملفًا جديدًا للحصول على بيانات خاصة محدثة. فتح تطبيق الذكاء الاصطناعي لا يرفق الملف تلقائيًا.

للمستخدم المتقدم: إعداد MCP المخصص

اربط كنكافا مرة واحدة في تطبيق الذكاء الاصطناعي. أنشئ حسابًا أو سجّل الدخول ووافق على الوصول في المتصفح، ثم عُد إلى الحوار لاستكشاف سوقك ومواصلة التعلم والبحث.

إعداد Pro API

من الحساب ← اتصالات API وMCP، اختر إنشاء رمز API. امنحه اسمًا واضحًا وحدد الصلاحيات التي تحتاج إليها فقط. يظهر الرمز مرة واحدة وتنتهي صلاحيته بعد 90 يومًا.

احتفظ بالرمز في مخزن الأسرار لتطبيقك. أرسله في ترويسة Authorization: Bearer. لا تضعه في رابط أو ملفات موقع عامة أو لقطة شاشة أو رسالة دعم أو ملف مصدر مشترك. يفترض المثال أدناه أن KUNKAFA_TOKEN مضبوط مسبقًا بصورة آمنة.

curl --fail-with-body \
  --header "Authorization: Bearer ${KUNKAFA_TOKEN}" \
  "https://kunkafa.com/api/v1/usage?locale=en"
الصلاحيات والاكتشاف

صلاحيات القراءة هي markets:read وoutlooks:read وperformance:read وresults:read وusage:read. يجب أن يتضمن الرمز صلاحية العملية المطلوبة. ولا توسّع صلاحيات الرمز وصول حسابك إلى الأسواق أو الخطط.

قوائم الأسواق والاستخدام مقسمة إلى صفحات. تابع page.nextCursor حتى تصبح قيمته null؛ لا تفترض أن الصفحة الأولى تتضمن كل الأسواق المسموح بها. الحجم الافتراضي للصفحة 20 والحد الأقصى 50. ابدأ دون مؤشر صفحة إذا تغير الوصول أو أسماء الأسواق.

تفاصيل عميل OAuth

استخدم تدفق رمز التفويض مع PKCE والمورد https://kunkafa.com/mcp. يبدأ الاكتشاف من https://kunkafa.com/.well-known/oauth-protected-resource/mcp؛ وجهة إصدار التفويض هي https://kunkafa.com/oauth. استخدم نقاط الاتصال التي يعيدها الاكتشاف وتحقق من جهة الإصدار والمورد والجمهور.

تنتهي صلاحية رموز الوصول بعد 10 دقائق. تتجدد رموز التحديث مع كل استخدام، وتنتهي بعد 30 يومًا دون استخدام أو 90 يومًا إجمالًا، وتؤدي إعادة استخدام رمز قديم إلى إبطال تفويض الاتصال. تحديث الرمز لا يستحوذ على جلسة نشطة.

نقاط اتصال API الرسمية

يتطلب REST رمز Pro API. استخدم GET للاكتشاف والاستخدام والسجل المنشور؛ واستخدم POST مع محتوى JSON يتضمن markets وlocale للملخصات. استبدل {slug} بقيمة market التي يعيدها الاكتشاف.

GET  https://kunkafa.com/api/v1/markets
POST https://kunkafa.com/api/v1/outlooks
GET  https://kunkafa.com/api/v1/markets/{slug}/performance
GET  https://kunkafa.com/api/v1/markets/{slug}/results
GET  https://kunkafa.com/api/v1/usage
أدوات MCP
list_markets

الأسواق المتاحة

اعرض الأسواق التي يمكن لهذا الاتصال قراءتها. تابع page.nextCursor حتى تصبح قيمته null للوصول إلى جميع الأسواق المسموح بها؛ تُحفظ الأسماء كاملة. يتضمن MCP المجاني السوق الذي اختاره الحساب فقط.

get_outlooks

ملخصات كنكافا

اقرأ الاتجاهين عبر ما يصل إلى ثلاث مدد منشورة. تجعل قراءة الملخصات الخاصة هذا الاتصال الجلسة النشطة. تحقق من الاستخدام وأوقات إعادة المحاولة المعادة؛ لا تكرر الطلب عند نفاد الحد المسموح.

get_performance

الأداء التاريخي

اقرأ الأداء المنشور وأعداد العينات لسوق مسموح به. الأداء التاريخي منفصل عن ثقة كنكافا.

get_results

النتائج السابقة

اقرأ ما يصل إلى عشر نتائج منشورة لسوق مسموح به. النتائج المختارة ليست التاريخ الكامل ولا ادعاءً بأداء إجمالي.

get_usage

الاستخدام والحدود

تحقق من الحدود المتبقية للطلبات والتزامن والملخصات خلال الفترات المتحركة. قائمة الأسواق المسموح بها مقسمة إلى صفحات؛ تابع page.nextCursor حتى تصبح قيمته null. لا يستهلك هذا حد الملخصات ولا يستحوذ على الجلسة النشطة.

أدوات التسجيل والخطط

تعرض get_plans الخطط وروابط الأسعار الحالية. وتوفر get_account_links روابط المتصفح للتسجيل وتسجيل الدخول والاشتراك وإدارة الحساب. لا تتطلب هاتان الأداتان حسابًا.

افتح حسابك