shortage.life · last_sync · 2026-08-18 13:50:24 UTCbuild 83e413e · 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
> mcp.shortage.life/mcp

// readout · live

BRENT     $90.79/b ▼
TTF       €62.72/MWh ▲
OPEC_ORB  $108.8/b ●
SPR_US    304.8 Mb ▼
FAO_FFPI  130.3 ▼
revalidate 15mUTC 00:00:00
$_TICKER
BRENT$90.79▼0.38%TTF€62.72▲0.22%HH$2.72▲0.37%SPR_US304.8 Mb15.6dEU_GAS61.5%18c avgOPEC_ORB$108.79● flatFAO_FFPI130.3▼0.4%WHT$6.86/bu▼0.65%BRENT$90.79▼0.38%TTF€62.72▲0.22%HH$2.72▲0.37%SPR_US304.8 Mb15.6dEU_GAS61.5%18c avgOPEC_ORB$108.79● flatFAO_FFPI130.3▼0.4%WHT$6.86/bu▼0.65%

$_API · REST public

Gratuite, anonyme, à débit limité. Chaque matière première, chaque pays, chaque scénario — lectures seules, pas de SDK, pas de clé. Les réponses sont en JSON ; le jeu de données est sous CC-BY-4.0 avec un lien retour obligatoire. URL de base https://api.shortage.life/v1.

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

$_POINTS D'ACCÈS · v1

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

Liste chaque matière première suivie avec son cours actuel, son indice de stress et sa dernière mise à jour.

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

Réserve stratégique actuelle pour une matière première et un pays, avec pourcentage de remplissage et couverture.

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

Série temporelle normalisée pour une métrique de réserve sur une plage de dates arbitraire.

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

Profil pays complet : indice de stress, principales expositions, autonomie, concentration des fournisseurs.

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

Fiche complète d'une matière première : producteurs, consommateurs, flux et lecture de stress actuelle.

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

Liste les scénarios de crise prospectifs avec leur probabilité, leur gravité et leur statut.

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

Événements géopolitiques tagués — conflit, sanction, catastrophe, politique, infrastructure.

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

Derniers briefings éditoriaux pour une langue, les plus récents en premier.

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

Recherche sémantique dans les briefings et les scénarios, propulsée par la couche RAG.

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

Point d'accès conversationnel — une question en langage naturel, répondue avec des sources citées. Fortement limité en débit.

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

// serveur MCP

Les agents d'IA — Claude Desktop, Cursor et d'autres — peuvent interroger les données directement via SSE sur mcp.shortage.life/mcp. Outils exposés : get_reserve, get_price, compare_countries, list_scenarios, search_briefings, get_country_profile.

# ajoutez à la configuration de votre client MCP $ mcp add shortage https://mcp.shortage.life/mcp
→ /mcp · full server documentation, all 10 tools

// découverte

Le contrat complet lisible par machine est publié en OpenAPI 3.1. Trois fichiers de découverte se trouvent sous /.well-known/ pour les crawlers et agents d'IA.