@agentapps/app.open-meteo 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +79 -0
- package/agentapp.json +1 -1
- package/dist/app.js +2 -2
- package/package.json +18 -1
package/README.md
ADDED
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
# Open-Meteo
|
|
2
|
+
|
|
3
|
+
Lets an agent look up places by name and get their weather from the free
|
|
4
|
+
[Open-Meteo](https://open-meteo.com/) APIs: current conditions, daily and hourly forecasts up to
|
|
5
|
+
16 days, recent past days, and historical weather back to 1940. No account or API key is needed.
|
|
6
|
+
It calls three Open-Meteo hosts: `geocoding-api.open-meteo.com` (place search),
|
|
7
|
+
`api.open-meteo.com` (forecast) and `archive-api.open-meteo.com` (historical weather). All tools
|
|
8
|
+
are read-only.
|
|
9
|
+
|
|
10
|
+
## Tools
|
|
11
|
+
|
|
12
|
+
| Tool | What it does | Writes? |
|
|
13
|
+
|---|---|---|
|
|
14
|
+
| `search-locations` | Find places by name or postal code; returns coordinates, country, region, time zone, population | no |
|
|
15
|
+
| `get-forecast` | Current conditions, daily forecast (1-16 days), optional hourly values (up to 7 days), optional recent past days (up to 92) | no |
|
|
16
|
+
| `get-historical-weather` | Daily values for any range of up to 366 days from 1940-01-01 to yesterday; hourly for up to 7 days | no |
|
|
17
|
+
|
|
18
|
+
All tools are `readOnlyHint: true`, `destructiveHint: false`, `idempotentHint: true`,
|
|
19
|
+
`openWorldHint: true`, `sensitive: false`.
|
|
20
|
+
|
|
21
|
+
Typical flow: `search-locations name:Barcelona` -> take `latitude`/`longitude` ->
|
|
22
|
+
`get-forecast latitude:41.38879 longitude:2.15899`.
|
|
23
|
+
|
|
24
|
+
Notes:
|
|
25
|
+
|
|
26
|
+
- Time series are columnar: `time: [...]` plus one array per variable, with a `units` object and
|
|
27
|
+
a `weather_description` array that translates the WMO `weather_code`.
|
|
28
|
+
- Variables can be chosen per call (`dailyVariables`, `hourlyVariables`, `currentVariables`,
|
|
29
|
+
up to 10 each) using Open-Meteo's names, for example `uv_index_max` or `snowfall_sum`. See
|
|
30
|
+
<https://open-meteo.com/en/docs> and <https://open-meteo.com/en/docs/historical-weather-api>.
|
|
31
|
+
- Results are capped at 7 days of hourly data and 366 days of daily data per call to stay under
|
|
32
|
+
the 50,000-character tool result limit; the tools reject larger requests before calling the
|
|
33
|
+
API.
|
|
34
|
+
- The returned `location` is the model grid cell, which can be a few km from the requested
|
|
35
|
+
point.
|
|
36
|
+
- The latest ~5 days of the historical archive come from weather-model analysis until the ERA5
|
|
37
|
+
reanalysis catches up, so they may be revised; `get-forecast` with `pastDays` also covers them.
|
|
38
|
+
- The CLI turns numeric values into numbers, so a postal code with a leading zero loses it
|
|
39
|
+
(`name:08001` becomes `8001`, quotes do not help). Pass the arguments as one JSON object
|
|
40
|
+
instead: `agentapps open-meteo tool search-locations '{"name":"08001"}'`.
|
|
41
|
+
|
|
42
|
+
## Setup
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
agentapps install app.open-meteo open-meteo
|
|
46
|
+
# no secrets needed
|
|
47
|
+
agentapps open-meteo tools
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
No account or key is needed.
|
|
51
|
+
|
|
52
|
+
## Terms of use
|
|
53
|
+
|
|
54
|
+
From <https://open-meteo.com/en/terms> and <https://open-meteo.com/en/licence>:
|
|
55
|
+
|
|
56
|
+
- **Non-commercial use only** on the free API: no subscriptions, ads or integration into
|
|
57
|
+
commercial products. Commercial use needs a paid Open-Meteo plan, which uses different hosts
|
|
58
|
+
(`customer-*`) and an API key; this app does not support that yet (every declared secret is
|
|
59
|
+
required in Agent Apps, so an optional key is not possible without forcing one on everybody).
|
|
60
|
+
- **Rate limits** on the free API: under 600 calls per minute, 5,000 per hour, 10,000 per day
|
|
61
|
+
and 300,000 per month. The app retries a short `429` once or twice and otherwise reports
|
|
62
|
+
`[RATE_LIMITED]`.
|
|
63
|
+
- **Attribution**: data are CC BY 4.0. Show a link next to the data, for example
|
|
64
|
+
"Weather data by Open-Meteo.com" linking to <https://open-meteo.com/>. Every result carries an
|
|
65
|
+
`attribution` field for this. Place search data come from GeoNames (CC BY 4.0).
|
|
66
|
+
|
|
67
|
+
## Logos
|
|
68
|
+
|
|
69
|
+
| File | Source | Changes |
|
|
70
|
+
|---|---|---|
|
|
71
|
+
| assets/logo-mono.svg | The logo in the header of open-meteo.com: `src/lib/assets/icons/sun.svelte` in [open-meteo/open-meteo-website](https://github.com/open-meteo/open-meteo-website) (commit 3fbe71f), imported as `Logo` by `src/lib/components/header/header.svelte`. The glyph is the Bootstrap Icons "cloud-sun" icon (MIT), which Open-Meteo uses as its logo. | removed `fill="currentColor"`, `class`, `style` and the Svelte `{width}`/`{height}` props; paths unchanged |
|
|
72
|
+
| assets/logo.svg | not added | - |
|
|
73
|
+
|
|
74
|
+
TODO (`assets/logo.svg`): no official colour logo found that meets the rules. Searched: the
|
|
75
|
+
open-meteo.com home page and header (only the single-colour `currentColor` SVG above, used for
|
|
76
|
+
`logoMono`), `/en/terms` and `/en/licence` (no press or brand page), the
|
|
77
|
+
`open-meteo/open-meteo-website` repo `static/` (the coloured "om" app icon exists only as PNG,
|
|
78
|
+
largest `android-chrome-512x512.png`, below the 1024x1024 minimum; no SVG). Add one when an
|
|
79
|
+
official SVG or a 1024px PNG exists, or ask the maintainers.
|
package/agentapp.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"id": "app.open-meteo",
|
|
3
3
|
"name": "Open-Meteo",
|
|
4
|
-
"version": "1.0.
|
|
4
|
+
"version": "1.0.1",
|
|
5
5
|
"description": "Look up places by name and get weather from the free Open-Meteo APIs (no key): current conditions, daily and hourly forecasts up to 16 days, and historical weather back to 1940. Free tier is for non-commercial use only; data are CC BY 4.0.",
|
|
6
6
|
"tagline": "Weather forecasts and historical weather for any place, from Open-Meteo",
|
|
7
7
|
"author": { "name": "Pablo López Torres", "email": "pablolopeztorres@gmail.com" },
|
package/dist/app.js
CHANGED
|
@@ -21528,7 +21528,7 @@ class AppInstance {
|
|
|
21528
21528
|
success: false,
|
|
21529
21529
|
error: {
|
|
21530
21530
|
code: ErrorCode.UNAUTHORIZED,
|
|
21531
|
-
message: `Missing required
|
|
21531
|
+
message: `Missing required Installation secret(s): ${missingSecrets.join(", ")}. ` + `Configure them for this installation before using ${this.config.id}.`
|
|
21532
21532
|
},
|
|
21533
21533
|
duration: 0
|
|
21534
21534
|
});
|
|
@@ -23600,7 +23600,7 @@ function registerTools(app) {
|
|
|
23600
23600
|
var app = createApp({
|
|
23601
23601
|
id: "app.open-meteo",
|
|
23602
23602
|
name: "Open-Meteo",
|
|
23603
|
-
version: "1.0.
|
|
23603
|
+
version: "1.0.1",
|
|
23604
23604
|
description: "Look up places by name and get weather from the free Open-Meteo APIs (no key): current conditions, daily and hourly forecasts up to 16 days, and historical weather back to 1940. Free tier is for non-commercial use only; data are CC BY 4.0.",
|
|
23605
23605
|
tagline: "Weather forecasts and historical weather for any place, from Open-Meteo",
|
|
23606
23606
|
author: { name: "Pablo López Torres", email: "pablolopeztorres@gmail.com" },
|
package/package.json
CHANGED
|
@@ -1,11 +1,28 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@agentapps/app.open-meteo",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
|
+
"description": "Weather forecasts and historical weather for any place, from Open-Meteo",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"author": "Pablo López Torres <pablolopeztorres@gmail.com>",
|
|
7
|
+
"keywords": [
|
|
8
|
+
"agent-apps",
|
|
9
|
+
"open-meteo",
|
|
10
|
+
"weather",
|
|
11
|
+
"forecast",
|
|
12
|
+
"historical weather",
|
|
13
|
+
"geocoding",
|
|
14
|
+
"climate"
|
|
15
|
+
],
|
|
4
16
|
"type": "module",
|
|
5
17
|
"main": "./dist/app.js",
|
|
6
18
|
"exports": {
|
|
7
19
|
".": "./dist/app.js",
|
|
8
20
|
"./agentapp.json": "./agentapp.json",
|
|
9
21
|
"./package.json": "./package.json"
|
|
22
|
+
},
|
|
23
|
+
"repository": {
|
|
24
|
+
"type": "git",
|
|
25
|
+
"url": "https://github.com/agentapps/agentapps.git",
|
|
26
|
+
"directory": "apps/open-meteo"
|
|
10
27
|
}
|
|
11
28
|
}
|