Add-ons

talaya://instalar?url=https%3A%2F%2Fheytalaya.com%2Fcomplementos%2Fdivisas.talaya.json

{
  "formato": "talaya.complemento/1",
  "id": "org.ejemplo.divisas",
  "nombre": "Divisas",
  "version": "1.0.0",
  "autor": { "nombre": "Ejemplo", "web": "https://ejemplo.org" },
  "descripcion": "Convierte entre monedas con el cambio del día del Banco Central Europeo.",
  "icono": "dollarsign.circle",
  "cobertura": null,
  "permisos": {
    "red": ["api.frankfurter.dev"],
    "ubicacion": false,
    "memoria": false,
    "pantalla": true
  },
  "habilidades": [
    {
      "nombre": "convertir_divisas",
      "descripcion": "Convierte una cantidad entre dos monedas con el cambio de hoy. Para «¿cuánto son cien dólares en euros?».",
      "parametros": {
        "cantidad": { "tipo": "decimal", "descripcion": "La cantidad", "obligatorio": true },
        "de": { "tipo": "texto", "descripcion": "Código ISO de la moneda de origen, p. ej. USD", "obligatorio": true },
        "a": { "tipo": "texto", "descripcion": "Código ISO de la moneda de destino, p. ej. EUR", "obligatorio": true }
      },
      "pasos": [
        { "http": { "url": "https://api.frankfurter.dev/v1/latest?amount={{cantidad}}&from={{de}}&to={{a}}" } },
        { "extraer": { "de": "$.rates.{{a}}", "como": "resultado" } },
        { "decir": "{{cantidad}} {{de}} son {{resultado}} {{a}} al cambio de hoy." }
      ]
    }
  ]
}

"cobertura": {
  "zonas": [
    { "nombre": "Lisboa", "sur": 38.6, "oeste": -9.3, "norte": 38.85, "este": -9.05 }
  ]
}

{
  "formato": "talaya.complemento/1",
  "id": "dev.pages.talaya.mar",
  "nombre": "Estado del mar",
  "version": "1.0.0",
  "autor": {
    "nombre": "Talaya",
    "web": "https://heytalaya.com"
  },
  "descripcion": "Altura, periodo y dirección de las olas, y la temperatura del agua en la costa más cercana.",
  "icono": "water.waves",
  "cobertura": null,
  "permisos": {
    "red": [
      "marine-api.open-meteo.com"
    ],
    "ubicacion": true,
    "memoria": false,
    "pantalla": false
  },
  "habilidades": [
    {
      "nombre": "estado_del_mar",
      "descripcion": "Cómo está el mar ahora en la costa donde está el usuario: altura de las olas en metros, cada cuántos segundos llegan, de dónde vienen y temperatura del agua. Para «¿cómo está el mar?», «¿hay olas?», «¿está buena el agua?», «¿a cuánto está el agua?», «how are the waves?». Tierra adentro no hay dato, y lo dice.",
      "parametros": {},
      "pasos": [
        {
          "si": {
            "valor": "{{lat}}",
            "op": "vacio",
            "entonces": [
              {
                "decir": "No sé dónde estás ahora mismo: sin ubicación no puedo mirar el mar."
              }
            ],
            "siNo": [
              {
                "http": {
                  "url": "https://marine-api.open-meteo.com/v1/marine?latitude={{lat}}&longitude={{lon}}&current=wave_height,wave_period,wave_direction,sea_surface_temperature&timezone=auto"
                }
              },
              {
                "extraer": {
                  "de": "$.current.wave_height",
                  "como": "olas",
                  "siNoHay": ""
                }
              },
              {
                "si": {
                  "valor": "{{olas}}",
                  "op": "vacio",
                  "entonces": [
                    {
                      "decir": "Aquí no hay datos del mar: parece que estás tierra adentro."
                    }
                  ],
                  "siNo": [
                    {
                      "extraer": {
                        "de": "$.current.wave_period",
                        "como": "periodo",
                        "siNoHay": "sin dato"
                      }
                    },
                    {
                      "extraer": {
                        "de": "$.current.wave_direction",
                        "como": "rumbo",
                        "siNoHay": "sin dato"
                      }
                    },
                    {
                      "extraer": {
                        "de": "$.current.sea_surface_temperature",
                        "como": "agua",
                        "siNoHay": "sin dato"
                      }
                    },
                    {
                      "decir": "Olas de {{olas}} metros cada {{periodo}} segundos, que llegan desde los {{rumbo}} grados. El agua está a {{agua}} grados."
                    }
                  ]
                }
              }
            ]
          }
        }
      ]
    }
  ]
}

async function run(args, api) {
  const r = await api.http.get("https://api.ejemplo.org/cosas?cerca=" + args.que);
  const datos = JSON.parse(r.cuerpo);
  const cerca = datos.filter(p => api.distancia(p.lat, p.lon) < 800);
  await api.reloj.marcas("Cerca", cerca.map(p => ({ etiqueta: p.nombre, lat: p.lat, lon: p.lon })));
  return `Hay ${cerca.length} a menos de ochocientos metros.`;
}

// Terremotos cerca. Datos del EMSC (www.seismicportal.eu), sin clave.
// Una sola petición: el servicio ya filtra por distancia, fecha y magnitud.
async function run(args, api) {
  const en = String(api.idioma || "").toLowerCase().indexOf("en") === 0;
  const yo = api.posicion();
  if (typeof yo.lat !== "number") {
    return en
      ? "I don't know where you are right now, so I can't look for earthquakes nearby."
      : "No sé dónde estás ahora mismo: sin ubicación no puedo mirar los terremotos cercanos.";
  }

  const radioKm = Number(args.radio_km) > 0 ? Number(args.radio_km) : 300;
  const dias = Number(args.dias) > 0 ? Math.min(Number(args.dias), 30) : 7;
  const minima = Number(args.magnitud_minima) > 0 ? Number(args.magnitud_minima) : 2;
  const desde = new Date(Date.now() - dias * 86400000).toISOString().slice(0, 19);
  const grados = Math.min(20, Math.max(0.5, radioKm / 111.2)).toFixed(2);

  const url = "https://www.seismicportal.eu/fdsnws/event/1/query?format=json&orderby=time&limit=50"
    + "&lat=" + yo.lat.toFixed(3) + "&lon=" + yo.lon.toFixed(3)
    + "&maxradius=" + grados + "&minmag=" + minima + "&start=" + desde;

  const nada = en
    ? "No earthquakes of magnitude " + minima + " or more within " + radioKm + " km in the last " + dias + " days."
    : "No ha habido terremotos de magnitud " + minima + " o más a menos de " + radioKm + " km en los últimos " + dias + " días.";

  const r = await api.http.get(url, { plazo: 15 });
  // El servicio contesta 204, sin cuerpo, cuando no hay nada.
  if (r.codigo === 204 || !r.cuerpo) return nada;
  if (r.codigo !== 200) throw new Error("el EMSC ha contestado con el error " + r.codigo);

  const lista = (JSON.parse(r.cuerpo).features || []).map(function (f) {
    const p = f.properties;
    const metros = api.distancia(p.lat, p.lon);
    return {
      mag: Number(p.mag),
      zona: String(p.flynn_region || "").toLowerCase(),
      lat: p.lat,
      lon: p.lon,
      cuando: Date.parse(p.time),
      km: metros >= 0 ? Math.round(metros / 1000) : null
    };
  });
  if (!lista.length) return nada;

  function hace(ms) {
    const min = Math.max(1, Math.round((Date.now() - ms) / 60000));
    if (min < 60) return en ? min + " minutes ago" : "hace " + min + " minutos";
    const h = Math.round(min / 60);
    if (h < 48) return en ? h + " hours ago" : "hace " + h + " horas";
    const d = Math.round(h / 24);
    return en ? d + " days ago" : "hace " + d + " días";
  }
  function uno(t) {
    const lejos = t.km === null ? "" : (en ? ", " + t.km + " km away" : ", a " + t.km + " km");
    return (en ? "magnitude " : "magnitud ") + t.mag.toFixed(1) + (en ? " in " : " en ") + t.zona + lejos + ", " + hace(t.cuando);
  }

  await api.reloj.marcas(en ? "Earthquakes" : "Terremotos", lista.slice(0, 20).map(function (t) {
    return { etiqueta: "M" + t.mag.toFixed(1), lat: t.lat, lon: t.lon };
  }));

  const ultimo = lista[0];
  const mayor = lista.reduce(function (a, b) { return b.mag > a.mag ? b : a; });
  const cuantos = lista.length === 1
    ? (en ? "One earthquake" : "Un terremoto")
    : lista.length + (en ? " earthquakes" : " terremotos");
  let texto = en
    ? cuantos + " of magnitude " + minima + " or more within " + radioKm + " km in the last " + dias + " days (EMSC data). The latest: " + uno(ultimo) + "."
    : cuantos + " de magnitud " + minima + " o más a menos de " + radioKm + " km en los últimos " + dias + " días (datos del EMSC). El último: " + uno(ultimo) + ".";
  if (mayor !== ultimo) texto += en ? " The strongest: " + uno(mayor) + "." : " El mayor: " + uno(mayor) + ".";
  if (lista.length === 50) texto += en ? " There may be more." : " Puede haber más.";
  return texto;
}

"mcp": {
  "url": "https://mcp.ejemplo.org/mcp",
  "autenticacion": "token",
  "instrucciones": "Pídele a tu administrador el token de acceso."
}

{
  "id": "dev.pages.talaya.divisas",
  "nombre": "Divisas",
  "version": "1.0.0",
  "autor": "Talaya",
  "descripcion": "Convierte entre monedas con el cambio del día que publica el Banco Central Europeo.",
  "icono": "dollarsign.circle",
  "tipo": "receta",
  "permisos": {
    "red": [
      "api.frankfurter.dev"
    ],
    "ubicacion": false,
    "memoria": false,
    "pantalla": false
  },
  "url": "https://heytalaya.com/complementos/divisas.talaya.json"
}