تصفّح التوثيق كاملًا

أدخل Cursor بيانات اقتصادية

يمكن لـ Cursor استدعاء Narwhal عبر خادم MCP بعيد، بمفتاح API ورصيد واحدين مشتركين بين REST وMCP. خزّن المفتاح في بيئتك قبل تشغيل Cursor، ثم اطلب البيانات الاقتصادية أثناء عملك. يتضمن الاتصال نفسه أسعار العملات وبيانات السلع ومجموعات الأدوات المباشرة الأخرى.

بداية سريعة

  1. احصل على مفتاحك المجاني من https://narwhalapi.com/signup.
  2. عيّن NARWHAL_API_KEY في ملف تعريف الصدفة أو بيئة النظام قبل تشغيل Cursor.
  3. أضف إعداد الخادم البعيد إلى .cursor/mcp.json لهذا المشروع أو إلى ~/.cursor/mcp.json لجميع المشاريع.
  4. فعّل Narwhal ضمن Customize في الشريط الجانبي وافحص Available Tools.

إعداد MCP

يستخدم الإدخال البعيد url وheaders، مع ${env:NARWHAL_API_KEY} في ترويسة Authorization. يقرأ Cursor هذا المرجع من بيئته، ولا تدعم خوادم MCP البعيدة envFile.

.cursor/mcp.json
{
  "mcpServers": {
    "narwhal": {
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NARWHAL_API_KEY}"
      }
    }
  }
}

أبقِ الإعداد في ملف المشروع أو ملف المستخدم بحسب النطاق الذي تحتاجه. بعد تغيير بيئة النظام أو الصدفة، أعد تشغيل Cursor ليحصل على المفتاح قبل الاتصال.

الأدوات المتاحة لك

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

المجموعةما يمكنك طلبهالأدوات
المؤشرات الاقتصاديةاطلب مؤشر أسعار المستهلك (CPI) والتضخم والبطالة والمشاركة في سوق العمل والناتج المحلي الإجمالي (GDP) ونموه والتجارة لكل دولة؛ وتختلف التغطية من مؤشر إلى آخر.economics_get_cpi economics_get_inflation economics_get_unemployment economics_get_labour_force_participation economics_get_gdp economics_get_gdp_growth economics_get_trade economics_get_cpi_history economics_get_inflation_history economics_get_unemployment_history economics_get_labour_force_participation_history economics_get_gdp_history economics_get_gdp_growth_history economics_get_trade_history economics_read_series_observations economics_search_catalogue economics_read_catalogue_series economics_read_catalogue_observations economics_read_catalogue_latest_batch economics_get_policy_rate economics_get_policy_rate_history economics_get_central_bank_reserves economics_get_central_bank_balance_sheet
أسعار العملاتاطلب أسعار الصرف الحالية والتاريخية وتحويلات العملات وشموع الأسعار لزوج عملات.fx_get_rates fx_get_rate_history fx_convert_currency fx_get_rate_bars
أسعار السلعاطلب الأسعار الفورية للذهب والفضة والبلاتين والبلاديوم والنحاس ونفط خام غرب تكساس الوسيط ونفط خام برنت، وسجل أسعارها، وأسعار زيت النخيل الفعلي (زيت النخيل الخام وعناقيد الثمار الطازجة).commodities_get_spot_price commodities_get_price_history commodities_list_palmoil_physical_series commodities_get_palmoil_physical_price commodities_get_palmoil_physical_observations commodities_list_physical_series commodities_get_physical_series commodities_get_physical_latest commodities_get_physical_observations
الإصدارات والأحداثاطلب مواعيد الإصدارات الاقتصادية الرسمية وتفاصيل الأحداث قبل إعداد موجز عن دولة ما.economics_list_releases economics_get_release events_list events_get
الإجازات الرسميةاطلب العطل الرسمية بحسب الدولة، أو العطل في تاريخ معين، أو العطلة القادمة.calendars_list_holidays calendars_get_holidays_on_date calendars_get_next_holiday
احتمالات أسواق التنبؤاطلب مواضيع أسواق التنبؤ وأحداثها ذات النتائج الرقمية والقصوى والزمنية والثنائية، وسجلها التاريخي، ومسارات السياسة النقدية بحسب الجهة المسؤولة.predictions_list_topics predictions_get_topic predictions_list_events predictions_get_scalar predictions_get_extreme predictions_get_timing predictions_get_binary predictions_get_scalar_history predictions_get_extreme_history predictions_get_timing_history predictions_get_binary_history predictions_get_policy_path predictions_get_policy_path_history
عوائد السندات الحكوميةاطلب منحنيات عائد السندات الحكومية للولايات المتحدة والمملكة المتحدة وألمانيا واليابان وكندا والسويد والنرويج وأستراليا ومنطقة اليورو عبر اتصال Narwhal نفسه.economics_get_yield_curve economics_get_yield_curve_history

أمثلة على الطلبات

  • احصل على أحدث قيمة للبطالة في كندا.
  • اعرض سعر صرف GBP/USD الحالي.
  • أعطني سجل أسعار زيت النخيل المتاح.
  • ابحث عن موعد الإصدار الرسمي القادم لمؤشر أسعار المستهلك (CPI) في الولايات المتحدة.
  • اذكر العطل الرسمية في اليابان للسنة الحالية.

سيناريوهات شائعة

تتبع البطالة الكندية حسب الفترة

اطلب من Cursor ملاحظات البطالة في كندا باستخدام economics_get_unemployment_history ضمن مجموعة الاقتصاد. يسرد السجل الملاحظات حسب الفترة.

افحص السعر قبل التحويل

هل سعر GBP/USD الحالي هو ما تحتاجه؟ استدعِ fx_get_rates مع GBP عملة أساس وUSD عملة تسعير.

افحص تاريخ زيت النخيل في Cursor

اطلب من Cursor إيجاد سلسلة زيت النخيل باستخدام commodities_list_palmoil_physical_series، ثم اقرأ ملاحظات فتراتها بالأداة commodities_get_palmoil_physical_observations مع معرّف السلسلة المختارة.

خطط لإحاطة حول مواعيد الإصدارات

خطط للإحاطة بالأداة economics_list_releases: اختر الولايات المتحدة ونافذة لا تتجاوز 366 يوماً. تتضمن الإدخالات مواعيد الإصدار المجدولة وأوقاتها.

نصائح

  • اطلب أداة بالاسم عندما تريد أن يستخدم Cursor عملية معينة، أو صف البيانات التي تحتاجها وافحص Available Tools.
  • أبقِ المفتاح الفعلي خارج .cursor/mcp.json باستخدام مرجع متغير البيئة في الترويسة، حتى عندما يكون ملف المشروع مشتركاً.
  • افتح لوحة Output بالاختصار Cmd+Shift+U واختر MCP Logs عندما تحتاج إلى تفاصيل خطأ الاتصال.
  • استخدم Customize في الشريط الجانبي لتفعيل خادم Narwhal أو تعطيله أو إدارته مع تغير احتياجات مشروعك.

الأسئلة الشائعة

كيف أربط Cursor بـ Narwhal MCP؟

أضف إدخال خادم بعيد يحوي عنوان Narwhal وترويسة Authorization من نوع Bearer إلى إعداد MCP في Cursor. عيّن NARWHAL_API_KEY قبل تشغيل Cursor، ثم فعّل الخادم وافحص Available Tools.

هل يستطيع Cursor تحميل مفتاحي من envFile؟

لا، لا تدعم الخوادم البعيدة في Cursor الخيار envFile. عيّن المتغير في ملف تعريف الصدفة أو بيئة النظام وأشر إليه بالصيغة ${env:NARWHAL_API_KEY} في الترويسة.

كم تكلّف مكالمة Narwhal في Cursor؟

يُحتسب كل استدعاء أداة ناجح استدعاءً واحداً، والاكتشاف مجاني. يحصل كل حساب على رصيد مجاني قدره $10 كل شهر خلال أول 12 شهراً، مع حد قصير المدى قدره 50 طلباً في الدقيقة.

استكشاف الأخطاء وإصلاحها

العَرَضتحقّق
لا يظهر Narwhal ضمن Available Toolsافحص .cursor/mcp.json الخاص بالمشروع أو بالمستخدم، ثم فعّل الخادم ضمن Customize في الشريط الجانبي.
يعيد الاتصال الخطأ 401 invalid_api_keyتأكد من أن NARWHAL_API_KEY يحوي مفتاحاً نشطاً في البيئة التي تشغّل Cursor، ثم أعد تشغيل Cursor.
لا يستطيع الخادم البعيد قراءة envFileانقل المتغير إلى ملف تعريف الصدفة أو بيئة النظام واستخدم ${env:NARWHAL_API_KEY} في ترويسة Authorization.
يفشل الاتصال بعد تعديل العنواناستخدم https://api.narwhalapi.com/mcp تماماً دون شرطة مائلة في النهاية، ثم افحص MCP Logs في لوحة Output.

هل كانت هذه الصفحة مفيدة؟