france-opendata

Connecteurs Python pour la data publique française (open data), extraits pour être partagés entre projets (source unique, pas de duplication).

from france_opendata import EntreprisesClient, DvfClient
EntreprisesClient().search(query="SCI", code_postal="94500", naf=["68.20A"])
DvfClient().stats(code_commune="94017")
# bâti d'une parcelle (géométrie GeoJSON du cadastre) → emprise au sol, CES réel
BdTopoClient().bati_parcelle(parcelle_geometry, contenance_m2=2493)
# Sit@del : download du fichier national puis itération normalisée filtrée
from france_opendata.sitadel import RID_LOGEMENTS
c = SitadelClient()
c.download(RID_LOGEMENTS, "/tmp/logements.csv")
permis = list(c.iter_permis("/tmp/logements.csv", kind="logements", depts={"94"}))

Clé Sirene (optionnelle)

Seul SireneClient (SIRET / siège précis) nécessite une clé INSEE. Tout le reste fonctionne sans clé — pour les données société, EntreprisesClient (recherche-entreprises) couvre l'essentiel.

Obtenir la clé (gratuite) :

1. Créer un compte sur le portail API de l'INSEE : https://portail-api.insee.fr/
2. Souscrire à l'API « Sirene » (catalogue) et générer une clé d'intégration.
3. La fournir via l'environnement ou le constructeur :

export SIRENE_API_KEY="votre_cle"

from france_opendata import SireneClient
SireneClient().get_siret("39860733300059")      # lit SIRENE_API_KEY depuis l'env
SireneClient(api_key="…").get_headquarters("398607333")

Catalogue complet (toutes les sources par domaine, vue « grosse maille » + candidats à brancher) : docs/catalogue.md.

Dépend de requests uniquement. Consommé par ogic-foncier-mcp et oto-cli.