lh-notice-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

LH 청약 공고문 조회

LH认购公告查询

What this skill does

本技能功能

한국토지주택공사(LH)가

apply.lh.or.kr

로 공고하는 임대주택·분양주택·주거복지(신혼희망타운 등)·토지·상가 공고를 공공데이터포털(

data.go.kr

)의 공식 LH 공고 Open API로 조회한다. 요청은

k-skill-proxy

의

/v1/lh-notice/*

라우트로 보내고, 결과는 공고 목록·공고 상세(주택형별 공급 정보)로 정리한다.

본 스킬은 사회초년생, 청년, 신혼부부처럼 LH 공고 존재 자체를 모르는 사용자가 공고 마감 전에 공고문을 빠르게 찾을 수 있도록 돕는다.

本技能通过公共数据门户（

data.go.kr

）的官方LH公告Open API，查询韩国土地住宅公社（LH）在

apply.lh.or.kr

发布的租赁住房、出售住房、居住福利（新婚希望小镇等）、土地、商铺公告。请求将发送至

k-skill-proxy

的

/v1/lh-notice/*

路由，结果整理为公告列表和公告详情（按住房类型划分的供应信息）。

本技能旨在帮助像职场新人、青年、新婚夫妇这类不知道LH公告存在的用户，在公告截止前快速找到公告文档。

When to use

使用场景

"LH 영구임대 공고 지금 뭐 올라와 있어?"
"신혼희망타운 공고 요즘 나온 거 정리해줘"
"부산광역시 LH 임대주택 공고중인 것 보여줘"
"전세임대 공고 중 마감 임박한 거 찾아줘"
"공고번호 2015122300019828 상세 정보 보여줘"
"행복주택 청년 모집 공고 요약해줘"

"现在有哪些LH永久租赁公告？"
"整理一下最近发布的新婚希望小镇公告"
"给我看看釜山广域市正在进行的LH租赁住房公告"
"找一下即将截止的全租租赁公告"
"给我看看公告编号2015122300019828的详细信息"
"总结一下幸福住房青年招募公告"

When not to use

不适用场景

개별 사용자의 자격 심사, 당첨 예측, 가점 계산
청약 신청 자동화/자동 제출 (본 스킬은 read-only 조회다)
청약통장·주택도시기금 계좌 업무 (해당 범위는 LH 공고와 별개다)
SH(서울주택도시공사)·GH(경기주택도시공사)·iH(인천도시공사) 전용 공고 (본 스킬은 LH 공고만 다룬다)

个别用户的资格审核、中标预测、加分计算
认购申请自动化/自动提交（本技能仅支持只读查询）
认购存折、住房城市基金账户业务（该范围与LH公告无关）
SH（首尔住房城市公社）、GH（京畿住房城市公社）、iH（仁川城市公社）专属公告（本技能仅处理LH公告）

Inputs

输入参数

panSs

(또는

status

): 공고 상태.

공고중

접수중

접수마감

당첨자발표

추정공고

중 하나. 비우면 전체.

```
uppAisTpCd
```
(또는
```
category
```
): 주택 대분류.
```
01
```
(토지),
```
05
```
(분양주택),
```
06
```
(임대주택),
```
13
```
(주거복지·신혼희망타운),
```
22
```
(상가).
```
aisTpCd
```
: 세부 분류 코드 (숫자). 예:
```
09
```
=영구임대,
```
10
```
=행복주택,
```
17
```
=전세임대.

cnpCdNm

(또는

region

): 지역명. 예:

서울특별시

부산광역시

전국

```
panNm
```
(또는
```
q
```
,
```
keyword
```
): 공고명 부분 검색 키워드. 예:
```
행복주택
```
,
```
청년
```
,
```
든든주택
```
.
```
panNtStDt
```
(또는
```
startDate
```
): 공고 게시일 시작. YYYY-MM-DD / YYYYMMDD / YYYY.MM.DD 모두 허용.
```
clsgDt
```
(또는
```
endDate
```
): 접수 마감일 종료. 날짜 포맷 동일.
```
page
```
(기본 1, 최대 1000),
```
pageSize
```
(기본 50, 최대 1000).

상세 조회 (

/v1/lh-notice/detail

) 는

panId

ccrCnntSysDsCd

splInfTpCd

세 값 모두 필수다. 이 값은 목록 응답의

pan_id

ccr_cnnt_sys_ds_cd

spl_inf_tp_cd

를 그대로 쓰면 된다.

```
panSs
```
（或
```
status
```
）：公告状态。可选值为
```
공고중
```
（公告中）、
```
접수중
```
（受理中）、
```
접수마감
```
（受理截止）、
```
당첨자발표
```
（中标者公布）、
```
추정공고
```
（预计公告）。留空则返回全部。
```
uppAisTpCd
```
（或
```
category
```
）：住房大分类。
```
01
```
（土地）、
```
05
```
（出售住房）、
```
06
```
（租赁住房）、
```
13
```
（居住福利·新婚希望小镇）、
```
22
```
（商铺）。
```
aisTpCd
```
：细分分类代码（数字）。示例：
```
09
```
=永久租赁，
```
10
```
=幸福住房，
```
17
```
=全租租赁。
```
cnpCdNm
```
（或
```
region
```
）：地区名称。示例：
```
서울특별시
```
（首尔特别市）、
```
부산광역시
```
（釜山广域市）、
```
전국
```
（全国）。
```
panNm
```
（或
```
q
```
、
```
keyword
```
）：公告名称部分搜索关键词。示例：
```
행복주택
```
（幸福住房）、
```
청년
```
（青年）、
```
든든주택
```
（安心住房）。
```
panNtStDt
```
（或
```
startDate
```
）：公告发布起始日期。支持YYYY-MM-DD / YYYYMMDD / YYYY.MM.DD格式。
```
clsgDt
```
（或
```
endDate
```
）：受理截止结束日期。日期格式同上。
```
page
```
（默认1，最大1000）、
```
pageSize
```
（默认50，最大1000）。

详情查询（

/v1/lh-notice/detail

）需要

panId

、

ccrCnntSysDsCd

、

splInfTpCd

三个必填参数。可直接使用列表响应中的

pan_id

、

ccr_cnnt_sys_ds_cd

、

spl_inf_tp_cd

值。

Prerequisites

前置条件

인터넷 연결
```
curl
```
(또는 동일한 HTTP 호출이 가능한 도구)

사용자에게 필요한 시크릿은 없다. 공공데이터포털

DATA_GO_KR_API_KEY

는

k-skill-proxy

서버 쪽에만 둔다.

网络连接
```
curl
```
（或其他可发起HTTP请求的工具）

用户无需提供密钥。公共数据门户的

DATA_GO_KR_API_KEY

仅需部署在

k-skill-proxy

服务器端。

Default path

默认路径

KSKILL_PROXY_BASE_URL

환경변수가 있으면 그 값, 없으면 기본

https://k-skill-proxy.nomadamas.org

를 사용한다.

bash

BASE="${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}"
BASE="${BASE%/}"

若存在

KSKILL_PROXY_BASE_URL

环境变量则使用其值，否则默认使用

https://k-skill-proxy.nomadamas.org

。

bash

BASE="${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}"
BASE="${BASE%/}"

Supported endpoints

支持的端点

공고 목록 조회

公告列表查询

GET /v1/lh-notice/search

필터는 선택사항이다. 필터 없이 호출하면 최근 공고를 상태 무관하게 최대 50건 돌려준다. 마감 임박한 공고만 보고 싶다면

panSs=공고중

과

clsgDt

로 구간을 좁힌다.

GET /v1/lh-notice/search

过滤器为可选参数。无过滤器调用时，将返回最多50条不限状态的最新公告。若仅需查看即将截止的公告，可通过

panSs=공고중

和

clsgDt

缩小范围。

공고 상세 조회

公告详情查询

GET /v1/lh-notice/detail?panId={공고ID}&ccrCnntSysDsCd={연계시스템코드}&splInfTpCd={공급정보유형코드}

상세 응답은

notice

(공고 요약) +

supply_infos

(주택형/필지/상가호 별 공급 정보 배열) 를 돌려준다.

GET /v1/lh-notice/detail?panId={公告ID}&ccrCnntSysDsCd={关联系统代码}&splInfTpCd={供应信息类型代码}

详情响应将返回

notice

（公告摘要） +

supply_infos

（按住房类型/地块/商铺号划分的供应信息数组）。

Example requests

请求示例

목록 — 부산 영구임대 공고중

列表 — 釜山正在公告的永久租赁住房

bash

curl -fsS --get "${BASE}/v1/lh-notice/search" \
  --data-urlencode 'panSs=공고중' \
  --data-urlencode 'uppAisTpCd=06' \
  --data-urlencode 'cnpCdNm=부산광역시' \
  --data-urlencode 'pageSize=20'

bash

curl -fsS --get "${BASE}/v1/lh-notice/search" \
  --data-urlencode 'panSs=공고중' \
  --data-urlencode 'uppAisTpCd=06' \
  --data-urlencode 'cnpCdNm=부산광역시' \
  --data-urlencode 'pageSize=20'

목록 — 키워드 "행복주택" 으로 접수중

列表 — 关键词「幸福住房」且受理中的公告

bash

curl -fsS --get "${BASE}/v1/lh-notice/search" \
  --data-urlencode 'q=행복주택' \
  --data-urlencode 'status=접수중'

bash

curl -fsS --get "${BASE}/v1/lh-notice/search" \
  --data-urlencode 'q=행복주택' \
  --data-urlencode 'status=접수중'

상세 — 특정 공고

详情 — 特定公告

bash

curl -fsS --get "${BASE}/v1/lh-notice/detail" \
  --data-urlencode 'panId=2015122300019828' \
  --data-urlencode 'ccrCnntSysDsCd=03' \
  --data-urlencode 'splInfTpCd=051'

bash

curl -fsS --get "${BASE}/v1/lh-notice/detail" \
  --data-urlencode 'panId=2015122300019828' \
  --data-urlencode 'ccrCnntSysDsCd=03' \
  --data-urlencode 'splInfTpCd=051'

Response shape

响应格式

목록 응답

列表响应

json

{
  "items": [
    {
      "pan_id": "2015122300019828",
      "pan_nm": "2026년 상반기 부산광역시 영구임대주택 예비입주자 모집 공고",
      "upp_ais_tp_cd": "06",
      "ais_tp_cd": "09",
      "ais_tp_cd_nm": "영구임대",
      "cnp_cd_nm": "부산광역시",
      "pan_ss": "공고중",
      "pan_dt": "2026-04-21",
      "clsg_dt": "2026-05-06",
      "rcrit_pblanc_dt": null,
      "spl_inf_tp_cd": "051",
      "ccr_cnnt_sys_ds_cd": "03",
      "detail_url": "https://apply.lh.or.kr/lhapply/apply/wt/wrtanc/selectWrtancInfo.do?panId=2015122300019828&..."
    }
  ],
  "summary": {
    "page": 1,
    "page_size": 20,
    "returned_count": 1,
    "total_count": 1
  },
  "query": {
    "pan_ss": "공고중",
    "upp_ais_tp_cd": "06",
    "cnp_cd_nm": "부산광역시"
  },
  "proxy": {
    "name": "k-skill-proxy",
    "cache": { "hit": false, "ttl_ms": 300000 }
  }
}

json

{
  "items": [
    {
      "pan_id": "2015122300019828",
      "pan_nm": "2026年上半年釜山广域市永久租赁住房预备入住者招募公告",
      "upp_ais_tp_cd": "06",
      "ais_tp_cd": "09",
      "ais_tp_cd_nm": "영구임대"（永久租赁）,
      "cnp_cd_nm": "부산광역시"（釜山广域市）,
      "pan_ss": "공고중"（公告中）,
      "pan_dt": "2026-04-21",
      "clsg_dt": "2026-05-06",
      "rcrit_pblanc_dt": null,
      "spl_inf_tp_cd": "051",
      "ccr_cnnt_sys_ds_cd": "03",
      "detail_url": "https://apply.lh.or.kr/lhapply/apply/wt/wrtanc/selectWrtancInfo.do?panId=2015122300019828&..."
    }
  ],
  "summary": {
    "page": 1,
    "page_size": 20,
    "returned_count": 1,
    "total_count": 1
  },
  "query": {
    "pan_ss": "공고중",
    "upp_ais_tp_cd": "06",
    "cnp_cd_nm": "부산광역시"
  },
  "proxy": {
    "name": "k-skill-proxy",
    "cache": { "hit": false, "ttl_ms": 300000 }
  }
}

상세 응답

详情响应

json

{
  "notice": {
    "pan_id": "2015122300019828",
    "pan_nm": "2026년 상반기 부산광역시 영구임대주택 예비입주자 모집 공고",
    "ais_tp_cd_nm": "영구임대",
    "...": "목록 응답과 동일한 필드"
  },
  "supply_infos": [
    { "HOUSE_TY": "영구임대 29㎡", "SPL_CNT": "120" },
    { "HOUSE_TY": "영구임대 39㎡", "SPL_CNT": "80" }
  ],
  "query": {
    "pan_id": "2015122300019828",
    "ccr_cnnt_sys_ds_cd": "03",
    "spl_inf_tp_cd": "051"
  },
  "proxy": { "...": "..." }
}

json

{
  "notice": {
    "pan_id": "2015122300019828",
    "pan_nm": "2026年上半年釜山广域市永久租赁住房预备入住者招募公告",
    "ais_tp_cd_nm": "영구임대"（永久租赁）,
    "...": "与列表响应相同的字段"
  },
  "supply_infos": [
    { "HOUSE_TY": "永久租赁 29㎡", "SPL_CNT": "120" },
    { "HOUSE_TY": "永久租赁 39㎡", "SPL_CNT": "80" }
  ],
  "query": {
    "pan_id": "2015122300019828",
    "ccr_cnnt_sys_ds_cd": "03",
    "spl_inf_tp_cd": "051"
  },
  "proxy": { "...": "..." }
}

Response policy

响应规则

공식 LH 공고(
```
apply.lh.or.kr
```
) 정보만 사용한다. 커뮤니티 요약, 블로그 후기, 사설 부동산 정보는 섞지 않는다.
마감 여부는 KST 기준 현재 날짜와
clsg_dt
를 비교해 판정한다. 오늘 = 마감일이면 "오늘 마감"으로 표기한다.
상세 응답의
```
detail_url
```
을 항상 함께 보여 준다. 사용자는 공고문 원본으로 바로 접근할 수 있어야 한다.
공고번호(
```
pan_id
```
) 를 숨기지 말고 요약에 포함한다. 이후 상세 조회에 그대로 쓴다.
본 스킬은 SH·GH·iH 공고를 포함하지 않는다. 사용자가 서울시·경기도·인천시 공사 공고를 찾으면 본 스킬로는 못 찾는다는 점을 분명히 말한다.

仅使用官方LH公告（
```
apply.lh.or.kr
```
）信息，不混入社区摘要、博客评论、私营房地产信息。
截止状态以KST（韩国标准时间）当前日期与
clsg_dt
对比判定。若当天为截止日期，则标注为「今日截止」。
详情响应需始终附带
```
detail_url
```
，确保用户可直接访问公告原文。
公告编号（
```
pan_id
```
）需包含在摘要中，不可隐藏，以便后续直接用于详情查询。
本技能不包含SH·GH·iH公告。若用户查找首尔市·京畿道·仁川市公社公告，需明确告知无法通过本技能查询。

Keep the answer compact

精简回复规则

사용자에게 돌려줄 때는 이렇게 압축한다.

필터 요약: 지역 + 공고 유형 + 상태
결과 건수 (
```
summary.total_count
```
와
```
returned_count
```
)
상위 3-5건 대표 공고: 공고명, 지역, 공고일, 마감일, 상태, 링크
마감 임박(D-3 이하) 공고는 별도로 강조
상세 조회 제안: "공고번호 X 상세 보고 싶으면
```
lh-notice/detail
```
로 조회"

向用户返回结果时需按以下方式精简：

过滤器摘要：地区 + 公告类型 + 状态
结果数量（
```
summary.total_count
```
和
```
returned_count
```
）
3-5条代表性公告：公告名称、地区、发布日期、截止日期、状态、链接
即将截止（D-3以内）的公告需单独强调
详情查询提示：「若想查看公告编号X的详情，请调用
```
lh-notice/detail
```
查询」

Failure modes

异常场景

필터 값이 잘못되면
```
400 bad_request
```
가 돌아온다. 오류 메시지를 그대로 노출해 사용자가 교정하게 한다.
프록시 서버에
```
DATA_GO_KR_API_KEY
```
가 없으면
```
503 upstream_not_configured
```
가 돌아온다.
upstream(공공데이터포털) 이 일시 장애이면
```
502 upstream_error
```
+
```
upstream_code
```
를 돌려준다. 재시도는 캐시되지 않으므로 바로 다시 호출해도 된다.
upstream 이 XML 에러 envelope(
```
OpenAPI_ServiceResponse
```
) 를 돌려주면
```
502 upstream_error
```
+
```
upstream_code
```
(예:
```
30
```
= 등록되지 않은 서비스키) 로 변환한다.
응답이 JSON 이 아니면
```
502 upstream_invalid_payload
```
로 내려간다.

过滤器参数错误时，将返回
```
400 bad_request
```
。需直接展示错误信息，引导用户修正。

代理服务器未配置

DATA_GO_KR_API_KEY

时，将返回

503 upstream_not_configured

。

上游（公共数据门户）临时故障时，将返回
```
502 upstream_error
```
+
```
upstream_code
```
。由于响应未缓存，可直接重试调用。
上游返回XML错误包（
```
OpenAPI_ServiceResponse
```
）时，将转换为
```
502 upstream_error
```
+
```
upstream_code
```
（例如：
```
30
```
= 未注册的服务密钥）。
响应非JSON格式时，将返回
```
502 upstream_invalid_payload
```
。

Done when

完成标准

사용자의 지역·공고 유형·상태 의도에 맞춰 적어도 한 번
```
/v1/lh-notice/search
```
를 호출했다.
결과에 공고명, 지역, 공고일/마감일, 상태, 공식 링크가 모두 포함되어 있다.
마감 여부를 KST 기준으로 판정해 표기했다.
필요하면 상세 조회로 이어가거나 사용자가 스스로 상세를 조회할 수 있도록
```
panId
```
/
```
ccrCnntSysDsCd
```
/
```
splInfTpCd
```
를 함께 안내했다.

已根据用户的地区·公告类型·状态意图，至少调用一次
```
/v1/lh-notice/search
```
。
结果包含公告名称、地区、发布日期/截止日期、状态、官方链接。
已按KST标准判定截止状态并标注。
必要时引导用户进行详情查询，或提供
```
panId
```
/
```
ccrCnntSysDsCd
```
/
```
splInfTpCd
```
以便用户自行查询详情。

Notes

备注

공식 LH 청약플러스 포털:

https://apply.lh.or.kr/lhapply/apply/wt/wrtanc/selectWrtancList.do?mi=1026

공공데이터포털 카탈로그:
```
https://www.data.go.kr/data/15058530/openapi.do
```
(LH 임대공고문 정보)
upstream
```
panSs
```
값은 한국어로 정확히 맞춰서 보낸다. 영문/공백 변형은 받지 않는다.
대분류/세부분류 코드 매핑 참고:
- ```
06
```
  임대주택:
```
09
```
  영구임대,
```
10
```
  행복주택,
```
17
```
  전세임대,
```
08
```
  국민임대,
```
26
```
  매입임대 등
- ```
13
```
  주거복지:
```
17
```
  전세임대, 신혼희망타운 등
- ```
05
```
  분양주택,
```
01
```
  토지,
```
22
```
  상가

官方LH认购Plus门户：

https://apply.lh.or.kr/lhapply/apply/wt/wrtanc/selectWrtancList.do?mi=1026

公共数据门户目录：
```
https://www.data.go.kr/data/15058530/openapi.do
```
（LH租赁公告信息）
上游
```
panSs
```
参数需严格使用韩文，不接受英文/空格变体。
大分类/细分分类代码映射参考：
- ```
06
```
  租赁住房：
```
09
```
  永久租赁、
```
10
```
  幸福住房、
```
17
```
  全租租赁、
```
08
```
  国民租赁、
```
26
```
  购买租赁等
- ```
13
```
  居住福利：
```
17
```
  全租租赁、新婚希望小镇等
- ```
05
```
  出售住房、
```
01
```
  土地、
```
22
```
  商铺