nhis-care-checkup-search

Query Korean NHIS long-term care and health checkup institutions via a public data proxy.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Finding long-term care facilities or health checkup centers in Korea requires navigating the National Health Insurance Service portals manually. This Skill queries the official NHIS open data services (data.go.kr 15059029 and 15154419) through the k-skill-proxy so an AI agent can return institution names, addresses, phone numbers, and service types without the user holding any API key.

Core Features & Use Cases

  • Long-term care institution search: Query nursing homes and care facilities by name, sido/sigungu region code, or service type via the /v1/nhis/long-term-care route.
  • Health checkup institution search: Find checkup centers by region, checkup type, or holiday availability using the /v1/nhis/checkup list, by-region, by-checkup-type, and holiday routes.
  • No user credentials required: The DATA_GO_KR_API_KEY lives only on the proxy server; users just call the hosted endpoint.
  • Use Case: Ask "서울 강남 건강검진기관 찾아줘" and receive a summarized list of candidate centers with addresses and phone numbers, plus guidance to confirm booking directly with the institution.

Quick Start

Ask the agent to find health checkup centers in Seoul Gangnam using the nhis-care-checkup-search skill and summarize their names, addresses, and phone numbers.

Frequently Asked Questions about nhis-care-checkup-search

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

FAQPage Schema
How do I search for long-term care facilities in Korea by region?

Call the /v1/nhis/long-term-care route on the k-skill-proxy with a query string, sido code, or sigungu code. The response lists institution names, addresses, phone numbers, and service types from the official NHIS open data service.

How can I find health checkup centers open on weekends in Korea?

Use the /v1/nhis/checkup/holiday route of the k-skill-proxy to query checkup institutions by holiday operation. Other routes support filtering by region or checkup type code, returning publicly listed center details.

Do I need a data.go.kr API key to use this NHIS search?

No user-side API key is required. The DATA_GO_KR_API_KEY is stored only on the k-skill-proxy server, and the default hosted proxy at k-skill-proxy.nomadamas.org handles authentication for you.

Why does the NHIS institution search return a 503 or 502 error?

A 503 means the proxy server has no DATA_GO_KR_API_KEY configured, while a 502 means data.go.kr rejected the key. Each data.go.kr service (15059029, 15154419) also requires separate usage approval on the portal.

Can this skill book appointments or judge which care facility is best?

No. It is a read-only lookup tool that summarizes public institution information. It does not perform medical judgment, long-term care grade assessment, or reservation automation; confirm availability directly with NHIS or the institution.