k-vote-cli : CLI สำหรับรับข้อมูลสาธารณะการเลือกตั้งของเกาหลีได้ในคำสั่งเดียวโดยไม่ต้องใช้ API key

ผลการนับคะแนน, ผลสำรวจความคิดเห็นสาธารณะ และอัตราการออกมาใช้สิทธิ แม้จะเป็นข้อมูลที่เปิดเผยตามกฎหมาย แต่เมื่อจะดึงมาใช้จริงกลับเข้าถึงได้ไม่สะดวกนัก。

ระบบสถิติการเลือกตั้ง (info.nec.go.kr) ปิดกั้นการเข้าถึงอัตโนมัติทั้งหมดด้วย robots.txt, ไฟล์ใช้การเข้ารหัส EUC-KR และรูปแบบ Excel ของแต่ละการเลือกตั้งก็ไม่เหมือนกัน, ส่วนผลสำรวจความคิดเห็นสาธารณะมีเพียง PDF บนกระดานประกาศโดยไม่มี API ทางการ, และ 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 ในเครื่อง + คิวรี SQL แบบอ่านอย่างเดียว, มี MCP server ในตัว ทำให้เอเจนต์อย่าง Claude Code สำรวจ→รวบรวม→SQL ได้โดยตรง
• OpenAPI ที่ต้องใช้คีย์รับรองสามารถทำขั้นตอนยื่นขอใช้งานอัตโนมัติได้ด้วย kvote api login/apply

หลักการออกแบบมีเพียงข้อเดียว คือเก็บข้อมูลต้นฉบับไว้ตามเดิม และสิ่งที่เพิ่มเข้ามาจะมีแค่ค่าคำนวณมาตรฐานที่ระบุคำนิยามไว้อย่างชัดเจนเท่านั้น (อัตราการใช้สิทธิ·สัดส่วนคะแนน·บัตรดี) ไม่มีการใส่การตีความหรือการตัดสินใด ๆ หากรันคำสั่งเดียวกัน ก็จะได้ข้อมูลชุดเดียวกันสำหรับทุกคน

เป็น Go single binary (ไม่มี cgo), ไลเซนส์ MIT, รองรับ macOS/Linux/Windows ติดตั้งได้ด้วย Homebrew และ go install บางฟังก์ชัน (การเก็บผลสำรวจความคิดเห็นสาธารณะ, เส้นทางค้นหาชุดข้อมูล) อาศัยโครงสร้าง HTML ของพอร์ทัล และสามารถตรวจสอบความเสียหายได้ด้วย kvote doctor