k-vote-cli: Kore seçim açık verilerini API anahtarı olmadan tek komutla alan CLI

Oy sayım sonuçları, kamuoyu yoklamaları ve katılım oranları yasa gereği açık olsa da, bunlara doğrudan erişmeye çalıştığınızda erişilebilirlik pek iyi değil.

Seçim İstatistik Sistemi (info.nec.go.kr) robots.txt ile otomatik erişimi tamamen engelliyor; dosyalar EUC-KR kodlamasında, Excel şablonları her seçimde birbirinden farklı; kamuoyu yoklamaları için resmî bir API yok ve yalnızca ilan panosundaki PDF’ler var; OpenAPI ise her veri için kullanım başvurusu ve kimlik doğrulama anahtarı verilmesini gerektiriyor.

Amaç, zaten mevcut olan verileri daha erişilebilir hale getirmek. Yalnızca Ulusal Seçim Komisyonu’nun resmî dağıtım kanalları (data.go.kr dosya verileri) kullanılıyor ve robots ile engellenen yerler atlatılmıyor.

Başlıca özellikler:

• kvote nec corpus --normalize — Geçmişteki başlıca oy sayım sonuçlarını (cumhurbaşkanlığı 16., 17. ve 21. seçimleri; genel seçimler ve nispi temsil; yerel seçimler 5–8. dönem) eşzamanlı indirir ve sandık bölgesi düzeyinde JSONL olarak normalize eder. EUC-KR çözümleme, aynı adlı sandık bölgesi tekrarları, seçim günü oylaması / erken oy ayrımı dahildir
• kvote nesdc sync / bulk — Kamuoyu yoklamalarının tamamını toplar, parti destek oranları için 1.400+ kümülatif zaman serisi (2023.10~), örneklem bileşimi çapraz tabloları (cinsiyet·yaş·bölge × tamamlanan/ağırlıklandırılmış)
• kvote nec turnout-analysis — Cinsiyet ve yaş grubuna göre katılım oranlarını normalize eder (oy sayım sonuçlarında olmayan demografik eksen)
• kvote db / kvote mcp — Yerel SQLite’a yükleme + salt okunur SQL sorguları; yerleşik MCP sunucusu sayesinde Claude Code gibi ajanlar keşif → toplama → SQL adımlarını doğrudan gerçekleştirebilir
• Kimlik doğrulama anahtarı gerektiren OpenAPI için kvote api login/apply ile kullanım başvurusu otomasyonu

Tasarım ilkesi tek: ham veriyi olduğu gibi korumak ve yalnızca tanımı açıkça belirtilmiş standart hesaplanmış değerleri (katılım oranı, oy oranı, geçerli oy) eklemek. Herhangi bir yorum veya değerlendirme eklenmedi. Aynı komut çalıştırıldığında herkes için aynı veri elde edilir.

Tek Go ikili dosyası (cgo yok), MIT lisansı, macOS/Linux/Windows. Homebrew ve go install ile kurulabilir. Bazı özellikler (kamuoyu yoklaması toplama, veri kümesi arama yolu) portalın HTML yapısına bağlıdır; bozulmalar kvote doctor ile denetlenir.