$ shortage api --spec
> base https://api.shortage.life/v1
> 10 endpoints · OpenAPI 3.1
> mcp.shortage.life/mcpBRENT $72.13/b ● TTF €44.25/MWh ● OPEC_ORB n/a SPR_US 331.2 Mb ▼ FAO_FFPI 130.8 ▼
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.
Elenca ogni materia prima monitorata con quotazione attuale, indice di stress e ultimo aggiornamento.
Riserva strategica attuale per una materia prima e un paese, con percentuale di riempimento e copertura.
Serie temporale normalizzata per una metrica di riserva su un intervallo di date arbitrario.
Profilo paese completo: indice di stress, principali esposizioni, autonomia, concentrazione dei fornitori.
Scheda completa di una materia prima: produttori, consumatori, flussi e lettura di stress attuale.
Elenca gli scenari di crisi prospettici con probabilità, gravità e stato.
Eventi geopolitici taggati — conflitto, sanzione, disastro, politica, infrastruttura.
Ultimi briefing editoriali per una lingua, i più recenti per primi.
Ricerca semantica tra briefing e scenari, alimentata dallo strato RAG.
Endpoint conversazionale — una domanda in linguaggio naturale, con risposta e fonti citate. Fortemente limitato in frequenza.
Gli agenti di IA — Claude Desktop, Cursor e altri — possono interrogare i dati direttamente via SSE su mcp.shortage.life/mcp. Strumenti esposti: get_reserve, get_price, compare_countries, list_scenarios, search_briefings, get_country_profile.
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.