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

استخدم Narwhal مع أدوات Gemini لـ Gemini بيانات اقتصادية

يمكن لـ Antigravity CLI الاتصال بـ Narwhal عبر Streamable HTTP مع ترويسة Authorization من نوع Bearer. انتقل المستخدمون الأفراد من Gemini CLI إلى Antigravity CLI، وأمره هو agy. ويمكن لـ Gemini CLI أيضاً الاتصال حيث يظل متاحاً، باستخدام صيغة الإعداد الخاصة به.

بداية سريعة

  1. احصل على مفتاح Narwhal مجاني من https://narwhalapi.com/signup ولا تضعه في الرسائل أو في عناوين URL.
  2. في Antigravity CLI، افتح ~/.gemini/config/mcp_config.json أو ملف مساحة العمل .agents/mcp_config.json.
  3. أضف الإدخال البعيد مع serverUrl وترويسة Authorization من نوع Bearer، ثم أبقِ الملف خاصاً.
  4. تحقق من اتصال Antigravity بالأمر /mcp.
  5. حيثما يتوفر Gemini CLI، شغّل أمر الإضافة فيه مع -s user لإبقاء المفتاح في إعدادات المستخدم.

إعداد MCP

يستخدم Antigravity CLI الحقل serverUrl لـ Streamable HTTP وكائن headers. أما أمر الإضافة في Gemini CLI فيستخدم -s user ونقل HTTP وترويسة Authorization من نوع Bearer.

~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "narwhal": {
      "serverUrl": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_NARWHAL_API_KEY"
      }
    }
  }
}
Gemini CLI
gemini mcp add -s user --transport http \ --header "Authorization: Bearer YOUR_NARWHAL_API_KEY" \ narwhal https://api.narwhalapi.com/mcp

لا يصف توثيق Antigravity CLI توسيع متغيرات البيئة داخل الترويسات، لذا يخزّن ملف إعداده قيمة المفتاح. أبقِ الملف خاصاً وخارج نظام التحكم في الإصدارات، سواء كان في إعدادات المستخدم أو في مساحة العمل.

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

يحصل أي من الـ CLI المدعومين على كل هذه المجموعات للقراءة فقط عبر اتصال 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

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

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

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

أعدّ إحاطة عن التضخم في اليابان

التضخم الياباني متاح عبر economics_get_inflation في أي من واجهتي CLI. اختر اليابان للحصول على أحدث تغيرات النسب المبلَّغ عنها.

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

افحص USD/IDR بالأداة fx_get_rates، مع USD عملة أساس وIDR عملة تسعير، للحصول على السعر الإرشادي الحالي.

راجع أسعار السلع لتحليلك

تقبل commodities_get_spot_price النحاس وعملة التسعير. النتيجة هي السعر الفوري الإرشادي الحالي.

اعرف توقيت الإصدار التالي للرقم القياسي لأسعار المستهلك

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

نصائح

  • استخدم serverUrl في Antigravity CLI. الحقل httpUrl ونقل SSE القديم غير مدعومين هناك.
  • في Gemini CLI، يُبقي -s user المفتاح في ~/.gemini/settings.json، بينما يكتبه النطاق الافتراضي للمشروع في .gemini/settings.json داخل المستودع.
  • تستخدم إعدادات Gemini CLI إدخالاً ضمن mcpServers فيه httpUrl وheaders.

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

هل ما زال بإمكان مستخدمي Gemini الأفراد استخدام Gemini CLI؟

انتقل المستخدمون الأفراد من Gemini CLI إلى Antigravity CLI، وأمره هو agy. لـ Gemini CLI صيغة إعداد منفصلة حيث يظل متاحاً.

أي حقل عنوان يستخدمه Antigravity CLI مع Narwhal؟

يستخدم Antigravity CLI الحقل serverUrl مع نقطة Streamable HTTP على https://api.narwhalapi.com/mcp. أضف ترويسة Authorization من نوع Bearer في headers وتحقق من الاتصال بالأمر /mcp.

هل يستطيع Antigravity قراءة المفتاح من مرجع في متغير بيئة؟

لا يصف التوثيق توسيع متغيرات البيئة داخل الترويسات، لذا يخزّن الملف قيمة المفتاح. أبقِ ملف إعداد المستخدم أو مساحة العمل خاصاً وخارج نظام التحكم في الإصدارات.

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

العَرَضتحقّق
لا يظهر Narwhal في Antigravity CLIافحص إدخال mcp_config.json للمستخدم أو لمساحة العمل، وتأكد من أنه يستخدم serverUrl، ثم افحص /mcp.
يعيد الخادم الخطأ 401 invalid_api_keyتأكد من أن الترويسة تحوي Bearer تليها مسافة ثم مفتاحاً نشطاً، وليس مرجعاً غير موسَّع لمتغير بيئة.
يفشل اتصال Antigravity الذي يستخدم httpUrlغيّر الإدخال البعيد إلى serverUrl وStreamable HTTP. لا يدعم Antigravity الحقل httpUrl ولا نقل SSE القديم.
لم يعد Gemini CLI يخدم فئة الحساباستخدم Antigravity CLI للحسابات الفردية واتبع صيغة إعداده بدلاً من صيغة إعدادات Gemini CLI.

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