Assembly Bill Vote Search
Researchassembly-bill-vote-searchAssembly Bill Vote 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.
열린국회정보 Open API를 k-skill-proxy 경유로 호출해 의안 검색·상세와 국회의원 본회의 표결정보를 조회한다. 조회 전용.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/NomaDamas/k-skill/blob/HEAD/assembly-bill-vote-search/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/assembly-bill-vote-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.
Assembly Bill Vote Search
What this skill does
열린국회정보 Open API https://open.assembly.go.kr/portal/openapi 를 k-skill-proxy 경유로 호출한다.
지원 endpoint:
GET /v1/assembly/bills→ALLBILLV2의안정보 통합 APIGET /v1/assembly/bill-detail→BILLINFODETAIL의안 상세정보GET /v1/assembly/votes→nojepdqqaweusdfbi국회의원 본회의 표결정보
When to use
- "간호법 의안 검색해줘"
- "BILL_ID로 의안 상세 보여줘"
- "21대 국회 특정 의안 표결에서 의원별 찬반 알려줘"
Prerequisites
- 인터넷 연결
- hosted/self-host
k-skill-proxy의/v1/assembly/*route 접근 가능
Credential requirements
- 사용자 측 필수 시크릿 없음.
KSKILL_PROXY_BASE_URL— self-host·별도 프록시를 쓸 때만 설정. 비우면 기본 hostedhttps://k-skill-proxy.nomadamas.org를 사용한다.ASSEMBLY_API_KEY또는KSKILL_ASSEMBLY_API_KEY는 프록시 운영 서버 환경에만 둔다.
키 발급: https://open.assembly.go.kr/portal/openapi/openApiActKeyIssPage.do
Inputs
의안 검색:
query/q/billName→BILL_NMbillId,billNo,billKind,committeeName,proposalDate,resulteraco/ageLabel→ERACO, 기본제21대page/pIndex,limit/pSize
의안 상세:
billId필수
표결 조회:
age필수 (21등 숫자)billId필수memberName,party,memberNo,voteDate,billNo,billName,committee,voteResultpage/pIndex,limit/pSize
Workflow
1. Search bills first
BASE="${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}"
curl -fsS --get "$BASE/v1/assembly/bills" \
--data-urlencode "query=간호법" \
--data-urlencode "eraco=제21대" \
--data-urlencode "limit=10"
2. Fetch bill detail
curl -fsS --get "$BASE/v1/assembly/bill-detail" \
--data-urlencode "billId=PRC_N2D0H0W9P2S3Z1Q2X0L8W4B1G8E3F4"
3. Fetch plenary votes
curl -fsS --get "$BASE/v1/assembly/votes" \
--data-urlencode "age=21" \
--data-urlencode "billId=PRC_N2D0H0W9P2S3Z1Q2X0L8W4B1G8E3F4" \
--data-urlencode "limit=100"
Failure modes
400 bad_request: 필수billId/age누락, 페이지 크기 초과, 잘못된 숫자 형식.503 upstream_not_configured: 프록시 서버에ASSEMBLY_API_KEY/KSKILL_ASSEMBLY_API_KEY없음.- 열린국회정보
RESULT.CODE:ERROR-290: 키 누락/오류ERROR-300: 필수 파라미터 누락ERROR-337: 일일 트래픽 초과INFO-200: 결과 없음
- 빈 결과: 대수(
ERACO/age), 의안명, 의안번호, BILL_ID를 다시 확인한다.
Done when
- 먼저 의안 검색으로
BILL_ID를 확정했다. - 상세 또는 표결 조회 결과에
BILL_ID, 국회 대수, endpoint를 함께 적었다. - 표결 요약은 찬성/반대/기권 등 upstream 원문 분류를 임의 변경하지 않았다.
Maintainer review notes
키 없이 가능한 검증:
./scripts/validate-skills.shnode --test packages/k-skill-proxy/test/server.test.jscurl -i --get "$KSKILL_PROXY_BASE_URL/v1/assembly/bills" --data-urlencode "query=간호법"(키 미설정이면 503 확인)
Live smoke는 hosted/self-host proxy에 ASSEMBLY_API_KEY가 설정된 뒤 수행한다.
Safety notes
- 조회 전용 스킬이다.
- 정치적 평가·추천을 자동 생성하지 않고, 공식 원천의 의안·표결 사실을 요약한다.
- 인증키는 프록시 서버에서만 다루며 repo/GitHub Actions/public docs에 저장하지 않는다.