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 分