# GridLabs – Comparateur d'offres d'énergie (France)

GridLabs aide les particuliers à comparer les fournisseurs d'électricité et de gaz en France et à trouver l'offre adaptée à leur logement (ville, consommation, option tarifaire).

## Ressources principales

- Accueil: https://www.gridlabs.fr
- Comparatif électricité: https://www.gridlabs.fr/comparatif/electricite
- Comparatif gaz: https://www.gridlabs.fr/comparatif/gaz
- Questionnaire (devis): https://www.gridlabs.fr/questionnaire
- Villes (pSEO): https://www.gridlabs.fr/villes
- ELD (Entreprises locales de distribution): https://www.gridlabs.fr/eld
- Gestionnaires de réseau: https://www.gridlabs.fr/gestionnaires-reseau
- Fournisseurs: https://www.gridlabs.fr/fournisseurs
- Aides: https://www.gridlabs.fr/aides
- FAQ: https://www.gridlabs.fr/faq
- Tarifs réglementés: https://www.gridlabs.fr/tarifs-reglementes

## Données structurées pour agents

- Catalogue d’API (RFC 9727, Linkset): https://www.gridlabs.fr/.well-known/api-catalog
- OpenAPI (résumé des API publiques agents): https://www.gridlabs.fr/openapi.json
- Sources (officielles + pages GridLabs): https://www.gridlabs.fr/ai/sources.json
- Villes / gestionnaires de réseau (ELD, Enedis, GRDF): https://www.gridlabs.fr/ai/eld.json
- Agent Skills (v0.2.0): https://www.gridlabs.fr/.well-known/agent-skills/index.json
- Répertoire Web Bot Auth (JWKS / HTTP message signatures): https://www.gridlabs.fr/.well-known/http-message-signatures-directory
- MCP (JSON-RPC, lecture seule) : `POST https://www.gridlabs.fr/mcp` et carte `/.well-known/mcp/server-card.json` : outils miroirs des API publiques. Détail : `docs/AGENT_MCP_DISCOVERY.md`.

**OAuth / OIDC :** métadonnées de découverte publiées (`/.well-known/openid-configuration`, `/.well-known/oauth-authorization-server`, `/.well-known/oauth-protected-resource`, `/.well-known/jwks.json`) pour scanners et intégrations futures. Les **API publiques** listées ci-dessus restent **sans jeton** pour l’instant ; les points de terminaison `/oauth/authorize` et `/oauth/token` sont des **emplacements réservés** (pas d’émission de tokens en production). Voir `docs/AGENT_OAUTH_DISCOVERY.md`.

## Intention d'abonnement (agents)

- POST/GET https://www.gridlabs.fr/api/subscribe-intent
- Paramètres: city_slug, current_provider?, housing_type?, move_date?
- Réponse: next_url (funnel questionnaire), required_fields, estimated_steps

Dernière mise à jour: mai 2026