OpenParable
Skip to content
← Back to skills

Local Election Candidate Search

Research
local-election-candidate-search

Local Election Candidate Search is an Agent Skill for research published in the NomaDamas/k-skill repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

중앙선거관리위원회 선거통계시스템 공개 통합검색으로 한국 지방선거 후보자 정보를 이름/선거종류/지역 기준으로 조회한다.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/NomaDamas/k-skill/blob/HEAD/local-election-candidate-search/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/local-election-candidate-search, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Local Election Candidate Search

What this skill does

중앙선거관리위원회(NEC) 선거통계시스템의 공개 통합검색에서 후보자 이름을 조회하고, 지방선거 관련 후보자 이력만 기본으로 정리한다. 후보자명, 한자명, 생년월일/성별, 선거일, 선거명, 선거종류, 정당, 선거구, 득표, 직업, 학력, 경력 등을 반환한다.

When to use

  • 사용자가 “지방선거 후보”, “시도지사 후보”, “기초의원 후보”, “교육감 후보” 등을 이름/지역/선거일 기준으로 찾아 달라고 할 때
  • 중앙선관위 선거통계시스템에서 공개된 후보자 이력을 확인해야 할 때
  • 동명이인이 있을 수 있어 후보자명 + 선거종류/지역/연도 필터가 필요한 때

Public access path

Chosen path: NEC integrated candidate search.

  • Entry page: https://info.nec.go.kr/search/searchCandidate.xhtml
  • Method: unauthenticated public POST
  • Required form field: searchKeyword=<정확한 후보자 성명>
  • Helper package: local-election-candidate-search

Why this path: the visible NEC UI explicitly exposes candidate-name integrated search across recent and historical elections, and it returns the candidate result cards in server-rendered HTML. It is more stable than scraping per-election menu pages because it does not require selecting every city/town/constituency combo first.

Workflow

  1. Use the package CLI from this repository or installed workspace:
npx local-election-candidate-search 오세훈 --election 시도지사 --region 서울 --limit 5
  1. Narrow ambiguous/homonym results:
npx local-election-candidate-search 김동연 --date 2014 --election 기초의원 --region 동작
  1. Include non-local races only when the user asks for all NEC integrated-search matches:
npx local-election-candidate-search 이재명 --all --limit 20

Inputs

  • Candidate name: exact Korean name; required.
  • --election: one of 시도지사, 기초단체장, 광역의원, 기초의원, 광역비례, 기초비례, 교육감.
  • --date / --year: YYYY, YYYYMMDD, or YYYY.MM.DD.
  • --region: free text filter against parsed district/region text.
  • --limit: max rows, capped at 100.
  • --all: include non-local election results.

Outputs

Return concise JSON. Each items[] row may include:

  • name, hanja, birth_date, gender
  • election_date, election_name, election_code, election_type
  • party, district, votes, vote_share, elected
  • job, education, career[]
  • upstream code fields such as city_code, sgg_city_code, town_code

summary.upstream_result_limit shows the NEC row count requested before local client-side filters. Filtered searches request up to 100 upstream rows first, then apply exact-name matching, local/election/date/region filters, deduplication, and the final --limit.

Failure modes

  • no candidate results: NEC returned no matching card or filters removed all matches.
  • unexpected NEC search HTML: upstream may be in maintenance, NetFunnel queue, login/blocked state, or markup changed.
  • NEC search page was capped: filtered results are based on the maximum fetched page and may require upstream pagination for exhaustive coverage.
  • Homonyms: the same name can appear across many elections; always show election date/type/district and apply user-provided filters.
  • Future elections: candidate registration data may be incomplete until NEC publishes it.

Done when

  • Results are sourced from info.nec.go.kr public HTML.
  • Local-election filtering is applied unless the user requested --all.
  • Any warnings/failure modes are shown instead of silently claiming no results.