hira-hospital
by sw326
Search & ResearchBrief
HIRA hospital information search API.
Description
What This Skill Does
Wraps Korea's HIRA (Health Insurance Review & Assessment Service) public API to search hospitals by name, region, type, or department, and retrieve details including operating hours, departments, and transport directions. Data is served through the government's data.go.kr open data portal under the National Health Insurance Act.
Pulls structured hospital data directly from Korea's official HIRA registry, including hours and transport details not reliably indexed by general search engines.
When to Use It
- Finding nearby ENT clinics by neighborhood
- Checking a hospital's operating hours before visiting
- Looking up transport and parking info for a specific hospital
- Searching pediatric clinics in a specific district
- Getting a full department list for a hospital by institution code
Example Workflow
User asks: 강남 피부과 찾아줘 (Find a dermatology clinic in Gangnam)
- 1
Parses query to extract region (Gangnam) and department (dermatology)
- 2
Runs hospital_search.sh with region and department criteria against hospInfoServicev2
- 3
Retrieves matching hospital list from the HIRA API
- 4
Formats results into a table with hospital name, address, phone, and departments
A table of dermatology clinics in Gangnam with addresses, phone numbers, and available departments
Requirements
- data.go.kr account
- data.go.kr general API key (Decoding) stored at ~/.config/data-go-kr/api_key
- Approved usage application for HIRA hospital info service (ID 15001698) on data.go.kr
Installation
clawhub install sw326/hira-hospitalRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.