gongsijiga-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

개별공시지가 조회

个别公示地价查询

What this skill does

本技能的功能

한국 국토교통부 부동산공시가격알리미(realtyprice.kr)에서 특정 필지의 개별공시지가(원/㎡)를 조회한다. 다년도 추이(최근 5년 이내)와 전년 대비 변동률을 정규화된 JSON으로 반환한다.

공시지가는 매년 1월 1일 기준, 4~5월 공시. 세금(재산세, 종합부동산세, 양도소득세) 산정의 법적 기준 단가다.

从韩国国土交通部不动产公示价格告知系统（realtyprice.kr）查询特定地块的个别公示地价（韩元/㎡）。以标准化JSON格式返回最近5年内的历年走势及同比变动率。

公示地价以每年1月1日为基准，于4~5月公示。是财产税、综合不动产税、转让所得税等税费计算的法定标准单价。

When to use

使用场景

"서울 강남구 역삼동 736 공시지가 알려줘"
"전라남도 무안군 청계면 청천리 100번지 개별공시지가"
"서초동 산 1-2 공시지가 추이"
세무 계산에서 토지 공시 단가가 필요할 때

"首尔江南区驿三洞736的公示地价告诉我"
"全罗南道务安郡青溪面青川里100号的个别公示地价"
"瑞草洞山1-2的公示地价走势"
税务计算中需要土地公示单价时

When NOT to use

禁用场景

시세, 실거래가, 매매가, 호가 → 다른 데이터 소스 필요
공동주택가격, 표준지공시지가, 단독주택가격 → 별도 스킬
토지이용계획 → eum.go.kr 별도 스킬

市价、实际成交价、买卖价、报价 → 需要其他数据源
公寓价格、标准地公示地价、独栋住宅价格 → 使用其他技能
土地利用规划 → 使用eum.go.kr专属技能

Prerequisites

前置条件

인터넷 연결
```
curl
```
(또는 HTTP 호출 도구)

사용자에게 필요한 시크릿 없음 (공개 데이터).

网络连接
```
curl
```
（或HTTP调用工具）

无需用户提供密钥（公开数据）。

Default path

默认路径

gongsijiga-search

npm 패키지를 직접 호출한다. realtyprice.kr는 API 키가 필요 없는 공개 엔드포인트이므로

k-skill-proxy

를 경유하지 않는다.

설치:

bash

npm install gongsijiga-search

호출:

bash

node -e "
const { lookupGongsijiga } = require('gongsijiga-search');
lookupGongsijiga('서울 강남구 역삼동 736').then(console.log).catch(console.error);
"

直接调用

gongsijiga-search

npm包。由于realtyprice.kr是无需API密钥的公开端点，因此无需经过

k-skill-proxy

代理。

安装：

bash

npm install gongsijiga-search

调用：

bash

node -e "
const { lookupGongsijiga } = require('gongsijiga-search');
lookupGongsijiga('서울 강남구 역삼동 736').then(console.log).catch(console.error);
"

Workflow

工作流程

1. 사용자 입력 수집

1. 收集用户输入

사용자에게 시도 + 시군구 + 읍면동 + 지번이 포함된 주소를 요청한다.

최소 필수: 시도, 시군구, 읍면동, 본번
- 세종특별자치시는 시군구가 없으므로 "세종 [읍면동] [지번]" 형식
산 지번이면 "산" 키워드 포함
부번이 있으면 "100-5" 형식

예시: "서울 강남구 역삼동 736", "전남 무안군 청계면 청천리 산 1-2", "세종 고용동 100"

시도가 누락된 주소(예: "역삼동 736")는 조회 불가 — 시도를 물어본다.

向用户请求包含道/特别市 + 市/郡/区 + 邑/面/洞 + 地号的地址。

最低必填信息：道/特别市、市/郡/区、邑/面/洞、主号
- 世宗特别自治市无市/郡/区，因此采用“世宗 [邑/面/洞] [地号]”格式
- 山地号需包含“山”关键词
- 有副号时采用“100-5”格式

示例："首尔江南区驿三洞736"、"全南务安郡青溪面青川里山1-2"、"世宗高用洞100"

若地址缺少道/特别市（例如："驿三洞736"）则无法查询 —— 需询问用户补充道/特别市信息。

2. 직접 호출

2. 直接调用

gongsijiga-search

모듈을 사용해 realtyprice.kr를 직접 호출한다 (API 키 불필요, 프록시 경유 안 함):

javascript

const { lookupGongsijiga } = require('gongsijiga-search');

const result = await lookupGongsijiga('서울 강남구 역삼동 736');

使用

gongsijiga-search

模块直接调用realtyprice.kr（无需API密钥，无需经过代理）：

javascript

const { lookupGongsijiga } = require('gongsijiga-search');

const result = await lookupGongsijiga('서울 강남구 역삼동 736');

3. 응답 해석 및 출력

3. 解析响应并输出

성공 응답 예시:

json

{
  "address": "서울 강남구 역삼동 736",
  "jibun": "736번지",
  "san": false,
  "latest": {
    "year": 2026,
    "price_per_sqm": 72340000,
    "notice_date": "2026-04-30",
    "base_date": "2026-01-01"
  },
  "history": [...],
  "yoy_change_pct": 5.45,
  "source_url": "https://www.realtyprice.kr/notice/gsindividual/search.htm"
}

출력 규칙:

반드시 "공시지가" 단어 사용. "가격/시세/매매가" 단어 금지.

헤더:

[정부 공시] 개별공시지가 — {address}

최신값:

{year}년 공시지가: {price_per_sqm:,}원/㎡ (전년 대비 +{yoy_change_pct}%)

추이 표 (history 배열을 연도순 테이블로):

연도	공시지가 (원/㎡)	공시일
2026	72,340,000	2026-04-30
...	...	...

마지막 줄 disclaimer:

본 단가는 세금 산정용 정부 공시 가격으로, 시세나 실거래가와 다릅니다.

成功响应示例：

json

{
  "address": "서울 강남구 역삼동 736",
  "jibun": "736번지",
  "san": false,
  "latest": {
    "year": 2026,
    "price_per_sqm": 72340000,
    "notice_date": "2026-04-30",
    "base_date": "2026-01-01"
  },
  "history": [...],
  "yoy_change_pct": 5.45,
  "source_url": "https://www.realtyprice.kr/notice/gsindividual/search.htm"
}

输出规则：

必须使用“公示地价”一词。禁止使用“价格/市价/买卖价”等词汇。

标题：

[政府公示] 个别公示地价 — {address}

4. 올해 미발표 안내

4. 当年未公示提示

latest.year

가 올해보다 작으면: "올해 공시지가는 아직 미발표 상태입니다. 최신 데이터는 {latest.year}년 기준입니다." 안내.

若

latest.year

小于当前年份，则提示："今年的公示地价尚未发布。最新数据为{latest.year}年基准。"

Failure modes

失败模式

error.code	의미	행동
`ADDRESS_PARSE_FAILED`	주소 파싱 실패	"행정구역 + 본번까지 포함된 주소가 필요합니다" + 예시
`INVALID_BUNJI`	본번 형식 오류	본번 입력 형식 재요청
`REGION_NOT_FOUND`	행정구역 매칭 실패	candidates 배열이 있으면 제안, 없으면 오타 확인 요청
`LAND_NOT_FOUND`	해당 지번 미등재	"본번/부번 오타이거나 도로/하천 등 미과세 토지" 설명
`UPSTREAM_ERROR`	realtyprice.kr 장애	"데이터 출처 일시 장애. 잠시 후 재시도" + source_url
`UPSTREAM_TIMEOUT`	30초 초과	UPSTREAM_ERROR와 동일

error.code	含义	处理方式
`ADDRESS_PARSE_FAILED`	地址解析失败	提示"需要包含行政区划+主号的完整地址"并给出示例
`INVALID_BUNJI`	主号格式错误	重新请求用户输入正确格式的主号
`REGION_NOT_FOUND`	行政区划匹配失败	若有候选列表则提供建议，若无则请用户检查是否输入错误
`LAND_NOT_FOUND`	该地块未登记	说明"可能是主号/副号输入错误，或是道路/河流等免税土地"
`UPSTREAM_ERROR`	realtyprice.kr故障	提示"数据源暂时故障，请稍后重试"并附上source_url
`UPSTREAM_TIMEOUT`	请求超时（超过30秒）	处理方式同UPSTREAM_ERROR

Notes

注意事项

공시지가 ≠ 시세. 시세는 통상 공시지가의 1.5~3배.
매년 1월 1일 기준, 4~~5월 발표. 1~~4월은 전년도가 최신.
realtyprice.kr는 API 키 불필요 (공개 데이터).

公示地价 ≠ 市价。市价通常为公示地价的1.5~3倍。
每年以1月1日为基准，4~~5月发布。1~~4月期间的最新数据为上一年度数据。
realtyprice.kr无需API密钥（公开数据）。