shortage.life · last_sync · 2026-09-11 00:00:00 UTCbuild 2215125 · node v22.22.2

// node

shortage.life
brussels
● online · 8 sources

// $_ exec

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

// readout · live

BRENT     $105.4/b ▼
TTF       €81.97/MWh ▲
OPEC_ORB  $108.8/b ●
SPR_US    286.6 Mb ▼
FAO_FFPI  133.3 ▲
revalidate 15mUTC 00:00:00
$_TICKER
BRENT$105.35▼3.95%TTF€81.97▲3.80%HH$2.82▼0.70%SPR_US286.6 Mb14.7dEU_GAS69.9%18c avgOPEC_ORB$108.79● flatFAO_FFPI133.3▲1.9%WHT$7.34/bu▼0.98%BRENT$105.35▼3.95%TTF€81.97▲3.80%HH$2.82▼0.70%SPR_US286.6 Mb14.7dEU_GAS69.9%18c avgOPEC_ORB$108.79● flatFAO_FFPI133.3▲1.9%WHT$7.34/bu▼0.98%

$_API · REST pubblica

Gratuita, anonima, con limite di frequenza. Ogni materia prima, ogni paese, ogni scenario — sola lettura, nessun SDK, nessuna chiave. Le risposte sono JSON; il set di dati è CC-BY-4.0 con un backlink obbligatorio. URL di base https://api.shortage.life/v1.

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

$_ENDPOINT · v1

10 rotte · 9 GET · 1 POST
GET/v1/commodities

Elenca ogni materia prima monitorata con quotazione attuale, indice di stress e ultimo aggiornamento.

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

Riserva strategica attuale per una materia prima e un paese, con percentuale di riempimento e copertura.

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

Serie temporale normalizzata per una metrica di riserva su un intervallo di date arbitrario.

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

Profilo paese completo: indice di stress, principali esposizioni, autonomia, concentrazione dei fornitori.

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

Scheda completa di una materia prima: produttori, consumatori, flussi e lettura di stress attuale.

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

Elenca gli scenari di crisi prospettici con probabilità, gravità e stato.

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

Eventi geopolitici taggati — conflitto, sanzione, disastro, politica, infrastruttura.

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

Ultimi briefing editoriali per una lingua, i più recenti per primi.

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

Ricerca semantica tra briefing e scenari, alimentata dallo strato RAG.

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

Endpoint conversazionale — una domanda in linguaggio naturale, con risposta e fonti citate. Fortemente limitato in frequenza.

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?"}'

// server MCP

Gli agenti di IA — Claude Desktop, Cursor e altri — possono interrogare i dati direttamente via SSE su api.shortage.life/mcp. Strumenti esposti: get_reserve, get_price, compare_countries, list_scenarios, search_briefings, get_country_profile.

# aggiungete alla configurazione del vostro client MCP $ mcp add shortage https://api.shortage.life/mcp
→ /mcp · full server documentation, all 10 tools

// scoperta

Il contratto completo leggibile dalla macchina è pubblicato come OpenAPI 3.1. Tre file di scoperta si trovano sotto /.well-known/ per crawler e agenti di IA.