菜单
지역(시군구/읍면동)·주소·반경·단지명 중 하나로 청약홈 적재 분양공고를 조회해 단지·주택형·최고분양가·공급세대·입주월·상한제·원문링크를 표와 지도로 정리한다. "모집공고 검색", "이 지역 분양공고 찾아줘", "OO 청약공고", "분양공고 목록", "이 APT 모집공고" 등의 표현이 있으면 이 스킬을 사용한다.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | ipzitalk-announcement-search |
| description | 지역(시군구/읍면동)·주소·반경·단지명 중 하나로 청약홈 적재 분양공고를 조회해 단지·주택형·최고분양가·공급세대·입주월·상한제·원문링크를 표와 지도로 정리한다. "모집공고 검색", "이 지역 분양공고 찾아줘", "OO 청약공고", "분양공고 목록", "이 APT 모집공고" 등의 표현이 있으면 이 스킬을 사용한다. |
| version | 1.0.0 |
| license | proprietary |
tier: L1
지역/주소/단지명 하나로 청약홈 적재 분양공고 전량을 표와 지도로 훑는다. ※ 데이터 = 청약홈 분양정보 적재분만(실시간 청약홈 아님). 경쟁률·신청/당첨·접수일정 없음(공고일·입주월만). ※ 분양가 = 주택형별 최고가(평균 아님).
| 파라미터 | 필수 | 기본 | 설명 |
|---|---|---|---|
query(자유형) | ✅ | - | 지역명·주소·단지명·법정동코드 중 1개. 입력 해소 1단계에서 표준화. |
radius_km | ✕ | 5 | 좌표(주소·단지) 검색 시 반경(0.1~20) |
date_from/date_to | ✕ | - | 모집공고일 YYYY-MM-DD |
move_in_from/move_in_to | ✕ | - | 입주예정월 YYYY-MM |
exclusive_area_sqm | ✕ | - | 전용면적 필터(주택형 파싱값 ±1㎡) |
include_units | ✕ | true | 주택형·분양가 JOIN |
limit / offset | ✕ | 30 / 0 | 페이지네이션(limit 최대 100) |
⚠️ raw 입력을 지역 필터에 바로 꽂지 말 것. 지역 필터는 정확 일치라 "김포"→0건("김포시"만 매칭). 반드시 지역코드 정규화로 "○○시" 정확명을 얻어 사용한다. 매핑: 지역명은 정확명 또는 좌표+
radius_km, 주소·단지명은 좌표+radius_km, 세부동은 읍면동 필터. 좁히는 필터 없이 호출하면 과광범위 오류.
radius_km.사우동 527-1) 파싱 → 지오코딩 → confidence exact면 "주소 보완좌표"로 사용.
실패 시 단지명 주소검색. 둘 다 실패해야만 위치 미상.
→ 실증: 김포 사우동 4건(호반써밋 풍무Ⅱ·수자인 그라센트 1·2차·B5블록 호반써밋) 전부 exact 좌표 복구 → 위치 확인 필요 0건.#2563eb · 보완좌표 주황 #e56f1f). 반환 URL을 ipzi-data.mapUrl.templates/result.html에 ipzi-data JSON 주입. 표는 listings[].units[]로 rowspan 자동 병합.데이터 블록 하단에 .src 한 줄. 도구·API 이름은 쓰지 않는다. 사용자가 아는 기관명만.
| 블록 | 출처 표기 |
|---|---|
| 단지 개요·세대수·준공·주차·연차 | 공동주택관리정보시스템(K-apt) |
| 매매·전세·평당가·거래량 | 국토교통부 실거래가 |
| 학교·교통·생활·상권 등 장소 | 카카오맵 |
| 분양공고·분양가·주택형·입주월 | 청약홈 |
| 지도 (장소 마커) | 네이버 지도 · 카카오맵 |
| 지도 (분양공고 마커) | 네이버 지도 · 청약홈 |
ipzi-data JSON으로 받지 않고 템플릿 마크업에 직접 박는다.
어느 블록이 어디서 왔는지는 실행마다 달라지지 않는다. 데이터로 받으면 채우는 걸 잊거나 틀리게 쓸 여지만 생긴다.세대수·주차 — 공동주택관리정보시스템(K-apt) · 위치 — 카카오맵.
하나로 뭉뚱그리면 어느 숫자가 어디서 왔는지 사용자가 알 수 없다.산출물 HTML은 스킬 폴더 밖 문서에 의존하지 않는다. 규칙은 templates/result.html에 인라인돼 있다.
<symbol> 인라인 + <use> 참조로 self-contained. ICONS 화이트리스트에 없는 id는 렌더하지 않고 console.warn.prefers-color-scheme + :root[data-theme] 모두 대응.--bg --card --ink --sub --line --chip --g --y --o --r --x --brand(+ -s 배경 변형) · --mono.★·☆는 활자 기호이며 이모지가 아니다.정보없음(0으로 채우지 않는다). 값 추정 금지.fitBounds가 반경 원을 무시해 원이 잘리는 걸 막으려고
정북·남·동·서에 회색 더미 마커 4개를 심었다. 사용자에게는 정체를 알 수 없는 점으로 보여 혼란만 준다.
원이 잘리더라도 마커는 실제 장소만 찍는다. (근본 해결은 render.ts가 원을 bounds에 포함하도록 고치는 것 — 발견사항 6번)mapUrl이 null이면 지도 패널을 숨긴다. 지도 링크는 발급 후 7일간 유효하므로 캡션에 유효기간을 적는다.ipzi-data 비실행 JSON 블록 하나뿐 — 마크업·CSS·렌더 JS는 고정.templates/result.htmlipzi-data JSON: title/desc/chips/kpis/mapUrl/unlocated/listings(units[])/priceNote/footNote/sourceNote.| 상황 | 처리 |
|---|---|
| 필터 없음 → 과광범위 | 지역/주소/단지명/좌표 좁히도록 안내 |
| 더 있음(has_more) | 다음 offset으로 이어 조회(전량 수집) |
| 좌표 null | 지오코딩→단지명 주소검색 보완 후에만 위치 미상 판정 |
| 주택형 0건 | 공고만 표시, 분양가 "-"(지어내지 않음) |
| 적재 0건 | "적재된 분양공고 없음(실시간 아님)" 명시 |
입지톡 Remote 또는 OSS 실행 방식의 설치 상태를 확인하고 설치·전환·제거한다. 사용자가 입지톡 설정을 직접 실행하거나 설치 모드 관리를 요청했을 때만 사용한다.
시군구 여러 곳의 매매 거래량·중위 평당가·중위 거래가를 전월 대비로 비교해 지역 시장동향을 만든다. "최근 시장동향", "요즘 시장 어때", "거래 늘었어?", "어느 구가 오르나", "지역별 비교" 등의 표현이 있으면 이 스킬을 사용한다. 시군구 집계는 전용타입을 통일할 수 없어 구성 편향이 있으므로 "참고 신호"로만 제시한다.
기준 주소·단지명·지역 주변 반경의 K-apt 단지를 수집하고, 사용승인연차 분포를 0~10년, 10~20년, 20~30년, 30년+ 밴드로 분석한다. "노후도 분석", "신축/구축 비율", "주변 단지 연식", "오래된 아파트 많아?"를 물을 때 사용한다.
아파트명 또는 소재 주소 하나로 단지 개요·매매/전세 시세·최근 거래·주변 입지(교통·생활·교육)· 입주 예정 단지·인근 비교 단지를 한 장에 모아 보여준다. "이 아파트에 대해 전반적으로 알려줘", "이 아파트 한눈에 보기", "종합해서 알려줘", "이 아파트 전반적으로 정리해줘" 등의 표현이 있으면 이 스킬을 사용한다. 단일 항목만 물으면(시세만/학군만) 해당 단일 스킬을 쓴다. 범위를 밝히지 않은 "OO아파트 어때" 는 이 스킬이 아니라 단지 개요 요약(ipzitalk-complex-overview)으로 보낸다. 23크레딧이라 개요 요약(3크레딧)의 8배다. 애매하면 싼 쪽을 쓰고, 부족하면 이 스킬을 권한다.
단지명·주소·K-apt 코드 중 하나를 입력받아 K-apt 단지 개요를 한 장 요약으로 정리한다. 세대수, 사용승인연차, 시공사, 주차, 지하철/버스 도보분, 위치 식별자를 빠르게 보여준다. "단지 개요", "아파트 요약", "이 단지 어떤 곳", "간단히 정리", 그리고 범위를 밝히지 않은 "OO아파트 어때" 요청에 사용한다. 실거래·입지·인근 단지까지 필요하면 이 아파트 한눈에 보기(ipzitalk-complex-overview-all)를 권한다.
주소·단지명·K-apt 코드 중 하나 또는 비교할 단지 2개 이상을 입력받아 K-apt 단지 기본/상세정보를 조회하고, 세대수·동수·사용승인일·시공사·주차·승강기·CCTV·지하철 도보분·면적 믹스를 단지 스펙 카드 또는 비교표로 정리한다. "단지 스펙", "단지 비교", "주차 몇 대", "몇 년식", "단지 정보", "K-apt 정보", "아파트 상세"를 물을 때 사용한다.