API ouverte · licence Etalab

Données et API

Tout ce que Loire Vive agrège est redistribuable : une API JSON sans clé ni compte, un widget à intégrer en une ligne, et des flux d'alerte RSS par station. La Loire est un bien commun, ses données aussi.

L'API JSON

Réponses en JSON, cache de cinq minutes, licence ouverte Etalab avec citation de la source amont. Pas de clé d'API : servez-vous. La spécification complète est publiée en OpenAPI 3.0.

Point d'entrée	Contenu
`GET /api/v1/lieux`	Les huit lieux suivis : dernière mesure, état d'étiage, seuils, station Hub'Eau
`GET /api/v1/lieux/:id/observations`	Débits moyens journaliers des trente derniers jours
`GET /api/v1/lieux/:id/observations.csv`	La même série en CSV, prête pour un tableur ou une classe de SVT
`GET /api/v1/carte/stations`	Toutes les stations hydrométriques en service sur le fleuve
`GET /api/v1/carte/stations/:code/apercu`	Aperçu à la demande d'une station (cache 30 minutes)
`GET /api/v1/sources`	Le registre documentaire des sources : producteurs, licences, cadences
`GET /api/v1/openapi.json`	La spécification OpenAPI 3.0 de cette API

Le serveur MCP : la Loire pour les assistants IA

Loire Vive expose un serveur MCP (Model Context Protocol) : connectez Claude ou tout assistant compatible, et posez vos questions en langage naturel — « quel est le débit à Blois ? », « la Loire est-elle en vigilance crue ? », « l'eau est-elle bonne à Tours ? ». L'assistant interroge des outils typés qui répondent depuis la base, sources citées.

Connexion

Sans état, sans clé

Transport streamable HTTP. Dans la configuration de votre client MCP :

{
  "mcpServers": {
    "loire-vive": {
      "url": "https://loire.ssomar.fr/mcp"
    }
  }
}

Outils exposés

Six outils, sources citées

`etat_du_fleuve`	Vue d'ensemble des huit stations et de la vigilance
`debit_station`	Dernier débit, état d'étiage, seuils d'une station
`serie_debits`	Trente jours de débits moyens journaliers
`vigilance_crues`	Niveaux Vigicrues par tronçon
`qualite_eau`	Dernières analyses avec lecture pédagogique
`documentation_sources`	Le registre des sources et licences

Pour les moteurs et les modèles

Le site se décrit lui-même aux machines : /llms.txt (carte du site pour les modèles de langage), /sitemap.xml et données structurées JSON-LD sur chaque page station.

Le widget « Loire en direct »

Mairies, journaux locaux, campings, clubs de canoë : intégrez le débit en direct de votre station en une ligne de code. Le widget se met à jour tout seul.

Aperçu :

Le code à copier :

<iframe src="https://loire.ssomar.fr/widget/orleans"
  title="Loire en direct" width="280" height="150"
  style="border:none" loading="lazy"></iframe>

Remplacez orleans par roanne, nevers, gien, orleans, blois, tours, saumur, montjean.

Les flux d'alerte RSS

Chaque station publie un flux RSS de ses changements d'état d'étiage (« Loire basse », retour à la normale…). Abonnez votre lecteur RSS, votre messagerie ou vos automatisations — sans compte.

RoanneRSS NeversRSS GienRSS OrléansRSS BloisRSS ToursRSS SaumurRSS Montjean-sur-LoireRSS

Les sources amont

Loire Vive est un agrégateur, pas un producteur : chaque donnée est rafraîchie depuis les services publics ouverts et citée.

Source	Donnée	Cadence de rafraîchissement
Hub'Eau — hydrométrie (réseau Vigicrues)	Débits temps réel et moyennes journalières	10 minutes / 1 heure
Vigicrues	Vigilance crues par tronçon	1 heure
Hub'Eau — qualité des rivières (Naïades)	Analyses physico-chimiques	24 heures
Hub'Eau — température des cours d'eau	Température de l'eau	24 heures
Hub'Eau — piézométrie (ADES)	Niveau des nappes d'accompagnement	24 heures
Hub'Eau — prélèvements (BNPE)	Volumes prélevés par usage	24 heures