assembly-bill-vote-search

Queries Korean National Assembly bills, bill details, and plenary vote records via the Open Assembly API.

7.4k|904|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill assembly-bill-vote-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: assembly-bill-vote-search
Source: https://github.com/NomaDamas/k-skill/tree/main/assembly-bill-vote-search
Command: npx skills add https://github.com/NomaDamas/k-skill --skill assembly-bill-vote-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Finding official information about Korean National Assembly bills and how individual lawmakers voted in plenary sessions requires navigating the 열린국회정보 Open API directly, which involves API keys, endpoint knowledge, and parameter formats. This Skill handles that lookup through a hosted proxy so users can search bills and inspect vote records with plain requests.

Core Features & Use Cases

  • Bill Search: Query the ALLBILLV2 integrated bill API by bill name, number, committee, proposal date, or assembly term (e.g., 제21대).
  • Bill Detail Lookup: Retrieve full details for a specific bill using its BILL_ID via the BILLINFODETAIL endpoint.
  • Plenary Vote Records: Fetch per-lawmaker plenary vote results (찬성/반대/기권) filtered by assembly term, member name, party, or vote result.
  • Use Case: Ask "21대 국회 간호법 표결에서 의원별 찬반 알려줘" and the Skill searches the bill, confirms its BILL_ID, then returns each lawmaker's recorded vote.

Quick Start

Ask the agent to search the National Assembly for a bill by name and show how each lawmaker voted on it in the plenary session.

Frequently Asked Questions about assembly-bill-vote-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Korean National Assembly bills by name?

Call the /v1/assembly/bills endpoint with a query parameter such as the bill name and an assembly term like 제21대. The request goes through the k-skill-proxy, which wraps the 열린국회정보 ALLBILLV2 API, and returns matching bills with their BILL_ID values.

How can I check how a Korean lawmaker voted on a specific bill?

Use the /v1/assembly/votes endpoint with the assembly age (e.g., 21) and the bill's BILL_ID. You can filter results by member name, party, or vote result to see each lawmaker's recorded 찬성, 반대, or 기권.

Do I need an API key to use the 열린국회정보 Open API with this Skill?

No user-side key is required. The ASSEMBLY_API_KEY lives only on the k-skill-proxy server, so end users call the hosted proxy directly. You only set KSKILL_PROXY_BASE_URL if you run a self-hosted proxy.

Why does the assembly bill search return empty results?

Empty results usually come from a wrong assembly term (ERACO/age), a misspelled bill name, or an incorrect BILL_ID. The upstream API returns INFO-200 when no records match, so verify the term and identifiers and retry.

Can this Skill submit or modify National Assembly bills?

No. It is strictly read-only, supporting bill search, bill detail lookup, and plenary vote queries. It does not perform any submission, modification, or political recommendation actions.