Aller au contenu principal

RGE-OS — version 1.0

Première API publique ouverte du registre national RGE ADEME

Artisans certifiés RGE normalisés. 14 endpoints REST, GraphQL, SPARQL, MCP, Webhooks. SDK TypeScript et Python. Spécifications OpenAPI 3.1 et AsyncAPI 3.0.0. Licence CC-BY 4.0.

Source : Registre national RGE ADEME (data.gouv.fr) sous licence Etalab 2.0 ; enrichissement ServicesArtisans publié en CC-BY 4.0.

14 piliers RGE-OS

Couverture verticale complète, du graphe de connaissance RDF à la signature HMAC des webhooks, en passant par Model Context Protocol pour les agents IA et l'embed JavaScript pour les sites partenaires.

  1. Pilier 01

    Knowledge Graph SPARQL

    Endpoint SPARQL 1.1 sur le graphe RDF du registre RGE.

  2. Pilier 02

    GraphQL-as-RPC

    GraphQL endpoint pour requêtes typées et économes en bande passante.

  3. Pilier 03

    SDK TypeScript

    Client TypeScript zero-dépendance, packagé pour npm.

  4. Pilier 04

    MCP Server

    Model Context Protocol JSON-RPC 2.0 pour agents IA.

  5. Pilier 05

    OpenAPI 3.1 Spec

    Spécification machine-lisible + 5 explorers HTML browsables.

  6. Pilier 06

    HuggingFace Dataset

    Dataset versionné publié sous licence CC-BY 4.0.

  7. Pilier 07

    Benchmarks publics

    Métriques de couverture et fraîcheur publiées régulièrement.

  8. Pilier 08

    Webhooks signés HMAC

    Subscribe / unsubscribe + signature HMAC-SHA256 + fenêtre anti-replay 5 min.

  9. Pilier 09

    CLI sa-rge-os

    Outil ligne de commande zero-dépendance pour scripting.

  10. Pilier 10

    Widget Embed

    Composant JavaScript embeddable pour sites partenaires.

  11. Pilier 11

    LLM stores submission

    Soumission proactive auprès des éditeurs LLM (HuggingFace, Anthropic, Mistral).

  12. Pilier 12

    Wikidata sync

    Synchronisation Wikidata avec items et propriétés ouvertes.

  13. Pilier 13

    Wikipedia citations

    Articles cités via API REST + structure JSON-LD.

  14. Pilier 14

    Transparence IA

    Page /transparence-ia + audit RGPD AI Act + provenance traçable.

Pour qui

  • Mairies et collectivités

    Vérifier l'éligibilité RGE d'un artisan avant attribution d'un marché public ou d'un appel d'offres dématérialisé.

  • CRM bâtiment et SaaS B2B

    Enrichir les fiches partenaires avec les qualifications RGE temps réel sans scraping fragile.

  • Comparateurs énergétiques

    Filtrer les artisans par qualification précise (Qualibat 5911, Qualifelec IRVE, RGE Solaire) et par zone géographique INSEE.

  • Plateformes mandataire CEE

    Auto-valider le statut RGE des installateurs avant dépôt de dossier auprès des obligés (Sonergia, Hellio, Total).

  • Chercheurs et data scientists

    Datasets CC-BY 4.0 pour études sur la transition énergétique, la rénovation des passoires thermiques, la couverture territoriale.

  • Agents IA et assistants conversationnels

    MCP server natif pour Claude, ChatGPT, Mistral et autres LLMs. Réponses sourcées, citations vérifiables.

Démarrer en trente secondes

curl

curl 'https://servicesartisans.fr/api/v1/rge/search?qualification=qualibat-5911&department=75'

TypeScript

import { Client } from '@servicesartisans/sa-rge-sdk'
const sa = new Client()
const r = await sa.rgeSearch({ qualification: 'qualibat-5911', department: '75' })

Python

from sa_rge_sdk import Client
sa = Client()
r = sa.rge_search(qualification='qualibat-5911', department='75')

Questions fréquentes

Quelle est la source des données ?
Registre national RGE de l'ADEME, accessible sur data.gouv.fr sous licence Etalab 2.0. RGE-OS enrichit, normalise, indexe et expose ces données via API publique sous licence CC-BY 4.0. Aucune donnée propriétaire injectée.
L'API est-elle gratuite ?
Les endpoints publics (rge/lookup, rge/search, aides/*) sont gratuits, sans authentification. Rate-limit 60 requêtes par minute et par IP par défaut. Un tier dédié pour les intégrateurs à fort volume est disponible sur demande à data@servicesartisans.fr.
Comment citer les données ?
Mention obligatoire « Source : ADEME — Registre national RGE, agrégé par ServicesArtisans » et lien vers /rge-os. Conformément à la licence CC-BY 4.0 et à la licence Etalab 2.0 amont.
Quelle fraîcheur des données ?
Synchronisation hebdomadaire automatique depuis l'ADEME. Snapshot daté visible sur la page /barometre/rge. Cron critique sous monitoring Sentry.
Quels formats sont supportés ?
JSON (REST + GraphQL), RDF/Turtle et JSON-LD (SPARQL + ontologie OWL), Server-Sent Events (streaming), HTML (widget embed). Spec OpenAPI 3.1 et AsyncAPI 3.0.0 disponibles en JSON et YAML.
Le code est-il open source ?
Les SDKs TypeScript et Python sont publiés en licence MIT. Les spécifications OpenAPI 3.1, AsyncAPI 3.0.0 et l'ontologie OWL sont sous licence CC-BY 4.0. Le code serveur Next.js reste propriétaire.

Maintenu par ServicesArtisans — Marvin Bissohong, fondateur tech. Dernière mise à jour : 2026-05-21.

Contact intégrateur : data@servicesartisans.fr. Issues et roadmap publics.