| name | local-election-candidate-search |
| description | 중앙선거관리위원회 선거통계시스템 공개 통합검색으로 한국 지방선거 후보자 정보를 이름/선거종류/지역 기준으로 조회한다. |
| license | MIT |
| metadata | {"category":"civic","locale":"ko-KR","phase":"v1"} |
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
- Use the package CLI from this repository or installed workspace:
npx local-election-candidate-search 오세훈 --election 시도지사 --region 서울 --limit 5
- Narrow ambiguous/homonym results:
npx local-election-candidate-search 김동연 --date 2014 --election 기초의원 --region 동작
- 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.