건강보험심사평가원 병원 검색

HIRA hospital information search API

Security Scan

The skill's code and instructions match its stated purpose (querying HIRA/data.go.kr hospital APIs); the only issues are minor omissions and small coding bugs, not evidence of malicious behavior.

Purpose & Capability

The name/description (HIRA hospital search) align with the included scripts which call apis.data.go.kr endpoints. Minor inconsistency: the registry metadata declares no required binaries or env vars, but the scripts require a local API key file (~/.config/data-go-kr/api_key) and expect tools like curl and python3 to be available.

Instruction Scope

Runtime instructions and scripts only read the API key file in the user's home config, call HIRA/data.go.kr endpoints, and parse responses locally. They do not reference unrelated system files, other credentials, or external endpoints beyond the public data.go.kr API. SKILL.md mentions optional connectors (Brave/Telegram) as placeholders but the scripts do not call those services.

Install Mechanism

No install/spec download is provided (instruction-only with bundled scripts). Nothing in the install surface pulls remote code or writes files to unexpected locations.

Credentials

The skill requires a HIRA/data.go.kr API key stored at ~/.config/data-go-kr/api_key (documented in SKILL.md and used by scripts). Registry fields list no required env vars — this omission is a bookkeeping mismatch but not a functional surprise. The requested credential is narrowly scoped to the public API and is proportionate to the purpose.

Persistence & Privilege

always:false and the skill does not attempt to modify other skills or system-wide agent settings. It runs on-demand and does not request persistent elevated privileges.

Assessment

This skill appears to do what it says: call the public HIRA/data.go.kr hospital APIs using a user-provided API key file. Before installing or running it: 1) Ensure you are comfortable storing your data.go.kr API key at ~/.config/data-go-kr/api_key and set tight file permissions (chmod 600). 2) Verify you have curl and python3 available — the registry metadata omitted those requirements. 3) Review the scripts locally (they're simple) and be aware of a minor bug in scripts/hospital.sh where a shell variable is used incorrectly in the embedded Python filter (it may not filter by hospital type as intended). 4) Run in a sandbox or test account if you want to avoid exposing your real API key while testing. 5) If you need connectors (Brave/Telegram) note that SKILL.md only lists them as placeholders—no code in the bundle sends data to those services.

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 키 저장:

   mkdir -p ~/.config/data-go-kr
   echo "YOUR_API_KEY" > ~/.config/data-go-kr/api_key
   

4. 아래 서비스 활용신청 후 사용 (자동승인)
   • 심평원 병원 정보 (15001698)