$ shortage api --spec
> base https://api.shortage.life/v1
> 10 endpoints · OpenAPI 3.1
> api.shortage.life/mcpBRENT $105.4/b ▼ TTF €81.97/MWh ▲ OPEC_ORB $108.8/b ● SPR_US 286.6 Mb ▼ FAO_FFPI 133.3 ▲
Gratuita, anónima, con límite de tasa. Cada materia prima, cada país, cada escenario — solo lecturas, sin SDK, sin clave. Las respuestas son JSON; el conjunto de datos es CC-BY-4.0 con un enlace de retorno obligatorio. URL base https://api.shortage.life/v1.
Lista cada materia prima rastreada con su cotización actual, índice de estrés y última actualización.
Reserva estratégica actual para una materia prima y un país, con porcentaje de llenado y cobertura.
Serie temporal normalizada para una métrica de reserva sobre un rango de fechas arbitrario.
Perfil de país completo: índice de estrés, principales exposiciones, autonomía, concentración de proveedores.
Ficha completa de una materia prima: productores, consumidores, flujos y lectura de estrés actual.
Lista los escenarios de crisis prospectivos con su probabilidad, gravedad y estado.
Eventos geopolíticos etiquetados — conflicto, sanción, desastre, política, infraestructura.
Últimos briefings editoriales para un idioma, los más recientes primero.
Búsqueda semántica en briefings y escenarios, impulsada por la capa RAG.
Punto de acceso conversacional — una pregunta en lenguaje natural, respondida con fuentes citadas. Fuertemente limitado en tasa.
Los agentes de IA — Claude Desktop, Cursor y otros — pueden consultar los datos directamente vía SSE en api.shortage.life/mcp. Herramientas expuestas: get_reserve, get_price, compare_countries, list_scenarios, search_briefings, get_country_profile.
El contrato completo legible por máquina se publica como OpenAPI 3.1. Tres archivos de descubrimiento se ubican bajo /.well-known/ para crawlers y agentes de IA.