Requête les données électorales françaises (1999-2026).

Niveaux territoriaux : NATIONAL (aucun filtre), RÉGIONAL (region_code), DÉPARTEMENTAL (departement_code), COMMUNAL (commune_code).

Actions de base : list_elections, query_results, list_bureaux, query_bureau, query_by_bureau, rank_bureaux, list_circonscriptions, query_circonscription, list_cantons, query_canton, search_candidate, query_candidatures, etc.

Actions « panel » (1 appel = analyse complète, évite les boucles) :

• compare_elections : compare deux scrutins pour un territoire (election_id + compare_to_election + commune_code|departement_code, candidate_name optionnel).

• query_all_circonscriptions : vainqueur de CHAQUE circonscription d'un territoire en un appel (election_id + commune_code|departement_code, législatives uniquement).

• vote_reserve : score d'une famille + abstention par bureau de vote sur les scrutins récents comparables (commune_code + famille).

• select_communes : sélectionne/classe des communes par critères géo + population + électoraux (region_code/departement_code/epci/commune_codes, population_min/max, commune_metric, condition, sort_by, limit, order ; commune_metric/condition nécessitent election_id).

• cross_election_panel : évolution d'un sujet (famille ou nuance_code) par commune sur N scrutins (elections=ids séparés par des virgules + scope commune_code/departement_code/region_code/commune_codes).

• bureau_breakdown : pivot par bureau (top_n nuances/blocs + participation, with_sociodem optionnel) pour commune_code + election_id.

Requête les divisions administratives françaises.

Actions : search_commune, get_commune, search_postal, list_epci, get_epci, list_cantons, list_departements, list_regions.

Requête les élus de la République française (base BRÉF).

Actions : search_elu, list_mandate_types, list_elus.

Requête les données socio-démographiques au niveau bureau de vote.

Données INSEE RP 2022 + Filosofi 2021, interpolées IRIS→BDV. Actions : list_variables, profile, indices, rank, compare.

Requête les données DLP (composition sociale des candidats municipaux 2020).

~546 000 candidats dans ~10 000 communes (≥1 000 hab.). Classes : CDOM (dominant), CMOY (moyen), CSUB (subalterne), RET (retraité), AUTRES. Actions : summary, composition, parite, listes, candidats, professions, sortants.

Génère une carte électorale (PNG) pour une élection.

Paramètres :

• election_id : identifiant élection (ex: '2024_legi_t1', '2020_muni_t2')

• metric : 'family' (famille politique en tête) ou 'nuance' (score d'une nuance)

• geography : 'bv' (bureau de vote, défaut) ou 'commune' (carte nationale)

• department : code département (ex: '13'). Requis pour geography='bv' sauf si commune fourni.

• commune : code commune (ex: '13055' pour Marseille). Centre la carte sur cette commune.

• nuance : code nuance quand metric='nuance' (ex: 'RN', 'LFI', 'ENS')

• region : code région pour geography='commune' (ex: '93' pour PACA)

Exemples :

• Carte par famille, Bouches-du-Rhône : election_id='2024_legi_t1', department='13'

• Carte score RN, Marseille : election_id='2024_legi_t1', commune='13055', metric='nuance', nuance='RN'

• Carte nationale : election_id='2024_euro_t1', geography='commune'

Simule les scénarios de fusion de listes municipales entre T1 et T2.

Actions : 'status' (classer les listes après T1), 'simulate' (projections T2). Uniquement pour les élections municipales.

Exporte des données électorales vers un fichier téléchargeable (CSV, JSON, TSV).

Deux modes : data (contenu inline) ou source_path (chemin vers fichier existant).

Crée une visualisation Plotly (retourne le spec JSON).

Deux modes :

• Spec libre : fournir 'spec' (dict Plotly complet {data, layout})

• Assisté : fournir chart_type + data + x + y

Types supportés : bar, line, scatter, histogram, box, violin, heatmap, treemap.

Crée un tableau de données formaté à partir de données structurées.

Utile pour présenter des résultats calculés ou combinés. Retourne un tableau texte formaté.

Exécute une requête SQL directe sur la base DuckDB (read-only).

Tables principales :

• general_results : résultats généraux par bureau de vote

• candidats_results : résultats par candidat par bureau de vote

• elections_disponibles : liste des élections (id_election, nb_bureaux, total_inscrits)

• candidats_avec_nuances : candidats avec famille politique (si nuances enrichies)

• resultats_par_famille : résultats agrégés par famille politique

• communes, epci, departements, regions : divisions administratives

• bv_sociodemographique : données socio-démo par bureau de vote

ATTENTION — colonnes de general_results (noms avec espaces, à quoter) : id_election, id_brut_miom, "Code du département", "Code de la commune" (SANS préfixe dept, ex: '055' pour Marseille), "Libellé de la commune", Inscrits, Abstentions, Votants, Blancs, Nuls, Exprimés.

PRÉFÉRER query_elections pour les analyses standard — query_sql est pour les requêtes ad hoc avancées.

Exemple : SELECT id_election, ROUND(100.0 * SUM(Abstentions) / NULLIF(SUM(Inscrits), 0), 1) as abstention_pct FROM general_results WHERE "Code du département" = '13' AND "Code de la commune" = '055' GROUP BY id_election ORDER BY id_election DESC LIMIT 5