API للمطورين

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

أضف سهمك من دليل إضافات ChatGPT أو دليل Claude، أو اربط Claude Code عبر الإنترنت، أو Claude Desktop وCursor على جهازك. في كل حالة يُستخدم اشتراكك الحالي وصلاحياتك وحدّ طلباتك اليومي.

MCPChatGPTAIPythonمبتدئ8 دقائق للقراءة

1. ما هو MCP؟

MCP (Model Context Protocol) هو معيار مفتوح يتيح لمساعد الذكاء الاصطناعي استدعاء أدوات خارجية. يوفّر خادم سهمك MCP لمساعدك هذه الأدوات للتعامل مع بيانات تداول:

الأداةالغرض
get_quoteسعر شركة واحدة وتفاصيل تغيّره
get_quotesمقارنة أسعار عدة شركات في طلب واحد
companies_listالبحث عن الرموز بالاسم أو الرمز عبر search, market, limit، وoffset
get_market_summaryملخص أداء المؤشر اليوم
get_market_moversأعلى الرابحين أو الخاسرين أو الأكثر نشاطاً، مع حقول ثابتة type, index, count، وitems
get_sectorsأداء القطاعات مع حقول ثابتة index, count، وitems
get_companyملف الشركة وأبرز بياناتها الأساسية
get_historicalالأسعار التاريخية بنمط OHLCV (1d, 1w, 1m, 30m, 60m؛ وتسري عليها حدود الباقة والنطاق الزمني)
get_financialsالقوائم المالية للشركة ومؤشراتها
get_dividendsعرض سجل التوزيعات وتفاصيل الدفعات

ملاحظة: get_financials و get_dividends تتطلبان عادةً باقة Starter أو أعلى.

اشتراكك واحد في كل الحالات

سواء أضفت سهمك إلى ChatGPT أو Claude.ai، أو ثبّت الخادم على جهازك لـClaude Desktop وCursor، يُستخدم حساب المطوّر نفسه في سهمك، مع الحد اليومي نفسه وصلاحيات باقتك الحالية.

  • الباقة: الباقة المجانية أو Starter أو Pro أو Business أو Enterprise التي لديك الآن.
  • الصلاحيات: ما تسمح به باقتك ومفتاح API. البيانات اللحظية تتوفر فقط إذا كانت باقتك تشملها.
  • حد الطلبات: كل استدعاء لأداة يُحسب من طلباتك اليومية في سهمك.

2. ربط سهمك بـChatGPT

سهمك مدرج في دليل إضافات ChatGPT. أضفه من الصفحة العامة.

يلزمك حساب مطوّر في سهمك ومفتاح API. أنشئ حساباً، أو افتح مفاتيح API إن كان لديك حساب.

أضف سهمك إلى ChatGPT
  1. افتح صفحة سهمك في دليل إضافات ChatGPT.
  2. أضف سهمك أو اربطه.
  3. سجّل الدخول إلى سهمك.
  4. اختر مفتاح API ثم اسمح بالوصول. تمر الطلبات عبر هذا المفتاح وباقتك الحالية.
  5. ابدأ محادثة واختر @SAHMK.

مثال:

ما سعر سهم أرامكو الآن، وما حجم التداول وأفضل سعري طلب وعرض؟

3. ربط سهمك بـClaude

سهمك مدرج في دليل Claude. أضفه من الصفحة العامة.

يلزمك حساب مطوّر في سهمك ومفتاح API. أنشئ حساباً، أو افتح مفاتيح API إن كان لديك حساب.

أضف سهمك إلى Claude
  1. افتح صفحة سهمك في دليل Claude.
  2. سجّل الدخول إلى Claude ثم أضف سهمك.
  3. سجّل الدخول إلى سهمك.
  4. اختر مفتاح API ثم اسمح بالوصول. تمر الطلبات عبر هذا المفتاح وباقتك الحالية.
  5. في المحادثة، يستخدم Claude أدوات سهمك تلقائياً عند الحاجة.

مثال:

ما سعر سهم أرامكو الآن، وما حجم التداول وأفضل سعري طلب وعرض؟

4. التثبيت على جهازك لـClaude Desktop وCursor

في Claude Desktop وCursor يعمل خادم سهمك MCP على جهازك عبر الحزمة الرسمية من PyPI. وهنا أيضاً يُستخدم مفتاح API واشتراكك الحالي، وكل استدعاء لأداة يُحسب من حدّك اليومي نفسه.

PyPI version

احصل على مفتاح API

تحتاج إلى مفتاح API من سهمك. احصل على مفتاحك المجاني عبر التسجيل هنا.

يبدأ المفتاح عادةً بـ shmk_live_ أو shmk_test_.

التثبيت

ثبّت خادم MCP من PyPI:

bash
pip install -U sahmk-mcp

إذا رفضت الأدوات معاملات أحدث، حدّث الحزمة عبر pip install -U sahmk-mcp ثم أعد تشغيل التطبيق.

تأكد من نجاح التثبيت:

bash
sahmk-mcp --help

الربط مع Claude Desktop

أضف هذا الإعداد إلى ملف Claude Desktop.

على macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
على Windows: %APPDATA%\Claude\claude_desktop_config.json

claude_desktop_config.json
{
  "mcpServers": {
    "sahmk": {
      "command": "sahmk-mcp",
      "env": {
        "SAHMK_API_KEY": "your_api_key_here"
      }
    }
  }
}

أعد تشغيل Claude Desktop. ستظهر أدوات سهمك في قائمة الأدوات.

الربط مع Cursor

أضف هذا الإعداد إلى ملف مشروعك .cursor/mcp.json:

.cursor/mcp.json
{
  "mcpServers": {
    "sahmk": {
      "command": "sahmk-mcp",
      "env": {
        "SAHMK_API_KEY": "your_api_key_here"
      }
    }
  }
}

أعد تشغيل Cursor. ستصبح أدوات سهمك متاحة لمساعد المحرّر.

5. جرّبه بنفسك

بعد إتمام الربط في ChatGPT أو Claude أو Cursor، اسأل بالعربية أو الإنجليزية. الأدوات والحدود واحدة لأن كل الحالات تستخدم اشتراك سهمك نفسه.

أدوات الأسعار تقبل الرمز، أو اسم الشركة بالعربية أو الإنجليزية، أو الاسم البديل. وإذا طابق الاسم أكثر من شركة، اطلب إعادة المحاولة بالرمز الدقيق.

للبحث عن الشركة أولاً استخدم companies_list (وتدعم search, market, limit، وoffset).

مثال على السؤال

ما سعر سهم أرامكو الآن، وما حجم التداول وأفضل سعري طلب وعرض؟

يسأل عن سعر أرامكو وحجم التداول وأفضل سعري طلب وعرض.

مثال على السؤال

prompt
كيف حال السوق السعودي اليوم؟

يستدعي get_market_summary.

مثال على السؤال

prompt
اعرض أعلى الرابحين في تاسي

يستدعي get_market_movers.

مثال على السؤال

prompt
اعرض أداء القطاعات في تاسي

يستدعي get_sectors.

مثال على السؤال

prompt
اعرض القوائم المالية لأرامكو

يستدعي get_financials.

مثال على السؤال

prompt
اعرض توزيعات أرامكو

يستدعي get_dividends.

مثال على السؤال

prompt
قارن أرامكو ومصرف الراجحي

يستدعي get_quotes.

مثال على السؤال

prompt
اعرض تاريخ سعر أرامكو لآخر ثلاثة أشهر

يستدعي get_historical.

قد تتطلب أداتا get_financials وget_dividends باقة Starter أو أعلى.

6. الباقات المتاحة

هذه الحدود تنطبق على أدوات MCP في ChatGPT وعلى التثبيت المحلي معاً.

الباقةالسعرالطلبات/اليوم
مجاني0 SAR100
Starter149 SAR/mo5,000
Pro499 SAR/mo50,000
Business1,499 SAR/mo150,000
Enterpriseتواصل معنامخصص حسب الاتفاق

الباقة المجانية تمنحك 100 طلب يومياً، وهذا يكفي للتجربة والبدء.

7. الخطوات التالية

اجعل مساعدك يصل إلى بيانات تداول

أضف سهمك من دليل إضافات ChatGPT أو دليل Claude، أو ثبّت الخادم على جهازك لـClaude Desktop وCursor. 100 طلب مجاني يومياً، ومن دون بطاقة ائتمان.

المصادر

نشر بواسطة @sahmk_sa · مرخّص من تداول السعودية