k-vote-cli: API key के बिना एक ही command से Korean election public data पाने वाला CLI

मतगणना परिणाम, opinion polls और voter turnout कानून के तहत सार्वजनिक हैं, लेकिन इन्हें सीधे हासिल करने पर accessibility अच्छी नहीं है.

Election Statistics System (info.nec.go.kr) robots.txt के जरिए automated access को पूरी तरह block करता है, files EUC-KR encoding में हैं और हर election के लिए Excel formats अलग-अलग हैं, opinion polls के लिए official API नहीं है—सिर्फ bulletin-board PDFs हैं—और OpenAPI में हर dataset के लिए usage application और authentication key जारी करानी पड़ती है.

यह इस उद्देश्य से बनाया गया है कि मौजूदा data की accessibility बढ़ाई जा सके. यह केवल National Election Commission के official distribution channels (data.go.kr file data) का उपयोग करता है, और robots से blocked जगहों को bypass नहीं करता.

मुख्य features:

• kvote nec corpus --normalize — पिछले प्रमुख मतगणना परिणामों (Presidential elections 16th, 17th, 21st; National Assembly/proportional representation; local elections 5th–8th) को साथ-साथ download करता है और polling-district level JSONL में normalize करता है. इसमें EUC-KR decoding, समान नाम वाले polling districts की duplication, और election-day/early voting को अलग-अलग handle करना शामिल है
• kvote nesdc sync / bulk — opinion polls का पूरा collection, party support rate के 1,400+ accumulated time-series records (2023.10~), sample composition cross tables (gender, age, region × completed/weighted)
• kvote nec turnout-analysis — gender और age group के अनुसार voter turnout normalization (demographic axes जो मतगणना परिणामों में नहीं हैं)
• kvote db / kvote mcp — local SQLite loading + read-only SQL queries; MCP server built-in है, इसलिए Claude Code जैसे agents exploration → collection → SQL तक खुद perform कर सकते हैं
• जिन OpenAPI के लिए authentication key चाहिए, उनके लिए kvote api login/apply से usage application automate किया गया है

Design principle एक ही है: raw data को जैसा है वैसा preserve करना, और केवल स्पष्ट definitions वाले standard calculated values (voter turnout, vote share, valid votes) जोड़ना. कोई interpretation या judgment शामिल नहीं किया गया है. वही command चलाने पर हर किसी को वही data मिलता है.

Go single binary (cgo नहीं), MIT license, macOS/Linux/Windows. Homebrew और go install से install किया जा सकता है. कुछ features (opinion poll collection, dataset search paths) portal HTML structure पर depend करते हैं, और breakage की जांच kvote doctor से की जाती है.