k-vote-cli: CLI untuk mengambil data publik pemilu Korea dengan satu perintah tanpa API key

Hasil penghitungan suara, survei opini publik, dan tingkat partisipasi pemilih dipublikasikan sesuai hukum, tetapi jika mencoba mengambilnya langsung, aksesibilitasnya kurang baik.

Sistem Statistik Pemilu (info.nec.go.kr) sepenuhnya memblokir akses otomatis melalui robots.txt, file-file memakai encoding EUC-KR dengan format Excel yang berbeda-beda untuk tiap pemilu, survei opini publik hanya tersedia sebagai PDF di papan pengumuman tanpa API resmi, dan OpenAPI memerlukan permohonan penggunaan serta penerbitan kunci autentikasi untuk tiap data.

Saya membuat ini dengan tujuan meningkatkan aksesibilitas, bahkan untuk data yang sudah ada. Hanya menggunakan kanal distribusi resmi Komisi Pemilihan Umum (data file di data.go.kr), dan tidak mem-bypass tempat yang diblokir oleh robots.

Fitur utama:

• kvote nec corpus --normalize — Mengunduh secara bersamaan hasil penghitungan suara utama historis (pemilihan presiden ke-16, ke-17, ke-21; pemilu legislatif dan proporsional; pemilu lokal putaran ke-5 sampai ke-8) dan menormalkannya menjadi JSONL tingkat tempat pemungutan suara. Termasuk decoding EUC-KR, penanganan duplikasi tempat pemungutan suara bernama sama, serta pemisahan pemungutan suara utama/pemungutan suara awal
• kvote nesdc sync / bulk — Pengumpulan lengkap survei opini publik, deret waktu kumulatif 1.400+ data tingkat dukungan partai (2023.10~), tabel silang komposisi sampel (jenis kelamin·usia·wilayah × selesai/berbobot)
• kvote nec turnout-analysis — Normalisasi tingkat partisipasi pemilih menurut jenis kelamin dan kelompok usia (sumbu demografis yang tidak ada dalam hasil penghitungan suara)
• kvote db / kvote mcp — Pemuatan ke SQLite lokal + kueri SQL read-only, dengan server MCP bawaan sehingga agen seperti Claude Code dapat melakukan eksplorasi→pengumpulan→SQL secara langsung
• OpenAPI yang memerlukan kunci autentikasi mengotomatiskan permohonan penggunaan dengan kvote api login/apply

Prinsip desainnya satu: mempertahankan data mentah apa adanya, dan hanya menambahkan nilai kalkulasi standar yang definisinya dinyatakan secara eksplisit (tingkat partisipasi, perolehan suara, suara sah). Tidak ada interpretasi atau penilaian apa pun yang dimasukkan. Jika menjalankan perintah yang sama, siapa pun akan mendapatkan data yang sama.

Binary tunggal Go (tanpa cgo), lisensi MIT, macOS/Linux/Windows. Dapat diinstal melalui Homebrew dan go install. Beberapa fitur (pengumpulan survei opini publik, jalur pencarian dataset) bergantung pada struktur HTML portal, dan kerusakan dapat diperiksa dengan kvote doctor.