name	assembly-bill-vote-search
description	열린국회정보 Open API를 k-skill-proxy 경유로 호출해 의안 검색·상세와 국회의원 본회의 표결정보를 조회한다. 조회 전용.
license	MIT
metadata	{"category":"civic","locale":"ko-KR","phase":"v1"}

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 의안정보 통합 API
GET /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·별도 프록시를 쓸 때만 설정. 비우면 기본 hosted https://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_NM
billId, billNo, billKind, committeeName, proposalDate, result
eraco/ageLabel → ERACO, 기본 제21대
page/pIndex, limit/pSize

의안 상세:

billId 필수

표결 조회:

age 필수 (21 등 숫자)
billId 필수
memberName, party, memberNo, voteDate, billNo, billName, committee, voteResult
page/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.sh
node --test packages/k-skill-proxy/test/server.test.js
curl -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에 저장하지 않는다.

Más de este repositorio

mismo repositorio

kopis-performance-search

NomaDamas/k-skill

KOPIS 공연예술통합전산망 Open API를 k-skill-proxy 경유로 조회해 공연 목록·상세와 공연시설 정보를 찾는다. 조회 전용.

2026-07-126.2k

kr-whois-lookup

NomaDamas/k-skill

공공데이터포털 WHOIS 도메인/IP 정보 API를 k-skill-proxy 경유로 호출해 .kr/.한국 도메인, IP 주소, AS 번호의 공개 등록정보를 조회한다. 조회 전용.

2026-07-126.2k

court-auction-notice-search

NomaDamas/k-skill

Browse 대법원경매정보(courtauction.go.kr) 부동산 매각공고 by 매각기일·법원·기일/기간 입찰, expand each notice into 사건번호·용도·주소·감정평가액·최저매각가, search property items by free conditions(지역·용도·가격·면적·유찰횟수), and look up a case directly by 법원+사건번호. Read-only, slow-by-design (~2s/call) to avoid IP blocks.

2026-07-116.2k

court-payment-order-assistant

NomaDamas/k-skill

법원 전자소송 지급명령 신청을 위해 채권자·채무자·청구금액·청구원인·증빙 정보를 인터뷰하고, 신청서 초안과 공식 전자소송 브라우저 입력 handoff를 준비한다.

2026-07-116.2k

d2b-notice-search

NomaDamas/k-skill

국방전자조달시스템(D2B) 공개 입찰공고 검색 화면에서 공고건명·공고구분·공고/개찰일·G2B공고번호·발주기관 조건으로 공고를 조회한다.

2026-07-116.2k

daangn-realty-search

NomaDamas/k-skill

당근부동산(realty.daangn.com) 공개 웹 데이터로 지역 기반 부동산 매물 검색과 상세 확인을 수행한다. 문의/예약/계약 자동화는 제외한다.

2026-07-116.2k

name	assembly-bill-vote-search
description	열린국회정보 Open API를 k-skill-proxy 경유로 호출해 의안 검색·상세와 국회의원 본회의 표결정보를 조회한다. 조회 전용.
license	MIT
metadata	{"category":"civic","locale":"ko-KR","phase":"v1"}

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 의안정보 통합 API
GET /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·별도 프록시를 쓸 때만 설정. 비우면 기본 hosted https://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_NM
billId, billNo, billKind, committeeName, proposalDate, result
eraco/ageLabel → ERACO, 기본 제21대
page/pIndex, limit/pSize

의안 상세:

billId 필수

표결 조회:

age 필수 (21 등 숫자)
billId 필수
memberName, party, memberNo, voteDate, billNo, billName, committee, voteResult
page/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.sh
node --test packages/k-skill-proxy/test/server.test.js
curl -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에 저장하지 않는다.