دليل الاتصال · الإصدار 1.1.0
اربط حسابك ليقرأ مساعدك الأخبار المنشورة والتقويم الاقتصادي المخزّن لدى EL7. كل إجابة تتضمن تاريخ مصدر البيانات وحدود التغطية، حتى تعرف ما الذي تستند إليه.
https://mcp.el7.ai/mcpاختُبر الاتصال فعليًا من Claude (claude.ai) وChatGPT وClaude Code. يعمل Cursor وVS Code بالإعدادات العامة نفسها.
Gemini Enterprise (Google Workspace / Google Cloud): افتح إعدادات MCP، ثم تبويب Gemini Enterprise، واضغط «إنشاء بيانات اعتماد Gemini». ينسخ مسؤول Gemini Enterprise القيم المعروضة إلى Google Cloud: Gemini Enterprise ← Data stores ← Create data store ← Custom MCP Server ← OAuth 2.0، مع تفعيل PKCE وإضافة resource=https://mcp.el7.ai/mcp في Authorization URL Parameters.
Gemini CLI وAntigravity: أضف العنوان أعلاه في إعدادات MCP (الحقل httpUrl في Gemini CLI وserverUrl في Antigravity) ثم سجّل الدخول عند الطلب. لا يدعم تطبيق Gemini الشخصي خوادم MCP المخصصة حتى الآن.
أمر الإضافة الموثّق لدى Claude Code. بعده افتح /mcp داخل البرنامج واتبع طلب المصادقة إن ظهر.
claude mcp add --transport http el7 https://mcp.el7.ai/mcp
أنشئ مفتاحًا من إعدادات MCP واختر انتهاءه بعد 30 أو 90 أو 365 يومًا. تظهر قيمة المفتاح مرة واحدة فقط. ضعها في مخزن أسرار التطبيق في ترويسة Authorization: Bearer <key>، ولا ترسلها في محادثة أو رابط. الحد خمسة مفاتيح نشطة غير منتهية. عند الاستبدال، يُلغى المفتاح القديم بعد نجاح حفظ البديل.
أحدث الأخبار، البحث، تفاصيل خبر، التقارير، تطور قصة مستمرة، ونبض المعنويات المتاح.
أحداث نافذة زمنية، تفاصيل إصدار، وصف مؤشر، تاريخه، المفاجآت الاقتصادية، وملف دولة.
| المجال | ما تقدمه | الأدوات |
|---|---|---|
| الحساب | خطتك ورصيدك المتبقي | el7_whoami |
| الأخبار | أحدث الأخبار، البحث، تفاصيل خبر، التقارير، القصص المستمرة ونبض المعنويات | el7_news_latest، el7_news_search، el7_news_story، el7_news_reports، el7_news_storylines، el7_news_pulse |
| التقويم الاقتصادي | الأحداث، تفاصيل إصدار، وصف مؤشر وتاريخه، المفاجآت الاقتصادية وملف دولة | el7_calendar_events، el7_calendar_event، el7_calendar_indicator، el7_calendar_history، el7_calendar_surprise، el7_calendar_country |
| البنوك المركزية | الفيدرالي، المركزي الأوروبي، بنك إنجلترا، بنك اليابان، بنك كندا، الاحتياطي الأسترالي والنيوزيلندي والسويسري: القرارات، البيانات والمحاضر والمؤتمرات والخطابات، مقارنة البيانات، ترتيب النبرة، المعاينات، الإسقاطات، الكتاب البيج والميزانيات | el7_cb_overview، el7_cb_decisions، el7_cb_documents، el7_cb_document، el7_cb_press_conference_qa، el7_cb_statement_diff، el7_cb_tone_ranking، el7_cb_previews، el7_cb_sep، el7_cb_beige_book، el7_cb_balance_sheet |
| الشخصيات | صنّاع السياسة النقدية: الملفات، الخطابات، الأصوات ومقياس التشدد والتيسير | el7_people_search، el7_person، el7_people_cb_members |
| مراكز COT | العقود ومؤشر COT، مراكز المتداولين وتاريخها، التقرير الأسبوعي، بنية السوق (تركّز المراكز وعدد المتداولين وجانب الخيارات ومشاركة البنوك وجودة الإشارة)، وتحليلات EL7 المكتوبة لكل سوق وللأسبوع | el7_cot_markets، el7_cot_positioning، el7_cot_weekly، el7_cot_market_detail، el7_cot_analysis |
| النفط والطاقة | مخزونات EIA، الإنتاج، توقعات IEA وEIA وأوبك، وبيانات أوبك | el7_oil_inventories، el7_oil_supply، el7_oil_outlook، el7_oil_opec، el7_oil_country_stats |
| الذهب | مؤشر ظروف الذهب، تدفقات الصناديق وكومكس والخزائن، احتياطيات البنوك المركزية، العرض والطلب والعوامل الكلية | el7_gold_overview، el7_gold_flows، el7_gold_reserves، el7_gold_supply_demand، el7_gold_macro |
| الأبحاث والمحتوى | أبحاث EL7، المقالات التحليلية والمقابلات بنصها الكامل | el7_research_list، el7_research_article، el7_insights_list، el7_insight، el7_interviews_list، el7_interview |
| صفقات المطلعين والكونغرس | صفقات المطلعين في الشركات وإفصاحات أعضاء الكونغرس | el7_insider_trades، el7_insider، el7_congress_trades، el7_congress_member |
| أسواق التوقعات | احتمالات الأسواق المتاحة وتفاصيل كل سوق | el7_predictions_markets، el7_prediction |
| الاستراتيجيات | مكتبة الاستراتيجيات، تفاصيل كل استراتيجية والسلال | el7_strategies_list، el7_strategy، el7_strategy_baskets، el7_strategy_basket |
| الأسواق | نظام التذبذب والاتساع، الموسمية، الارتباطات، رد فعل الأصول على الإصدارات ودورات الفائدة (نسب مئوية فقط)، وآخر موجز منشور من EL7 لكل فئة أصول: الأسهم الأمريكية والسعودية والمؤشرات والعملات والسلع والعملات المشفرة | el7_market_regime، el7_market_seasonality، el7_market_correlations، el7_event_reaction، el7_market_cycle، el7_market_brief |
| الأسهم والصناديق | تقييمات EL7 للعوامل، ترتيب الأسهم الأمريكية والسعودية حسب تقييم EL7، أكبر تغيّرات التقييم، تاريخ تقييم السهم، تحليل EL7 المكتوب لكل سهم، القطاعات، الفلاتر الجاهزة، تدفقات الصناديق وسجل شركات التحليل | el7_stock_profile، el7_stock_rank، el7_score_movers، el7_stock_score_history، el7_stock_analysis، el7_sector_overview، el7_screener_presets، el7_screener_run، el7_etf_flows، el7_etf_profile، el7_analyst_firms، el7_analyst_consensus |
| أرباح الشركات | تقويم الأرباح، سجل النتائج السابقة (التفوق أو الإخفاق مقارنة بالتوقعات بالنسب المئوية، وحركة السهم بعد الإعلان)، موجزات EL7 قبل النتائج وبعدها وملخص مكالمة الأرباح، وحصيلة موسم الأرباح الأمريكي حسب القطاع | el7_earnings_calendar، el7_earnings_history، el7_earnings_brief، el7_earnings_season |
| البحث الذكي (للأعضاء المشتركين) | بحث دلالي في أرشيف EL7 من الأخبار ووثائق البنوك المركزية ومراكز COT وأسواق التوقعات | el7_ai_search |
كل ما في موقع EL7 متاح عبر MCP. البيانات تُقرأ من سجلات EL7 وتحليلاتها؛ لا تقدّم الأدوات أسعارًا خامًا أو قوائم مالية من مزودي البيانات، بل أرقام EL7 المشتقة مثل النسب والأنظمة والتقييمات. البحث الدلالي يحوّل سؤالك إلى متجه لدى Google. القائمة الكاملة بمدخلات كل أداة ومخرجاتها في مرجع الأدوات (بالإنجليزية).
للأخبار والتقويم يمكنك طلب lang="ar" للنص العربي المخزّن. نقص الترجمة أو البيانات قد يظهر قيمة فارغة؛ لا ينبغي للمساعد اختراع البديل.
ملف الدولة يستخدم القيم المنشورة ويستبعد الأرقام المستقبلية، ويختار سعر الفائدة من مؤشرات الفائدة المعروفة؛ نتائج الاستطلاعات وعدد الأصوات ليست سعر فائدة. السعر غير المتاح يبقى فارغًا، بينما الصفر الحقيقي يبقى صفرًا. موجز الأخبار يعرض حتى 50 خبرًا مرئيًا من سجل الأخبار؛ اقرأ coverage لمعرفة النطاق ووجود المزيد. العدد التحريري المخزّن story_count قد يختلف عن عدد الأخبار المعروضة.
| الخطة | المكالمات الناجحة | التجدد | محاولات الأدوات / دقيقة |
|---|---|---|---|
| حساب مجاني | 150 | إجمالي دائم، لا يتجدد | 10 |
| عضو EL7 | 10,000 | شهريًا | 120 |
تبدأ الفترة الشهرية في أول الشهر الساعة 00:00 بتوقيت UTC. عند بلوغ السقف تُرفض المكالمات حتى التجدد أو تغيير الاستحقاق. الاستكشاف وأداة el7_whoami لا يستهلكان الرصيد. الطلبات المرفوضة أو الفاشلة لا تستهلكه، لكنها تخضع لحدود الحماية من كثرة الطلبات.
قد يستخدم المساعد أكثر من أداة للإجابة عن سؤال واحد؛ السؤال الواحد لا يساوي دائمًا مكالمة واحدة. تكرار مكالمة ناجحة يستهلك الرصيد عادةً. يستطيع العميل إرسال مفتاح إعادة محاولة اختياري ليعيد النتيجة نفسها لمدة خمس دقائق دون خصم ثانٍ.
خدمة MCP متاحة لأعضاء EL7 الحاليين ضمن اشتراكهم في الموقع دون أي رسوم إضافية، ويحصل الحساب المجاني على 150 مكالمة مرة واحدة لا تتجدد. لا تُباع اشتراكات MCP منفصلة، ولا يتغير شيء في فوترة اشتراكك.
التاريخ YYYY-MM-DD في نهاية نطاق الأخبار يشمل اليوم كاملًا بتوقيت UTC. نوافذ التقويم المسماة تستخدم المنطقة الزمنية التي تحددها. يُرفض النطاق الواسع الذي يتجاوز حد المصدر بدل إخفاء الاقتطاع.
أحدث الأخبار تستخدم آخر 24 ساعة افتراضيًا. تحتفظ صفحاتها بترتيب ثابت لمعرّفات الأخبار لمدة 15 دقيقة؛ التعديلات والأخبار الجديدة لا تغيّر هذا الترتيب، لكن النص يعكس أحدث محتوى متاح. الخبر المخفي أو المحذوف يُستبعد ويظهر عدده في withdrawn_count، لذلك قد تكون الصفحة فارغة مع وجود صفحات لاحقة. تابع حتى تصبح has_more=false. عند انتهاء snapshot_expires_at ابدأ طلبًا جديدًا. إذا تجاوزت النتائج 5000 خبر فاختر فترة أقصر أو مرشحات أدق؛ يُرفض الطلب دون خصم.
اتصال OAuth يطلب openid profile email offline_access. الاستحقاق يحدد البيانات المتاحة؛ الصلاحيات ليست إذنًا لكتابة بيانات السوق. يُستخدم offline_access لتجديد الاتصال دون إعادة تسجيل الدخول كل مرة.
تُحفظ معاملات المكالمات الناجحة مشفّرة في سجل الاستخدام لمدة 90 يومًا وفق إعداد التشغيل؛ معاملات الطلبات غير الصالحة أو المرفوضة أو الفاشلة لا تُحفظ. يرسل البحث الدلالي نص البحث إلى Google لحساب متجه، وقد يقرأ مساعدك النتائج داخل تطبيقه وفق سياسة ذلك التطبيق. تُحفظ نتائج إعادة المحاولة مشفّرة لمدة صلاحية خمس دقائق، وتُحذف ماديًا بالدورة اليومية أو عند إعادة استخدام مفتاح المحاولة نفسه من الهوية نفسها بعد انتهاء صلاحيته. انتهاء الصف لا يثبت وحده حذف نسخه الاحتياطية؛ لها سياسة تشغيل مستقلة.
من إعدادات MCP يمكنك إلغاء مفتاح أو فصل تطبيق. الفصل يلغي الموافقة ورموز التجديد، ويمنع الرموز السابقة من العودة بعد إعادة الاتصال. عند إعادة الربط فورًا، انتظر ثانية قبل طلب رمز جديد.
تحقق من استخدام العنوان الصحيح واكتمال الموافقة، أو صلاحية مفتاح API. رد 401 يتضمن رابط استكشاف جهة المصادقة.
عند 503 انتظر الوقت المحدد في Retry-After ثم أعد المحاولة. عطل مخزن الصلاحيات لا يستلزم إعادة التسجيل.
استخدم el7_whoami أو إعدادات الحساب لقراءة المتبقي وموعد التجدد. احترم مهلة الانتظار وخفّض التوازي. قد يرد حد حماية النقل بـ 429؛ رفض رصيد الأدوات يظهر كخطأ داخل البروتوكول.
تحقق من المرشحات ونوع المحددات، واختر نطاقًا أقصر. النتائج الفارغة قد تعني غياب البيانات. فشل جميع مسارات البحث يُعلن كخطأ، وليس نجاحًا فارغًا يُخصم من رصيدك.