استخدم Codex بيانات اقتصادية في بيئة عملك

Q: هل يستطيع Codex استخدام Narwhal بمفتاح API؟

نعم، عيّن bearer_token_env_var إلى NARWHAL_API_KEY في جدول خادم Narwhal. صدّر المفتاح الفعلي في البيئة التي تشغّل Codex، فيرسل Codex ترويسة Authorization من نوع Bearer.

يمكن لـ Codex طلب بيانات Narwhal عبر MCP، ويشترك سطر الأوامر وامتداد IDE وتطبيق سطح المكتب في إعداد واحد. عيّن متغير بيئة لرمز Bearer لربط المؤشرات الاقتصادية وأسعار العملات والمجموعات المباشرة الأخرى. يسحب REST وMCP من رصيد الحساب نفسه، ويُحتسب استدعاء واحد لكل استدعاء ناجح.

بداية سريعة

احصل على مفتاح مجاني من https://narwhalapi.com/signup وصدّره باسم NARWHAL_API_KEY.
افتح ~/.codex/config.toml لجميع المشاريع أو .codex/config.toml داخل مشروع موثوق.
أضف جدول خادم Narwhal مع عنوانه وbearer_token_env_var مضبوطاً على اسم المتغير.
شغّل Codex من البيئة التي صُدِّر فيها المفتاح واطلب مؤشراً معيناً أو سعر عملة.

إعداد MCP

يسمّي الجدول [mcp_servers.narwhal] العنوان المستضاف ومتغير البيئة الذي يحمل مفتاحك. ضع NARWHAL_API_KEY في bearer_token_env_var، فيقرأ Codex القيمة ويرسلها في ترويسة Authorization من نوع Bearer.

[mcp_servers.narwhal]
url = "https://api.narwhalapi.com/mcp"
bearer_token_env_var = "NARWHAL_API_KEY"

يوجد إعداد المستخدم المشترك في ~/.codex/config.toml، بينما يمكن للمشروع الموثوق أن يملك .codex/config.toml الخاص به. أبقِ المفتاح في بيئة العملية التي تشغّل Codex، واترك اسم متغيره فقط في الملف.

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

يحصل Codex على كل مجموعات الأدوات للقراءة فقط عبر هذا الاتصال الواحد. التهيئة والاكتشاف مجانيان؛ وكل استدعاء أداة ناجح يُحتسب استدعاءً واحدًا يُخصم من الرصيد نفسه مثل استدعاء 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 الحالي.
اعثر على العطلة الرسمية التالية في اليابان.
احصل على السعر الفوري الحالي للذهب.

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

اجمع المؤشرات لإحاطة عن أستراليا

تسترجع economics_get_cpi_history الرقم القياسي لأسعار المستهلك الأسترالي حسب الفترة، مع بيان سنة الأساس للسلسلة.

افحص زوج عملات أثناء التطوير

مرّر USD عملة أساس وIDR عملة تسعير إلى fx_get_rate_bars للحصول على أشرطة مغلقة بالفاصل اليومي الافتراضي. عيّن start المطلوب إلى 2026-09-15 وend إلى 2026-09-21.

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

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

افحص أسعار السلع من أجل تحليلك

تأتي الأسعار الفورية للفضة من commodities_get_spot_price، مع تحديد الفضة وعملة التسعير في الطلب.

نصائح

إذا سجّلت الخادم بالأمر codex mcp add، فأضف bearer_token_env_var إلى الإعداد بعد ذلك لأن أمر الإضافة الموثَّق لا يملك خيار رمز Bearer.
عيّن متغير Bearer قبل الاتصال. وإلا يحاول Codex تسجيل دخول OAuth افتراضياً، وليس لدى Narwhal تسجيل دخول OAuth لـ MCP.
أبقِ المفتاح خارج الطلبات وقيم الإعداد وعناوين URL. يحتاج الإعداد إلى اسم متغير البيئة فقط.
استخدم نقطة النهاية https://api.narwhalapi.com/mcp تماماً دون شرطة مائلة في النهاية لتجنب عمليات إعادة التوجيه التي تعطّل بعض العملاء.

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

هل يستطيع Codex استخدام Narwhal بمفتاح API؟

نعم، عيّن bearer_token_env_var إلى NARWHAL_API_KEY في جدول خادم Narwhal. صدّر المفتاح الفعلي في البيئة التي تشغّل Codex، فيرسل Codex ترويسة Authorization من نوع Bearer.

هل أحتاج إلى إعدادين منفصلين لـ Codex CLI وتطبيق سطح المكتب؟

لا، تتشارك واجهة CLI وإضافة IDE وتطبيق سطح المكتب إعداد Codex نفسه. يسري ملف المستخدم على جميع المشاريع، بينما يستطيع المشروع الموثوق استخدام ملف إعداده الخاص.

هل تؤدي إضافة الخادم إلى بدء تسجيل دخول OAuth؟

يحاول Codex استخدام OAuth افتراضياً، لكن متغير Bearer المضبوط يجعله يرسل الرمز. يشترط Narwhal هذا المفتاح وليس لديه تسجيل دخول OAuth لـ MCP، لذا افحص المتغير قبل الاتصال.

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

العَرَض	تحقّق
لا يظهر Narwhal في Codex	افحص `[mcp_servers.narwhal]` في إعداد المستخدم، أو تأكد من أن المشروع الذي يحوي `.codex/config.toml` موثوق.
يعيد Narwhal الخطأ `401 invalid_api_key`	المفتاح المفقود أو الخاطئ يعيد من Narwhal الخطأ `401 invalid_api_key`. تأكد من تصدير `NARWHAL_API_KEY` في الصدفة التي تشغّل Codex.
يحاول Codex فتح تسجيل دخول OAuth	أضف `bearer_token_env_var` إلى جدول الخادم وعيّن متغير البيئة المسمى قبل تشغيل Codex.
سجّل أمر الإضافة العنوان لكن الاستدعاءات تفشل	افتح `config.toml` وأضف إعداد متغير Bearer. يسجّل أمر الإضافة الموثَّق العنوان دون إعداد بيانات الاعتماد هذا.

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