k-vote-cli : un CLI pour récupérer les données publiques des élections coréennes en une seule commande, sans clé d’API

Les résultats de dépouillement, les sondages d’opinion et les taux de participation sont publics en vertu de la loi, mais lorsqu’on essaie de les récupérer directement, ils ne sont pas très accessibles.

Le système de statistiques électorales (info.nec.go.kr) bloque entièrement l’accès automatisé via robots.txt ; les fichiers sont encodés en EUC-KR, les modèles Excel varient d’une élection à l’autre ; pour les sondages, il n’existe pas d’API officielle, seulement des PDF sur un forum ; et l’OpenAPI exige, pour chaque type de données, une demande d’utilisation et l’émission d’une clé d’authentification.

Je l’ai créé dans l’idée d’améliorer l’accessibilité de données déjà existantes. Il utilise uniquement les canaux de distribution officiels de la Commission électorale (données fichiers sur data.go.kr) et ne contourne pas les sites bloqués par robots.

Fonctionnalités principales :

• kvote nec corpus --normalize — télécharge simultanément les principaux résultats de dépouillement historiques (présidentielles 16e, 17e et 21e, législatives et proportionnelle, élections locales 5e à 8e) et les normalise en JSONL à l’échelle du bureau de vote. Inclut le décodage EUC-KR, la gestion des doublons de bureaux de vote homonymes et la séparation vote le jour du scrutin / vote anticipé
• kvote nesdc sync / bulk — collecte exhaustive des sondages d’opinion, séries temporelles de plus de 1 400 relevés cumulés de soutien aux partis (depuis 2023.10), tableaux croisés de composition de l’échantillon (sexe·âge·région × répondants complets/pondération)
• kvote nec turnout-analysis — normalisation des taux de participation par sexe et tranche d’âge (axes démographiques absents des résultats de dépouillement)
• kvote db / kvote mcp — chargement dans une base SQLite locale + requêtes SQL en lecture seule ; serveur MCP intégré, permettant à des agents comme Claude Code d’effectuer directement exploration → collecte → SQL
• Pour les OpenAPI nécessitant une clé d’authentification, kvote api login/apply automatise la demande d’utilisation

Le principe de conception est unique : conserver les données brutes telles quelles, et n’ajouter que des valeurs calculées standard dont la définition est explicite (taux de participation, part des voix, votes valides). Aucune interprétation ni jugement n’a été ajouté. La même commande produit les mêmes données pour tout le monde.

Binaire Go autonome (sans cgo), licence MIT, macOS/Linux/Windows. Installation possible via Homebrew et go install. Certaines fonctionnalités (collecte des sondages, chemins de recherche des datasets) dépendent de la structure HTML du portail ; les ruptures se vérifient avec kvote doctor.