local-election-candidate-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Local Election Candidate Search

地方选举候选人检索

What this skill does

该技能的功能

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

通过中央选举管理委员会（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.

选择的路径：NEC综合候选人检索。

入口页面：

https://info.nec.go.kr/search/searchCandidate.xhtml

方法：无需认证的公开
```
POST
```
请求

必填表单字段：

searchKeyword=<准确的候选人姓名>

辅助包：
```
local-election-candidate-search
```

选择该路径的原因：NEC的可视化UI明确提供了覆盖近期及历史选举的候选人姓名综合检索功能，且以服务器渲染HTML的形式返回候选人结果卡片。相比抓取各选举菜单页面，该路径更稳定，因为无需先选择每个市/镇/选区的组合。

Workflow

工作流程

Use the package CLI from this repository or installed workspace:

bash

npx local-election-candidate-search 오세훈 --election 시도지사 --region 서울 --limit 5

Narrow ambiguous/homonym results:

bash

npx local-election-candidate-search 김동연 --date 2014 --election 기초의원 --region 동작

Include non-local races only when the user asks for all NEC integrated-search matches:

bash

npx local-election-candidate-search 이재명 --all --limit 20

使用本仓库或已安装工作区中的包CLI：

bash

npx local-election-candidate-search 오세훈 --election 시도지사 --region 서울 --limit 5

缩小模糊/同名结果范围：

bash

npx local-election-candidate-search 김동연 --date 2014 --election 기초의원 --region 동작

仅当用户要求获取所有NEC综合检索匹配结果时，才包含非地方选举结果：

bash

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.

候选人姓名：准确的韩文姓名；必填项。

--election

：可选值包括

시도지사

、

기초단체장

、

광역의원

、

기초의원

、

광역비례

、

기초비례

、

교육감

。

```
--date
```
/
```
--year
```
：格式为
```
YYYY
```
、
```
YYYYMMDD
```
或
```
YYYY.MM.DD
```
。
```
--region
```
：针对解析后的地区/选区文本的自由文本筛选。
```
--limit
```
：最大返回行数，上限为100。
```
--all
```
：包含非地方选举结果。

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

返回简洁的JSON格式数据。每个

items[]

条目可能包含：

```
name
```
,
```
hanja
```
,
```
birth_date
```
,
```
gender
```

election_date

election_name

election_code

election_type

```
party
```
,
```
district
```
,
```
votes
```
,
```
vote_share
```
,
```
elected
```
```
job
```
,
```
education
```
,
```
career[]
```
上游代码字段，如
```
city_code
```
,
```
sgg_city_code
```
,
```
town_code
```

summary.upstream_result_limit

表示在应用本地客户端筛选前，请求的NEC行数。筛选检索会先请求最多100行上游数据，然后应用准确姓名匹配、地方/选举/日期/地区筛选、去重，最后应用

--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.

```
no candidate results
```
：NEC未返回匹配卡片，或筛选移除了所有匹配结果。
```
unexpected NEC search HTML
```
：上游系统可能处于维护中、NetFunnel队列中、登录/拦截状态，或标记语言已更改。
```
NEC search page was capped
```
：筛选结果基于获取的最大页面数据，可能需要上游分页才能获取完整结果。
同名问题：同一姓名可能出现在多个选举中；需始终显示选举日期/类型/选区，并应用用户提供的筛选条件。
未来选举：在NEC发布候选人注册数据前，相关数据可能不完整。

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.

结果来源于
```
info.nec.go.kr
```
的公开HTML页面。
除非用户请求
```
--all
```
，否则应用地方选举筛选。
显示任何警告/失败场景，而非默认提示无结果。