k-vote-cli : 韓国の選挙公開データをAPIキーなしで1コマンド取得できるCLI

開票結果・世論調査・投票率は法律に基づいて公開されていますが、実際に取得してみるとアクセス性は高くありません。

選挙統計システム(info.nec.go.kr)は robots.txt で自動アクセスを全面的に遮断しており、ファイルは EUC-KR エンコーディングで、選挙ごとに Excel の様式もばらばらです。世論調査は公式 API がなく掲示板の PDF しかなく、OpenAPI はデータごとに利用申請・認証キー発行が必要です。

既に存在するデータでも、アクセス性を高めようという趣旨で作りました。選管の公式配布チャネル(data.go.kr のファイルデータ)のみを使用し、robots で遮断された場所は迂回しません。

主な機能:

• kvote nec corpus --normalize — 歴代の主要な開票結果(大統領選第16・17・21回、総選挙・比例、地方選第5〜8回)を同時にダウンロードし、投票区単位の JSONL に正規化。EUC-KR デコード、同名投票区の重複、本投票/期日前投票の分離処理を含む
• kvote nesdc sync / bulk — 世論調査の全件収集、政党支持率の累積 1,400件超の時系列(2023.10~)、標本構成クロス表(性別・年齢・地域 × 完了/加重)
• kvote nec turnout-analysis — 性別・年齢層別の投票率を正規化(開票結果にない人口統計軸)
• kvote db / kvote mcp — ローカル SQLite へ格納 + read-only SQL クエリ、MCP サーバー内蔵のため Claude Code のようなエージェントが探索→収集→SQL まで直接実行可能
• 認証キーが必要な OpenAPI は kvote api login/apply で利用申請を自動化

設計原則は1つだけです。元データをそのまま保存し、追加するのは定義が明示された標準計算値(投票率・得票率・有効票)のみ。いかなる解釈や判断も加えていません。同じコマンドを実行すれば、誰に対しても同じデータが得られます。

Go 単一バイナリ(cgo なし)、MIT ライセンス、macOS/Linux/Windows 対応。Homebrew と go install でインストールできます。一部機能(世論調査収集、データセット検索経路)はポータルの HTML 構造に依存しており、破損は kvote doctor で点検します.