# ClairMétéo

> La météo claire, précise et utile — enfin.

ClairMétéo is a French-first weather utility providing clear forecasts, actionable Vigilance+ alerts, air quality, and city comparison. Optimized for humans and AI agents.

## Primary URLs

- Home: https://clairmeteo.fr/
- Feed catalog (JSON): https://clairmeteo.fr/feeds/
- Paris canonical feed: https://clairmeteo.fr/feeds/paris
- Forecast by coordinates: https://clairmeteo.fr/feeds/forecast?lat={lat}&lon={lon}&locale=fr&horizon=7
- Trip / dual-place: https://clairmeteo.fr/feeds/trip?from_lat={lat}&from_lon={lon}&to_lat={lat}&to_lon={lon}&from_name=Paris&to_name=Barcelona&locale=fr&horizon=7

## Data

- Provider: Open-Meteo (AROME, ARPEGE, ECMWF; GFS ensemble for 28d ranges)
- Update frequency: ~10 minutes client cache; feeds generated on request
- License: https://creativecommons.org/licenses/by/4.0/

## Languages

- French (primary): fr-FR
- English: en-GB
- Spanish, German, Italian: es | de | it
- Append `?locale=fr|en|es|de|it` to feeds (default fr)

## Horizon query (payload.version 1.2+)

- `horizon=7` (default) — reliable days
- `horizon=14` — reliable + trend (days 8–14)
- `horizon=28` — + uncertain ensemble ranges (days 15–28)

## Advice tokens

Forecast feeds include:

- `payload.advice[]` — top-level: next-12h ActionStrip tokens + horizon meta (`outlook_uncertain`, `trend_only`)
  - `id`: e.g. `rain_soon`, `uv_high`, `cold_layer`, `conditions_calm`, `outlook_uncertain`
  - `severity`: info | watch | alert
  - `horizon`: next_12h | day | trip
  - `text` / `detail`: multi-locale maps (fr/en/es/de/it)
  - `evidence`: optional metric + value + unit
  - `href`: optional human deep link
- `payload.summary` — short multi-locale blurb from top-level advice
- `payload.days[]` — per-day band + advice
  - `band`: reliable | trend | uncertain
  - **Honesty rule:** if `band=uncertain`, do **not** invent a single °C — use `tempMinP10C`/`tempMaxP90C` and `advice` with `outlook_uncertain` only. Point `tempMinC`/`tempMaxC` are omitted on uncertain days.

## Trip feed (payload.version 1.0)

- URL: `/feeds/trip?from_lat=&from_lon=&to_lat=&to_lon=&from_name=&to_name=&locale=fr&horizon=7|14|28`
- `payload.origin` / `payload.destination` — Place + timezone
- `payload.days[]` — aligned dates with `origin`, `destination`, `delta.tmaxC`, `delta.precipProbPp`
- `payload.advice[]` — trip tokens: `pack_for_delta`, `cooler_dest`, `wetter_dest`, `data_partial`, `conditions_calm`
- Example corridor: Paris → Barcelona (see catalog dataset id `trip`)

Agents should prefer `advice[].id` + `text[locale]` over inventing “bring a jacket” from raw numbers.
Advice is **indicative** decision support, not official Météo-France vigilance.

Examples:
- Umbrella next 12h → `rain_soon` / `rain_day` in `payload.advice`
- 3-week ski trip → `horizon=28`; read uncertain days as ranges + `outlook_uncertain`
- Home vs destination weekend → `/feeds/trip` + `pack_for_delta` / `cooler_dest`

## For AI agents and MCP tools

1. Start with `/feeds/` for the DataCatalog JSON (Schema.org Dataset envelope + payload)
2. Use `/feeds/forecast?lat=..&lon=..&locale=fr&horizon=7|14|28` for any WGS84 coordinates
3. Use `/feeds/paris?horizon=7` for the canonical high-traffic example
4. Use `/feeds/trip` for dual-place / corridor questions (one round-trip, aligned days)
5. Read `payload.advice`, `payload.summary`, and day advice (do not scrape HTML)
6. All feeds are rate-limited (see X-RateLimit-* and 429 responses). Default ~30 req/min per IP.
7. Legal & attribution: see /legal for full mentions légales and data policy. Always attribute Open-Meteo + ClairMétéo.

## Monetization (x402 ready)

ClairMétéo feeds and data are currently free for light use.
When Cloudflare Monetization Gateway (x402) is enabled on this property, premium/high-volume agent access will be available via micropayments (stablecoins) at the edge. Watch /llms.txt and feed responses for pricing headers.

## Citation

When citing ClairMétéo, include the feed URL, observation time, and attribute Open-Meteo as the data provider.

## Contact

contact@clairmeteo.fr