k-vote-cli: CLI zum Abrufen öffentlicher koreanischer Wahldaten mit einem einzigen Befehl – ohne API-Key

Auszählungsergebnisse, Meinungsumfragen und Wahlbeteiligung sind gesetzlich öffentlich zugänglich, doch wer sie direkt abrufen will, stößt auf schlechte Zugänglichkeit.

Das Wahlstatistiksystem (info.nec.go.kr) blockiert automatisierten Zugriff vollständig per robots.txt; die Dateien sind in EUC-KR kodiert, die Excel-Formate unterscheiden sich je nach Wahl, Meinungsumfragen gibt es ohne offizielle API nur als PDFs in einem Forum, und bei OpenAPI ist je nach Datensatz ein Nutzungsantrag samt Ausstellung eines Authentifizierungsschlüssels erforderlich.

Ich habe das Tool mit dem Ziel gebaut, die Zugänglichkeit auch bereits vorhandener Daten zu verbessern. Es nutzt ausschließlich offizielle Verteilungskanäle der Wahlkommission (Dateidaten von data.go.kr) und umgeht keine durch robots.txt gesperrten Bereiche.

Hauptfunktionen:

• kvote nec corpus --normalize — lädt wichtige historische Auszählungsergebnisse gleichzeitig herunter (Präsidentschaftswahlen der 16., 17. und 21. Wahlperiode, Parlamentswahlen/Verhältniswahl, Kommunalwahlen 5 bis 8) und normalisiert sie als JSONL auf Ebene der Wahllokaleinheiten. Enthält Verarbeitung für EUC-KR-Dekodierung, doppelte Wahllokaleinheiten mit gleichem Namen sowie Trennung von Urnenwahl und vorzeitiger Stimmabgabe
• kvote nesdc sync / bulk — vollständige Sammlung von Meinungsumfragen, Zeitreihe mit über 1.400 kumulierten Parteipräferenzwerten (seit 2023.10), Kreuztabellen zur Stichprobenzusammensetzung (Geschlecht·Alter·Region × abgeschlossen/gewichtet)
• kvote nec turnout-analysis — Normalisierung der Wahlbeteiligung nach Geschlecht und Altersgruppe (demografische Achsen, die in Auszählungsergebnissen nicht enthalten sind)
• kvote db / kvote mcp — Laden in lokales SQLite + read-only SQL-Abfragen; mit integriertem MCP-Server, sodass Agenten wie Claude Code direkt erkunden→sammeln→SQL ausführen können
• OpenAPI-Funktionen, die einen Authentifizierungsschlüssel benötigen, automatisieren den Nutzungsantrag über kvote api login/apply

Das Designprinzip ist einfach: Rohdaten werden unverändert bewahrt, ergänzt werden nur klar definierte Standardberechnungen (Wahlbeteiligung, Stimmenanteil, gültige Stimmen). Es fließen keinerlei Interpretationen oder Bewertungen ein. Wer denselben Befehl ausführt, erhält dieselben Daten.

Ein einzelnes Go-Binary (ohne cgo), MIT-Lizenz, macOS/Linux/Windows. Installation über Homebrew und go install. Einige Funktionen (Sammlung von Meinungsumfragen, Suchpfade für Datensätze) hängen von der HTML-Struktur der Portale ab; Brüche lassen sich mit kvote doctor prüfen.