بيانات أسعار الوقود المفتوحة: API وخادم MCP

بيانات أسعار الوقود الرسمية في 30 دولة، وسجل كل قرار، وسعر النفط الخام، متاحة مجانًا لتطبيقك أو موقعك أو مساعد الذكاء الاصطناعي: واجهة برمجية (API) بلا مفتاح، وخادم MCP، وملفات CSV، وخلاصات RSS. الشرط الوحيد رابط إلى الصفحة التي جاء منها الرقم.

الواجهة البرمجية

طلبات GET عادية تعيد JSON، من أي لغة أو متصفح. العنوان الأساسي:

https://oilpricetoday.org/api/v1

وصف OpenAPI الكامل

خادم MCP

لمساعدات الذكاء الاصطناعي (Claude و ChatGPT و Cursor وغيرها)، فتجيب عن أسعار الوقود من مصدر رسمي مؤرخ. العنوان:

https://oilpricetoday.org/api/mcp

نقل HTTP قابل للبث، بلا تسجيل دخول.

ملفات CSV

كل الأسعار الحالية في ملف واحد يفتح في Excel و Google Sheets بالعربية:

حمّل fuel-prices.csv

نقاط الواجهة

الطلب	ماذا يعيد
`GET /api/v1/countries`	كل الدول المغطاة، وسعر البنزين الأساسي في كل منها
`GET /api/v1/countries/{slug}`	كل أنواع الوقود في دولة: السعر وتاريخ السريان والسعر السابق والجهة والمصدر
`GET /api/v1/countries/{slug}/history`	سجل القرارات (grade و since و limit اختيارية)
`GET /api/v1/compare?fuel=diesel`	ترتيب الدول بالدولار للتر (petrol و premium و diesel و kerosene و lpg)
`GET /api/v1/crude?currency=egypt`	برنت وغرب تكساس: آخر إغلاق، وآخر 30 يومًا، والمتوسطات الشهرية، وبعملة دولة
`GET /api/v1/fuel-cost?country=uae&km=120`	كلفة مشوار بالسعر الرسمي (l_per_100km و round_trip و passengers اختيارية)
`GET /api/v1/decisions/latest?limit=20`	أحدث قرارات الأسعار في كل الدول

{slug} اسم الدولة كما يظهر في عنوان صفحتها، مثل egypt و saudi-arabia و jordan و morocco. الأخطاء تعود برمز 400 ورسالة تذكر القيم المقبولة.

مثال: أسعار الوقود في مصر

curl https://oilpricetoday.org/api/v1/countries/egypt

جزء من الاستجابة

{
  "country": "egypt",
  "name_ar": "مصر",
  "grades": [
    {
      "id": "gasoline_80",
      "name_ar": "بنزين 80",
      "fuel": "petrol",
      "price": 20.75,
      "unit_ar": "لتر",
      "usd_per_litre": 0.3753,
      "effective": "2026-10-15",
      "previous": null,
      "status": "verified"
    }
  ],
  "page": "https://oilpricetoday.org/egypt/"
}

أدوات خادم MCP

fuel_pricesأسعار الوقود الرسمية في دولة
price_historyسجل قرارات الأسعار
compare_countriesترتيب الدول بالدولار للتر
crude_oilسعر برنت وغرب تكساس، وبعملة دولة
fuel_costكلفة مشوار
latest_decisionsأحدث القرارات
list_countriesالدول المغطاة

الربط في Claude أو ChatGPT

في الإعدادات افتح الموصلات (Connectors)، واختر إضافة موصل مخصص، والصق العنوان https://oilpricetoday.org/api/mcp. بعدها اسأل مثلًا: كم سعر بنزين 92 في مصر اليوم، ومتى تغير آخر مرة؟

Cursor وأي عميل يقرأ mcpServers

{
  "mcpServers": {
    "oilpricetoday": {
      "url": "https://oilpricetoday.org/api/mcp"
    }
  }
}

Claude Desktop عبر mcp-remote

{
  "mcpServers": {
    "oilpricetoday": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://oilpricetoday.org/api/mcp"
      ]
    }
  }
}

سجل القرارات بصيغة CSV

لكل دولة ملف بكل قرار: تاريخ السريان، والسعر القديم والجديد لكل نوع وقود، وحالة التوثيق، ورابط المصدر.

تنبيهات القرارات عبر RSS

تابع كل قرار جديد في قارئ الأخبار، أو اربطه بقناة أو بريد آلي: خلاصة كل الدول، ولكل دولة خلاصتها في عنوانها، مثل /egypt/feed.xml.

شروط الاستخدام

اذكر المصدر برابط ظاهر إلى الصفحة التي جاء منها الرقم (الحقل page). مثال: المصدر: سعر النفط اليوم.
الحد 60 طلبًا في الدقيقة لكل زائر. الطلبات الزائدة تعود برمز 429، فانتظر دقيقة.
الأسعار رسمية سارية للمعلومات، وليست توقعات ولا نصيحة استثمارية. نصحح أي خطأ يبلغنا به أحد على [email protected].
تريد اللوحة جاهزة بدل البرمجة؟ أضف لوحة الأسعار إلى موقعك.

أسئلة شائعة

هل الواجهة مجانية وهل تحتاج إلى مفتاح؟

مجانية وبلا مفتاح ولا تسجيل. الحد 60 طلبًا في الدقيقة لكل زائر، وهو أكثر من كافٍ لأن الأسعار الرسمية تتغير بقرار، لا كل دقيقة. خزّن النتيجة عندك وحدّثها كل ساعة.

من أين تأتي الأرقام؟

من القرارات الرسمية لكل دولة (الوزارات ولجان التسعير وشركات النفط الوطنية)، ولكل سعر في الاستجابة رابط مصدره وتاريخ سريانه وحالته: موثق من المصدر الرسمي أو بحسب تقارير صحفية. وسعر النفط الخام من إدارة معلومات الطاقة الأمريكية.

بأي وحدة تأتي الأسعار؟

بعملة الدولة ووحدة البيع فيها كما تظهر في صفحاتنا: اللتر غالبًا، والصفيحة في لبنان، والأسطوانة للغاز. الحقل usd_per_litre يحوّل سعر اللتر إلى الدولار بأسعار الصرف التي نعتمدها، ويبقى فارغًا حيث لا يوجد سعر صرف موثوق.

كيف أربط الخادم بمساعد ذكاء اصطناعي؟

أضف العنوان https://oilpricetoday.org/api/mcp موصلًا مخصصًا (Custom connector) في Claude أو ChatGPT، أو في ملف إعدادات Cursor أو أي عميل MCP. لا يحتاج إلى تسجيل دخول.

هل يمكنني استخدام البيانات تجاريًا؟

نعم، بشرط ذكر المصدر برابط ظاهر إلى الصفحة التي جاء منها الرقم (الحقل page في كل استجابة). لا تعرض الأرقام على أنها توقعات، فهي أسعار رسمية سارية.