EkoPump

Devuelve el precio medio nacional de gasolina (G95), G98 y diésel por país, junto con el precio del petróleo Brent, agregados a partir de fuentes oficiales por EkoPump (ekopump.es). Datos de solo lectura, sin autenticación. Args: - country (string, opcional): código ISO 3166-1 alpha-2 (ej. "ES"). Si se omite, devuelve todos los países disponibles. Devuelve precios en euros por litro, salvo que la fuente original use otra moneda ya convertida por EkoPump.

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Código de país ISO 3166-1 alpha-2 (ej. 'ES', 'FR', 'DE'). Si se omite, se devuelven todos los países con datos de precio disponibles.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Devuelve las alertas actualmente activas que EkoPump agrega de múltiples fuentes oficiales: tráfico DGT (España), incendios (EONET/EFFIS), meteorología severa (MeteoAlarm, National Weather Service), sismos y otras. Incluye desglose por fuente y severidad además de una muestra de alertas individuales. Args: - limit (number, opcional, 1-50, por defecto 15): cuántas alertas individuales devolver. El desglose por fuente/severidad siempre refleja el total real, no solo la muestra.

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 15,
      "description": "Número máximo de alertas individuales a devolver (1-50, por defecto 15). El resumen por fuente y severidad siempre incluye el total real.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Devuelve qué tipos de datos en vivo tiene EkoPump para un país (o para todos): combustible, transporte público, vehículos en vivo, bicis públicas, cargadores EV, alertas locales, vuelos y barcos. Útil para responder "¿EkoPump tiene datos de X país?" o "¿qué cubre EkoPump en Portugal?". Args: - country (string, opcional): código ISO 3166-1 alpha-2 (ej. "PT"). Si se omite, devuelve un resumen agregado de todos los países con al menos un dato en vivo.

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Código de país ISO 3166-1 alpha-2. Si se omite, se devuelve un resumen agregado de todos los países.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Devuelve las gasolineras con mejor precio en una ciudad concreta cubierta por EkoPump, ordenadas de más barata a más cara, con precio de gasolina y diésel por estación. Args: - city (string, requerido): nombre o slug de la ciudad (ej. "Madrid", "paris"). Debe ser una de las ciudades cubiertas por EkoPump — si no se reconoce, el error incluye ejemplos válidos. - limit (number, opcional, 1-25, por defecto 10): cuántas estaciones devolver.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "Nombre o slug de una ciudad cubierta por EkoPump (ej. \"Madrid\", \"paris\", \"san-sebastian\"). Ciudades disponibles: Madrid, Barcelona, Valencia, Sevilla, Bilbao, Zaragoza, Málaga, Alicante, Murcia, Palma, Valladolid, Córdoba, Granada, Santander, San Sebastián, y más."
    },
    "limit": {
      "default": 10,
      "description": "Número máximo de estaciones a devolver, ordenadas de más barata a más cara (1-25, por defecto 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "city"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}