SkillHub

hira-hospital

v3.2.0

HIRA hospital information search API

Sourced from ClawHub, Authored by 김성우

Installation

Please help me install the skill `hira-hospital` from SkillHub official store. npx skills add sw326/hira-hospital

Hospital Info Skill

HIRA (Health Insurance Review & Assessment Service) hospital search + detail lookup.

Overview

Service ID Endpoint Purpose
Hospital Info 15001698 hospInfoServicev2 Hospital list search
Detail Info 15001699 MadmDtlInfoService2.7 Departments, hours, transport
Key Value
Auth ~/.config/data-go-kr/api_key
Base URL https://apis.data.go.kr/B551182/
Legal basis National Health Insurance Act §43

Scripts

scripts/
├── hospital_search.sh  → Search hospitals (name/region/type/dept)
└── hospital_detail.sh  → Hospital detail (parallel API calls)

Workflow

Step 1: Parse search criteria

  • "근처 이비인후과" → region + department search
  • "서울대병원 진료시간" → specific hospital detail
  • ~~search to supplement hospital name/location

Step 2: Search hospitals

  • hospital_search.sh [criteria]

Step 3: Detail lookup (if needed)

  • hospital_detail.sh [institution_code]

Step 4: Structured response

Output Template

## 🏥 [Query] Hospital Results

| Hospital | Type | Address | Phone | Departments |
|----------|------|---------|-------|-------------|

### [Hospital Name] Detail (on request)
- 📍 Address: ...
- ☎️ Phone: ...
- 🕐 Hours: ...
- 🚗 Transport: ...

Connectors

Placeholder Purpose Current Tool
~~hospital Hospital API HIRA data.go.kr
~~search Name/location supplement Brave Search
~~notify Alerts Telegram

Intent Router

Intent Trigger Examples Strategy
Quick Search "근처 이비인후과", "강남 피부과", "소아과 찾아줘" hospital_search.sh → 지역+진료과목 검색 → 목록
Detail Lookup "이 병원 정보 자세히", "진료시간 알려줘", "주차 되나?" hospital_detail.sh → 진료시간, 교통, 진료과목 상세

Routing logic: 검색/찾기/추천 → Quick Search, 특정 병원 + 상세/시간/교통 → Detail Lookup

Cross-Skill Integration

Trigger Target Skill Integration
병원 검색 결과 보충 web_search (Brave) 병원 리뷰·평판·홈페이지 보충 검색
외출 시 참고 kma-weather 비/추위 예보 시 "따뜻하게 입고 가세요" 팁

Cowork architecture v3.2 — 🦞 chumjibot (2026-02-19)

🔧 Setup (공공데이터 포털 API)

  1. data.go.kr 회원가입
  2. 로그인 → 마이페이지 → 일반 인증키(Decoding) 복사
  3. API 키 저장: bash mkdir -p ~/.config/data-go-kr echo "YOUR_API_KEY" > ~/.config/data-go-kr/api_key
  4. 아래 서비스 활용신청 후 사용 (자동승인)
  5. 심평원 병원 정보 (15001698)