بيانات تجريبية · لا تُستشهد
shortage.life · session_log · 2026-05-17 14:32 UTCPID 47023 · ttyS0 · uptime 312d

// node

shortage.life
v0.3 · brussels · build f3a2c81
● online · 47/47 sources · 312ms

// $_ exec

$ shortage api --spec
> base https://api.shortage.life/v1
> 10 endpoints · OpenAPI 3.1
> mcp.shortage.life/mcp

// readout · live

BRENT     $84.27 ▲
TTF       €31.50 ▼
OPEC_SP   3.8 mb/d ●
SPR_US    372.4 Mb
FAO_FFPI  121.4 ▲
auto-refresh 60slatency 312msbuild 0.3.0commit f3a2c81UTC 00:00:00
$_TICKER
BRENT$84.27▲0.50%WTI$80.15▲0.39%TTF€31.50▼3.67%NBP72.4p▼1.50%HH$2.84▲1.43%SPR_US372.4 Mb18.7dEU_GAS78.3%▲0.4ppOPEC_SPARE3.8 mb/d▼0.3FAO_FFPI121.4▲0.8WHT.SRW$6.42/bu▲1.84%RIC.THAI$612/t▲0.32%UREA$378/t▲2.71%LITH$13,820/t▼0.84%COBL$31,400/t—CU$9,820/t▲0.65%NI$17,420/t▼1.10%BRENT$84.27▲0.50%WTI$80.15▲0.39%TTF€31.50▼3.67%NBP72.4p▼1.50%HH$2.84▲1.43%SPR_US372.4 Mb18.7dEU_GAS78.3%▲0.4ppOPEC_SPARE3.8 mb/d▼0.3FAO_FFPI121.4▲0.8WHT.SRW$6.42/bu▲1.84%RIC.THAI$612/t▲0.32%UREA$378/t▲2.71%LITH$13,820/t▼0.84%COBL$31,400/t—CU$9,820/t▲0.65%NI$17,420/t▼1.10%

$_API · REST عامة

مجانية، مجهولة، محدودة المعدّل. كل سلعة، وكل دولة، وكل سيناريو — قراءة فقط، بلا SDK، بلا مفتاح. الاستجابات بصيغة JSON؛ ومجموعة البيانات تحت رخصة CC-BY-4.0 مع رابط رجوع إلزامي. عنوان URL الأساسي https://api.shortage.life/v1.

AUTHanonymous
DATA ENDPOINTS60 req/min/IP
/v1/ask10 req/min/IP
LICENCECC-BY-4.0
FORMATJSON · UTF-8

$_نقاط الوصول · v1

10 مسارات · 9 GET · 1 POST
GET/v1/commodities

يسرد كل سلعة متتبَّعة مع سعرها الفوري الحالي ومؤشر إجهادها وآخر تحديث.

COPY$ curl -s https://api.shortage.life/v1/commodities
GET/v1/reserves?commodity=oil&country=US

الاحتياطي الاستراتيجي الحالي لسلعة ودولة، مع نسبة الامتلاء والتغطية.

COPY$ curl -s https://api.shortage.life'/v1/reserves?commodity=oil&country=US'
GET/v1/reserves/timeseries?commodity=oil&from=…

سلسلة زمنية مُطبَّعة لمقياس احتياطي عبر نطاق تواريخ اختياري.

COPY$ curl -s https://api.shortage.life'/v1/reserves/timeseries?commodity=oil&country=US&from=2025-01-01'
GET/v1/countries/{iso}

ملف دولة كامل: مؤشر الإجهاد، وأبرز أوجه الانكشاف، والاستقلالية، وتركّز المورّدين.

COPY$ curl -s https://api.shortage.life/v1/countries/SAU
GET/v1/commodities/{slug}

بطاقة سلعة كاملة: المنتجون والمستهلكون والتدفّقات وقراءة الإجهاد الحالية.

COPY$ curl -s https://api.shortage.life/v1/commodities/OIL.BRT
GET/v1/scenarios

يسرد سيناريوهات الأزمات الاستشرافية مع احتمالها وشدّتها وحالتها.

COPY$ curl -s https://api.shortage.life/v1/scenarios
GET/v1/events?since=…

أحداث جيوسياسية موسومة — نزاع، عقوبة، كارثة، سياسة، بنية تحتية.

COPY$ curl -s https://api.shortage.life'/v1/events?since=2026-05-01'
GET/v1/briefings?lang=en&limit=20

أحدث الموجزات التحريرية للغة معيّنة، الأحدث أولاً.

COPY$ curl -s https://api.shortage.life'/v1/briefings?lang=en&limit=20'
GET/v1/search?q=…

بحث دلالي عبر الموجزات والسيناريوهات، مدعوم بطبقة RAG.

COPY$ curl -s https://api.shortage.life'/v1/search?q=opec+spare+capacity'
POST/v1/ask

نقطة وصول حوارية — سؤال بلغة طبيعية، يُجاب عنه بمصادر مُستشهَد بها. محدود المعدّل بشدّة.

COPY$ curl -s -X POST https://api.shortage.life/v1/ask \ -H 'content-type: application/json' \ -d '{"q":"is EU gas storage above the 5-year mean?"}'

// خادم MCP

يمكن لوكلاء الذكاء الاصطناعي — Claude Desktop وCursor وغيرهما — الاستعلام عن البيانات مباشرةً عبر SSE على mcp.shortage.life/mcp. الأدوات المتاحة: get_reserve, get_price, compare_countries, list_scenarios, search_briefings, get_country_profile.

# أضِف إلى إعداد عميل MCP الخاص بك $ mcp add shortage https://mcp.shortage.life/mcp
→ /mcp · full server documentation, all 10 tools

// الاكتشاف

يُنشَر العقد الكامل القابل للقراءة آلياً بصيغة OpenAPI 3.1. وتوجد ثلاثة ملفات اكتشاف تحت /.well-known/ لزواحف ووكلاء الذكاء الاصطناعي.