Korea Public Data

io.github.groove79由 GitHub 账号 groove79 发布v0.1.3更新于 Oct 29, 2026

Korean public data MCP: business status, holidays, addresses, apartment trades. 공공데이터 MCP.

已验证STDIO仅桌面位置与生活金融商业与电商

概览

AI 生成的概览

韩国公共数据 MCP 服务器，可查询营业执照状态、公休日、地址与公寓成交价，数据来自官方来源。

可以做什么
  • 批量核验韩国营业执照号：营业中、停业或歇业状态、税种与歇业日期
  • 按年份或月份查询公休日与替代公休日
  • 搜索并规范化韩国地址，返回道路名地址、地番地址、邮编与建筑名
  • 将韩文地址转换为官方英文地址，拆分为街道、单元、城市、省份、邮编等国际寄送字段
  • 按地区代码与月份查询公寓买卖成交价，可按小区名称过滤
适用场景
适合需要处理韩国企业、寄送或房产数据的场景：登记供应商或客户前核验执照、结合公休日安排截止日期与配送、校验韩国地址，或回答近期公寓成交价问题。
运行要求
通过 npx 在本地运行（需 Node.js）。需要两个免费 API 密钥作为环境变量：DATA_GO_KR_KEY（data.go.kr 解码后的密钥，用于执照、公休日与公寓成交工具）和 JUSO_KEY（道路名地址 API 密钥）。每个 data.go.kr 服务需在账号下申请获批。
安装前请注意
两个密钥均为环境变量中的机密，不应外泄。查询会发送至韩国公共数据服务（国税厅、天文研究院、国土交通部、Juso），所查的执照号、地址与地区代码会离开本机。工具说明为只读。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Korea Public Data，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@appmonster/mcp-public-data

MCP server for Korean public data — the lookups every agent working in Korea needs: is this business registration active, when are the holidays, what is the normalized address, what did apartments sell for.

한국 공공데이터 MCP 서버 — 사업자 상태, 공휴일, 도로명주소, 아파트 실거래가.

Keys (free)

EnvWhereNeeded by
DATA_GO_KR_KEYdata.go.kr → 활용신청: 국세청 사업자등록정보 진위확인 및 상태조회 · 한국천문연구원 특일 정보 · 국토교통부 아파트 매매 실거래가 상세kr_check_business, kr_holidays, kr_apt_trades
JUSO_KEYbusiness.juso.go.kr → 도로명주소 API 신청kr_search_address

Use the decoded data.go.kr key (the one without %2B/%3D). One key works for all three data.go.kr services once each is approved (usually instant).

Install

json
{  "mcpServers": {    "kr-public": {      "command": "npx",      "args": ["-y", "@appmonster/mcp-public-data"],      "env": { "DATA_GO_KR_KEY": "…", "JUSO_KEY": "…" }    }  }}

Tools (all read-only)

ToolWhat it does
kr_check_businessNTS status for up to 100 business numbers: active / suspended / closed, tax type, closure date
kr_holidaysPublic + substitute holidays for a year or month (KASI)
kr_search_addressRoad/lot address, postal code, building, admin code for a keyword
kr_apt_tradesApartment sale transactions for a 5-digit district code and YYYYMM, optional name filter

Example prompts

  • "이 거래처 사업자번호 123-45-67890 지금도 영업 중이야?"
  • "2027년 1월 공휴일 알려줘 — 배송 안내문에 쓸 거야"
  • "송도동 효성메트하임 9월 실거래가"

MIT © Appmonster

来源：packages/public-data/README.md，提交 53af4ba

工具

5

kr_check_business

Check Korean business registration numbers (사업자등록번호) with the National Tax Service: active / suspended / closed, tax type, closure date. Up to 100 numbers per call. 사업자 상태를 조회합니다. Use before registering a vendor or customer. Needs 10-digit numbers (dashes OK).

输入参数numbers必填

kr_holidays

List Korean public holidays (incl. substitute holidays) for a year or a month, from the official KASI calendar. 공휴일·대체공휴일을 조회합니다. Use for delivery estimates, deadlines, scheduling. Needs year; month optional.

输入参数year必填month

kr_search_address

Search and normalize a Korean address: returns road address, lot address, postal code, building name. 주소를 검색·정규화합니다(도로명·지번·우편번호). Use to validate shipping or business addresses. Needs a keyword like "테헤란로 152" or a building name.

输入参数countkeyword必填

kr_address_english

Convert a Korean address (Hangul, with or without unit like 101동 1203호) into the official English address, split into shipping-form fields: street, unit, city, province, postal code, country. For international shipping to Korea, overseas sellers, forwarders and visa or bank forms. 한글 주소를 해외 배송용 영문 주소로 바꿉니다.

输入参数address必填

kr_apt_trades

Apartment sale transactions (실거래가) for a district (5-digit 법정동코드) and month from MOLIT. 아파트 매매 실거래가를 조회합니다. Use for market price questions. Needs lawd_cd (e.g. 28185 = 인천 연수구) and year_month (YYYYMM).

输入参数lawd_cd必填apartmentyear_month必填

版本历史

1
  1. v0.1.3最新Oct 23, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分