# Government APIs k-skill Supports for AI Agents: Complete Reference

> Explore k-skill's support for over a dozen Korean government APIs like KOSIS, MOLIT, and ECOS. Securely connect AI agents to essential data without handling raw keys.

- Repository: [NomaDamas/k-skill](https://github.com/NomaDamas/k-skill)
- Tags: api-reference
- Published: 2026-08-03

---

**k-skill supports over a dozen Korean government APIs including KOSIS statistics, MOLIT real-estate data, ECOS economic indicators, and Seoul City transport data, routing all requests through a secure proxy layer so AI agents never handle raw authentication keys.**

The NomaDamas/k-skill repository provides a comprehensive integration layer that enables AI agents to query Korean public-sector data sources without managing complex authentication flows. By normalizing disparate government endpoints into a unified interface, k-skill allows developers to retrieve statistics, legal information, and real-time civic data using simple skill commands.

## National Statistics and Economic Data

### KOSIS Open API (Statistics Korea)

The **KOSIS Open API** from Statistics Korea (통계청) provides national statistics covering population trends, economic indicators, and demographic data. According to the source documentation in [`docs/sources.md`](https://github.com/NomaDamas/k-skill/blob/main/docs/sources.md) (lines 9-10), k-skill exposes this through the **k-skill-proxy** via routes `/v1/kosis/search`, `/v1/kosis/meta`, and `/v1/kosis/data`, forwarding requests to `https://kosis.kr/openapi/...`.

The implementation resides in [`packages/k-skill-cli/helpers/kosis.js`](https://github.com/NomaDamas/k-skill/blob/main/packages/k-skill-cli/helpers/kosis.js), which normalizes the response into a typed structure for AI agents. Accessing "big-data" queries requires a free KOSIS API key, injected securely by the proxy rather than exposed to the agent.

### Bank of Korea ECOS API

For macroeconomic data such as GDP and CPI, k-skill integrates the **Bank of Korea ECOS API**. The proxy route `/v1/ecos/*` maps to `https://ecos.bok.or.kr/api/...` as documented in [`docs/sources.md`](https://github.com/NomaDamas/k-skill/blob/main/docs/sources.md) (line 298). A free demo key is available for development, with production keys injected via environment variables.

## Real Estate and Infrastructure

### MOLIT Housing APIs

The Ministry of Land, Infrastructure and Transport (MOLIT) provides real-estate transaction data through multiple endpoints. k-skill supports apartment trades, rentals, office buildings, and multi-family units via routes `/v1/molit/apt-trade`, `/v1/molit/apt-rent`, and related paths (documented in [`docs/sources.md`](https://github.com/NomaDamas/k-skill/blob/main/docs/sources.md), lines 115-122).

These routes forward to `https://apis.data.go.kr/1613000/...` and are implemented in [`packages/k-skill-cli/helpers/molit.js`](https://github.com/NomaDamas/k-skill/blob/main/packages/k-skill-cli/helpers/molit.js). The helper handles the complex parameter mapping required for region-specific queries, allowing agents to specify simple arguments like `--city Seoul`.

### EV-Charger Open API

Public electric vehicle charging station data comes from the **공공데이터포털** (Public Data Portal). The routes `/v1/ev-charger/info` and `/v1/ev-charger/status` provide location and real-time availability data, implemented in [`packages/k-skill-cli/helpers/evCharger.js`](https://github.com/NomaDamas/k-skill/blob/main/packages/k-skill-cli/helpers/evCharger.js) (referenced in [`docs/sources.md`](https://github.com/NomaDamas/k-skill/blob/main/docs/sources.md), line 13).

## Legal and Intellectual Property

### Korean Law Information API

The **법제처 국가법령정보 Open API** grants access to Korean statutes, regulations, and case law. k-skill exposes this via `/v1/korean-law/*` routes that proxy to `https://open.law.go.kr/...`, with implementation details in [`packages/k-skill-cli/helpers/koreanLaw.js`](https://github.com/NomaDamas/k-skill/blob/main/packages/k-skill-cli/helpers/koreanLaw.js) (see [`docs/sources.md`](https://github.com/NomaDamas/k-skill/blob/main/docs/sources.md), line 129).

### KIPRIS Plus Patent API

For intellectual property queries, the **KIPRIS Plus 특허/실용신안 API** provides patent and utility model information from the government-run KIPRIS system. The proxy route `/v1/kipris-plus/*` forwards to `https://plus.kipris.or.kr/...`, implemented in [`packages/k-skill-cli/helpers/kiprisPlus.js`](https://github.com/NomaDamas/k-skill/blob/main/packages/k-skill-cli/helpers/kiprisPlus.js) (documented in [`docs/sources.md`](https://github.com/NomaDamas/k-skill/blob/main/docs/sources.md), line 207).

## Public Safety and Cultural Data

### Cultural Heritage Administration API

The **국가유산청 (Cultural Heritage Administration) Open API** lists heritage sites, detailed descriptions, and events. k-skill exposes endpoints `/v1/khs/list`, `/v1/khs/detail`, and `/v1/khs/event` (mapping to `https://www.khs.go.kr/...`), with the helper logic in [`packages/k-skill-cli/helpers/khs.js`](https://github.com/NomaDamas/k-skill/blob/main/packages/k-skill-cli/helpers/khs.js) (see [`docs/sources.md`](https://github.com/NomaDamas/k-skill/blob/main/docs/sources.md), lines 292-295).

### Han River Flood Control Office API

River-level and flood-control data from the **한강홍수통제소** is available via `/v1/hrfco/*` routes that proxy to `https://api.hrfco.kr/...` (documented in [`docs/sources.md`](https://github.com/NomaDamas/k-skill/blob/main/docs/sources.md), lines 229-232).

### Food Safety API

The **식품안전나라 (Food Safety) API** provides inspection data through the `I0490` dataset. Routes under `/v1/food-safety/*` forward to `https://www.foodsafetykorea.go.kr/...` (see [`docs/sources.md`](https://github.com/NomaDamas/k-skill/blob/main/docs/sources.md), line 108).

## Municipal and Transport Services

### Seoul City Open API

Real-time municipal data including subway schedules, fine dust measurements, 따릉이 (bike-share) status, and weather forecasts are accessible through the **Seoul City Open API**. The proxy route `/v1/seoul/*` maps to `https://openapi.seoul.go.kr/...`, handling the authentication required by the Seoul metropolitan endpoints.

### OPINET Fuel Price API

Fuel-price and gas station information is available via the **OPINET 주유소 API**. k-skill supports location-based queries and detailed station lookups through routes `/v1/opinet/aroundAll` and `/v1/opinet/detailById`, forwarding to `https://www.opinet.co.kr/...` (see [`packages/k-skill-cli/helpers/opinet.js`](https://github.com/NomaDamas/k-skill/blob/main/packages/k-skill-cli/helpers/opinet.js) and [`docs/sources.md`](https://github.com/NomaDamas/k-skill/blob/main/docs/sources.md), lines 211-214).

## General Data.go.kr Integration

Beyond specific implementations, k-skill provides a generic routing layer for various **공공데이터포털 (Data.go.kr)** datasets including building registers and waste management data. These are handled dynamically through the proxy when a valid service key is supplied, as noted in [`docs/sources.md`](https://github.com/NomaDamas/k-skill/blob/main/docs/sources.md) (line 61).

## Proxy Architecture and Security Model

All government API requests flow through the **k-skill-proxy** server defined in [`packages/k-skill-proxy/src/server.js`](https://github.com/NomaDamas/k-skill/blob/main/packages/k-skill-proxy/src/server.js). This architecture ensures AI agents never possess raw government API credentials.

The request flow follows four stages:

1. **Skill Invocation** – An AI agent calls a skill such as `korean-housing-price` with arguments like `--city Seoul`.
2. **Helper Processing** – The skill invokes a helper from `packages/k-skill-cli/helpers/` (e.g., [`molit.js`](https://github.com/NomaDamas/k-skill/blob/main/molit.js), [`kosis.js`](https://github.com/NomaDamas/k-skill/blob/main/kosis.js)), which constructs a normalized HTTP request.
3. **Proxy Routing** – The helper sends the request to `https://k-skill-proxy.nomadamas.org`. The proxy injects required headers (e.g., `KSKILL_KOSIS_API_KEY`) and forwards to the upstream government endpoint.
4. **Response Normalization** – The proxy returns the upstream JSON/XML, which the helper parses into a clean, typed structure for the agent.

This pattern is consistent across all supported government APIs, with [`packages/k-skill-proxy/src/server.js`](https://github.com/NomaDamas/k-skill/blob/main/packages/k-skill-proxy/src/server.js) handling rate-limiting, caching, and authentication for every `/v1/*` route.

## Practical Usage Examples

The following commands demonstrate how AI agents invoke government APIs through k-skill:

Retrieve national population statistics via KOSIS:

```bash
k-skill exec korean-statistics \
    --dataset "population" \
    --year 2024

```

Query real-estate transaction data from MOLIT:

```bash
k-skill exec korean-housing-price \
    --city "Seoul" \
    --type "apt" \
    --year 2023

```

Check EV charging station availability:

```bash
k-skill exec ev-charger-status \
    --region "Seoul"

```

Each command routes through the respective helper and proxy layers described above, translating simple CLI arguments into authenticated government API calls.

## Summary

- **k-skill** supports Korean government APIs for statistics (KOSIS, ECOS), real estate (MOLIT), law (법제처), patents (KIPRIS), cultural heritage, food safety, and municipal data (Seoul City).
- All routes are documented in [`docs/sources.md`](https://github.com/NomaDamas/k-skill/blob/main/docs/sources.md) and implemented as thin wrappers in `packages/k-skill-cli/helpers/`.
- The **k-skill-proxy** ([`packages/k-skill-proxy/src/server.js`](https://github.com/NomaDamas/k-skill/blob/main/packages/k-skill-proxy/src/server.js)) handles authentication, rate-limiting, and upstream routing to official endpoints.
- AI agents interact via normalized skill commands without managing API keys directly.
- Helper modules normalize heterogeneous government data formats into consistent, typed responses.

## Frequently Asked Questions

### Which government APIs are supported by k-skill for AI agents?

k-skill supports the KOSIS national statistics API, Bank of Korea ECOS, MOLIT housing transaction APIs, the Korean Law Information API, KIPRIS Plus patents, Cultural Heritage Administration data, Food Safety API, EV-charger status, Seoul City Open API, and OPINET fuel prices. The complete list is maintained in [`docs/sources.md`](https://github.com/NomaDamas/k-skill/blob/main/docs/sources.md).

### How does k-skill handle authentication for government APIs?

Authentication is managed by the **k-skill-proxy** server, which injects API keys (such as `KSKILL_KOSIS_API_KEY`) into requests forwarded to upstream government endpoints. AI agents and skill definitions never access these credentials directly, ensuring secure credential management.

### Where are the government API routes defined in the source code?

Proxy routes are defined in [`packages/k-skill-proxy/src/server.js`](https://github.com/NomaDamas/k-skill/blob/main/packages/k-skill-proxy/src/server.js), which maps friendly paths like `/v1/kosis/search` to official government URLs. Helper modules in `packages/k-skill-cli/helpers/` (e.g., [`kosis.js`](https://github.com/NomaDamas/k-skill/blob/main/kosis.js), [`molit.js`](https://github.com/NomaDamas/k-skill/blob/main/molit.js)) handle request construction and response parsing for each specific API.

### Can developers add new government APIs to k-skill?

Yes. Developers can add support by creating a new helper in `packages/k-skill-cli/helpers/` that constructs the appropriate request, then adding the corresponding route in [`packages/k-skill-proxy/src/server.js`](https://github.com/NomaDamas/k-skill/blob/main/packages/k-skill-proxy/src/server.js) to handle authentication and forwarding to the new government endpoint. The new source should be documented in [`docs/sources.md`](https://github.com/NomaDamas/k-skill/blob/main/docs/sources.md).