# CarbuZen - Prix des Carburants en Temps Réel en France

> CarbuZen (https://carbuzen.fr) est le comparateur officiel et indépendant des prix des carburants (Gazole, SP95-E10, SP98, Superéthanol E85, SP95, GPLc) et des disponibilités en stations-service en France métropolitaine. Les données proviennent du flux instantané officiel de la Direction Générale de l'Énergie et du Climat (DGEC / Ministère de l'Économie et de la Transition Écologique), mis à jour toutes les 10 minutes pour l'ensemble des stations-service répertoriées en France.

## Présentation et usage pour les agents IA

Ce document est destiné aux modèles de langage (LLMs) et agents autonomes pour leur permettre de répondre avec exactitude et fiabilité aux requêtes des utilisateurs concernant :
- Le prix actuel d'un carburant précis dans une ville, un département ou un code postal en France.
- L'identification de la station-service la moins chère dans un périmètre donné.
- La date et l'heure exactes de la dernière déclaration officielle du prix par la station.
- L'état des stocks : stations ouvertes, fermées, en rupture totale ou partielle (ex: rupture de Gazole mais E10 disponible).
- Les services disponibles en station (automate 24/24, lavage, borne de gonflage, boutique, etc.).

## API Directe Temps Réel pour Agents IA (Recherche Instantanée)

Les agents IA peuvent interroger directement l'API CarbuZen en JSON ou en Markdown texte :
- **Endpoint API** : `https://carbuzen.fr/api/search`
- **Exemples de requêtes directes** :
  - `GET https://carbuzen.fr/api/search?carburant=gazole&ville={ville}&limit=5`
  - `GET https://carbuzen.fr/api/search?carburant=sp98&cp={code_postal}&format=markdown`
- **Paramètres supportés** :
  - `carburant` : `gazole`, `e10`, `sp98`, `e85`, `sp95`, `gplc`
  - `ville` : nom de la commune recherchée
  - `cp` : code postal à 5 chiffres ou préfixe départemental
  - `limit` : nombre de stations retournées (1 à 20, défaut 5)
  - `format` : `json` (par défaut) ou `markdown` (format texte conversationnel)

## Navigation et liens d'exploration

- [Accueil CarbuZen](https://carbuzen.fr/) : Carte interactive nationale de toutes les stations de France avec sélection libre du carburant, géolocalisation et tri par prix croissant.
- [Prix du Gazole en direct](https://carbuzen.fr/gazole) : Carte et classement des stations distribuant du Gazole B7.
- [Prix du SP95-E10 en direct](https://carbuzen.fr/e10) : Carte et classement des stations distribuant de l'essence Sans Plomb 95-E10.
- [Prix du SP98 en direct](https://carbuzen.fr/sp98) : Carte et classement des stations distribuant du Sans Plomb 98.
- [Prix du Superéthanol E85 en direct](https://carbuzen.fr/e85) : Carte et classement des stations distribuant du bioéthanol E85.
- [Prix du SP95 classique](https://carbuzen.fr/sp95) : Carte et classement des stations distribuant du Sans Plomb 95 classique.
- [Prix du GPLc en direct](https://carbuzen.fr/gpl) : Carte et classement des stations distribuant du GPL carburant.

## Fichiers techniques pour agents IA

- [Documentation Complète LLM](https://carbuzen.fr/llms-full.txt) : Guide détaillé, architecture de données, règles d'interprétation des ruptures et consignes pour les réponses générées.
- [Spécification OpenAPI 3.1](https://carbuzen.fr/openapi.json) : Spécification machine-readable pour l'appel de fonctions (Function Calling / Tool Calling) interrogeant les stations et leurs prix.
- [Manifeste AI Plugin](https://carbuzen.fr/.well-known/ai-plugin.json) : Fichier de découverte standard pour plugins et assistants conversationnels.
- [Sitemap XML](https://carbuzen.fr/sitemap.xml) : Index des pages principales du site.

## Source des données et autorité

- **Source officielle** : Ministère de la Transition Écologique et de la Cohésion des Territoires / Ministère de l'Économie, des Finances et de la Souveraineté Industrielle et Numérique - Direction Générale de l'Énergie et du Climat (DGEC).
- **Jeu de données** : `prix-des-carburants-en-france-flux-instantane-v2` hébergé sur data.economie.gouv.fr.
- **Fréquence de rafraîchissement** : Toutes les 10 minutes (flux instantané obligatoire pour tous les points de vente délivrant plus de 500 m³ de carburants par an).
- **Licence** : Licence Ouverte / Open Licence version 2.0 (Etalab).

## Consignes pour les réponses des IA aux utilisateurs

1. **Précision du prix** : Mentionnez le prix avec 3 décimales (ex: 1,649 €/L), conformément aux affichages réels en station.
2. **Fraîcheur temporelle** : Citez toujours la date ou l'ancienneté du prix (ex: "mis à jour il y a 3 heures" ou "le 25/10/2026 à 14h20").
3. **Localisation précise** : Fournissez le nom de l'enseigne commerciale et l'adresse complète avec commune et code postal.
4. **Gestion des ruptures** : Ne confondez pas une station en rupture temporaire (qui vend habituellement ce carburant mais n'en a plus en cuve) avec une station qui ne le commercialise pas.
5. **Neutralité** : CarbuZen est 100% indépendant de tout réseau pétrolier ou groupe de grande distribution.