اتصل بكُنكافا

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

تتوفر MCP مع Free وStarter وCore وPro وPublisher. تستخدم الأسواق المتاحة لحسابك ورصيده المشترك. تتيح Free وStarter وCore اتصالًا واحدًا لكل حساب، وتتيح Pro خمسة اتصالات وPublisher عشرين. تشترك اتصالات MCP ورموز API الشخصية في هذا الحد. إضافة اتصال لا تمنحك رصيد ملخصات إضافيًا.

تتوفر REST API مع Pro وPublisher. يقرأ كل طلب احتمالات سوقًا واحدًا، بحد أقصى 6 مدد و72 احتمالًا، ويمكن تشغيل طلبات الاتصال الواحد في الوقت نفسه. تتابع Pro عشرة أسواق، وتشمل Publisher كل الأسواق. تتوفر جميع المدد المنشورة.

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

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

curl --fail-with-body \
  --header "Authorization: Bearer ${KUNKAFA_TOKEN}" \
  "https://kunkafa.com/api/v1/usage"

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

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

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

تنتهي صلاحية رموز الوصول بعد 10 دقائق. تتجدد رموز التحديث مع كل استخدام، وتؤدي إعادة استخدام رمز قديم إلى إبطال تفويض الاتصال. يبقى اتصال MCP متاحًا ما دام مستخدمًا: ينتهي بعد 90 يومًا دون استخدام، وبعد سنة من الموافقة كحد أقصى. الموافقة على التطبيق نفسه مجددًا تستبدل اتصاله دون استخدام اتصال آخر، وإذا طلب صلاحيات سبقت الموافقة عليها فقط، يوافق كُنكافا دون شاشة ثانية. الاتصال الذي ينقصه صلاحية تحتاجها أداة يتلقى طلب insufficient_scope ليتمكن التطبيق من طلبها منك. تعلن كل أداة صلاحيتها في securitySchemes، ويعرض get_usage صلاحيات الاتصال وموعد انتهائه. تحديث الرمز لا يغيّر جلسة الاتصال النشطة.

يتطلب REST رمز API من حساب Pro أو Publisher. استخدم GET للاكتشاف والاستخدام والسجل المنشور؛ واستخدم POST مع محتوى JSON يتضمن market وdurations (أو minDuration وmaxDuration) للاحتمالات الحالية؛ واستخدم POST /api/v1/following وDELETE /api/v1/following/{slug} للمتابعة وإلغائها (following:write). لا تحتاج الخطط وروابط الحساب إلى رمز. استبدل {slug} بقيمة market التي يعيدها الاكتشاف. الردود باللغة الإنجليزية.

GET  https://kunkafa.com/api/v1/glossary
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
POST https://kunkafa.com/api/v1/following
DELETE https://kunkafa.com/api/v1/following/{slug}
GET  https://kunkafa.com/api/v1/plans
GET  https://kunkafa.com/api/v1/account-links

get_glossary

المصطلحات

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

list_markets

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

الأسواق التي يمكن لهذا الحساب قراءتها، مع المدد التي لها احتمالات الآن في كل سوق، وما يتابعه الحساب. تنقّل بين الصفحات باستخدام page.nextCursor.

follow_market

متابعة سوق

تابع سوقًا لهذا الحساب. تحقق أولًا من canFollow في get_usage. استبدال سوق متابع مسموح مرة كل 30 يومًا: اسأل المستخدم، ثم أعد الطلب مع confirmReplacement بقيمة true.

unfollow_market

إلغاء متابعة سوق

أوقف متابعة سوق؛ تتوقف إمكانية قراءة بياناته. تحقق أولًا من canFollow في get_usage.

get_outlooks

الاحتمالات الحالية

الاحتمالات الحالية لسوق واحد؛ سوق واحد في كل طلب عن قصد، حتى لا تُسحب البيانات بالجملة. اختر المدد (محددة أو نطاقًا)، ويمكن التضييق بالاتجاه أو بالثقة أو بمسافة الهدف. 6 مدد و72 احتمالًا كحد أقصى لكل طلب، ويمكن تشغيل الطلبات في الوقت نفسه.

get_performance

الأداء السابق

كم مرة لمست الاحتمالات السابقة هدفها، حسب مستوى الثقة والفترة. أرسل probabilityPercent للحصول على الصف المطابق (headline).

get_results

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

أمثلة حديثة لاحتمالات مع نتائجها؛ ليست سجلًا كاملًا.

get_usage

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

الحدود المتبقية، وما يعيده طلب get_outlooks واحد، وصلاحيات هذا الاتصال وcanFollow وموعد انتهائه. لا يستهلك أي رصيد.

كل أداة تحدد شكل ردّها، وهو نفسه في مرجع REST API.

توفر get_account_links روابط كُنكافا الرسمية لإنشاء الحساب وتسجيل الدخول وإدارة الحساب، ولا تتطلب حسابًا. لمزيد من المعلومات، زر kunkafa.com.