메뉴
기준 주소·단지명·지역 주변 반경의 K-apt 단지를 수집하고, 세대당 주차대수 기준으로 랭킹을 만든다. "주차 좋은 단지", "세대당 주차", "주차 랭킹", "이 지역 아파트 주차 비교"를 물을 때 사용한다. enrich_complex_info의 parking_total과 get_complex_info(detail)의 derived.parking_per_unit을 함께 활용한다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
입지톡 Remote 또는 OSS 실행 방식의 설치 상태를 확인하고 설치·전환·제거한다. 사용자가 입지톡 설정을 직접 실행하거나 설치 모드 관리를 요청했을 때만 사용한다.
시군구 여러 곳의 매매 거래량·중위 평당가·중위 거래가를 전월 대비로 비교해 지역 시장동향을 만든다. "최근 시장동향", "요즘 시장 어때", "거래 늘었어?", "어느 구가 오르나", "지역별 비교" 등의 표현이 있으면 이 스킬을 사용한다. 시군구 집계는 전용타입을 통일할 수 없어 구성 편향이 있으므로 "참고 신호"로만 제시한다.
지역(시군구/읍면동)·주소·반경·단지명 중 하나로 청약홈 적재 분양공고를 조회해 단지·주택형·최고분양가·공급세대·입주월·상한제·원문링크를 표와 지도로 정리한다. "모집공고 검색", "이 지역 분양공고 찾아줘", "OO 청약공고", "분양공고 목록", "이 APT 모집공고" 등의 표현이 있으면 이 스킬을 사용한다.
기준 주소·단지명·지역 주변 반경의 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)를 권한다.
| name | ipzitalk-parking-ranking |
| description | 기준 주소·단지명·지역 주변 반경의 K-apt 단지를 수집하고, 세대당 주차대수 기준으로 랭킹을 만든다. "주차 좋은 단지", "세대당 주차", "주차 랭킹", "이 지역 아파트 주차 비교"를 물을 때 사용한다. enrich_complex_info의 parking_total과 get_complex_info(detail)의 derived.parking_per_unit을 함께 활용한다. |
| version | 1.0.4 |
| license | proprietary |
tier: L1
반경 내 K-apt 매칭 단지의 parking_total / total_units 또는 derived.parking_per_unit으로 세대당 주차 랭킹을 만든다.
| 파라미터 | 필수 | 기본값 | 설명 |
|---|---|---|---|
target | ✅ | - | 기준 주소/단지명/지역명/법정동코드 |
radius_m | ✕ | 2000 | 후보 수집 반경 |
limit | ✕ | 20 | 후보 단지 수 |
detail_threshold | ✕ | 필요시 | enrich 값 부족 단지만 detail 보강 |
| 도구 | 용도 |
|---|---|
resolve-site 규약 | 기준점 좌표·코드 확보 |
search_by_nearby_keyword(preset="apartment", grid=true) | 후보 단지 수집 |
enrich_complex_info | K-apt 매칭 + parking_total/total_households 1차 확보 |
get_complex_info(detail=true) | 주차 지상/지하 및 derived.parking_per_unit 보강 |
get_map_embed_url | 랭킹 지도 생성 |
search_by_nearby_keyword(..., preset="apartment", grid=true).enrich_complex_info로 parking_total, total_households, use_approval_date 확보.derived.parking_per_unit을 그대로 믿지 말 것. 서버가 (parking_ground ?? 0) + (parking_underground ?? 0)로
계산해서, 한쪽만 결측이면 그 값을 0으로 흡수해 조용히 과소 산출한다.get_complex_info(detail=true)의 원값 parking_ground·parking_underground를 직접 확인한다.
derived.parking_per_unit과 일치해야 정상).null → 판정 유보(자료없음). 합산 금지.parking_total / total_households 계산.parking_total=0 또는 null은 실제 0인지 결측인지 확인 전까지 랭킹 제외 또는 자료없음.검색 기준으로 강조한다.검색 기준 단지: 자료없음/제외 사유 카드를 표시한다.방배롯데캐슬아르떼, 반경 2kmtemplates/result.html검색 기준 라벨을 붙인다.ipzi-data.rows 에서 직접 잘라 쓴다.
🚨 별도 데이터 필드를 만들지 말 것. 따로 채우면 왼쪽 표와 숫자가 어긋난다.#scope-card)로 낸다. 지도 아래, 푸터 위.
<br> 로 이어붙이지 말 것. 예전엔 그렇게 했고,
"어느 단지가 왜 빠졌는가"가 잡문에 묻혀 보이지 않았다.excluded 가 비고 sampleNote 도 없으면 카드째 숨는다(전수 랭킹이면 표시할 게 없다).공동주택관리정보시스템(K-apt) · 카카오맵 · 네이버 지도.
내부 필드명(주차 원값 등)은 화면에 노출하지 않는다.result.json에 저장한다. 사용자 전달 HTML은 고정 정본 templates/result.html로 렌더하며, 마크업·CSS·렌더 JS는 손대지 않는다.../../scripts/html_artifact_contract.mjs를 --file-name "<기준대상>_주차랭킹"과 함께 사용한다. 최종 파일명은 <기준대상>_주차랭킹.html이며 공용 렌더러가 경로 문자·예약문자·길이를 안전화한다.shell-free 또는 셸 금지 환경에서는 File Read/Write로 templates/result.html을 읽고 비실행 ipzi-data JSON 블록만 교체한다. 교체 전후의 fixed template region(고정 영역: 데이터 블록 앞 prefix와 뒤 suffix)이 원본과 같은지 비교한다.sandbox="allow-scripts allow-same-origin"·referrerpolicy="strict-origin-when-cross-origin"를 제거하지 않는다.result.json·audit.json을 유지하되, 사용자 전달 HTML을 result.html이나 index.html이라는 고정 이름으로 내지 않는다.| 상황 | 처리 |
|---|---|
| parking 값 null | 자료없음, 0으로 간주 금지 |
parking_ground/parking_underground 중 한쪽만 null | 판정 유보. derived.parking_per_unit은 과소값이므로 사용 금지 |
| total_households/units 없음 | 세대당 계산 금지 |
| 후보 매칭 실패 많음 | 매칭률과 미매칭 수 표시 |
| 반경 후보 과다 | limit/offset 또는 소반경 샘플로 데모, 전수 아님 표기 |
공동주택관리정보시스템(K-apt)과 링크 https://www.k-apt.go.kr/web/main/index.do를 함께 표시한다.데이터 블록 하단에 .src 한 줄. 도구·API 이름은 쓰지 않는다. 사용자가 아는 기관명만.
| 블록 | 출처 표기 |
|---|---|
| 단지 개요·세대수·준공·주차·연차 | 공동주택관리정보시스템(K-apt) |
| 매매·전세·평당가·거래량 | 국토교통부 실거래가 |
| 학교·교통·생활·상권 등 장소 | 카카오맵 |
| 분양공고·분양가·주택형·입주월 | 청약홈 |
| 지도 (장소 마커) | 네이버 지도 · 카카오맵 |
| 지도 (분양공고 마커) | 네이버 지도 · 청약홈 |
ipzi-data JSON으로 받지 않고 템플릿 마크업에 직접 박는다.
어느 블록이 어디서 왔는지는 실행마다 달라지지 않는다. 데이터로 받으면 채우는 걸 잊거나 틀리게 쓸 여지만 생긴다.세대수·주차 — 공동주택관리정보시스템(K-apt) · 위치 — 카카오맵.
하나로 뭉뚱그리면 어느 숫자가 어디서 왔는지 사용자가 알 수 없다.스킬 폴더 밖 문서에 의존하지 않도록 규칙을 여기 인라인으로 둔다.
<symbol> 인라인 + <use> 참조로 self-contained.prefers-color-scheme + :root[data-theme] 모두 대응.--g/--y/--o/--r/--x/--brand/--up/--down/--zebra (+ -s 배경 변형).null은 "정보없음"(0 아님) · 표본 부족은 판정 유보 · 45건 캡 도달은 "목록 불완전" 표기.★·☆는 활자 기호이며 이모지가 아니다. 등급 표기에 사용 가능..map{overflow-x:auto; overflow-y:hidden} + .map iframe{display:block; min-width:720px}.
overflow:hidden만 주면 iframe이 카드 폭에 짓눌려 지도가 최소 줌(한반도)으로 떨어진다.fitBounds가 반경 원을 무시해 원이 잘리는 걸 막으려고
정북·남·동·서에 회색 더미 마커 4개를 심었다. 사용자에게는 정체를 알 수 없는 점으로 보여 혼란만 준다.
원이 잘리더라도 마커는 실제 장소만 찍는다. (근본 해결은 render.ts가 원을 bounds에 포함하도록 고치는 것 — 발견사항 6번)enrich_complex_info 는 이름이 같은 단지도 떨어뜨린다 (실측 2026-07-10)"K-apt 미매칭 = 그 단지가 없다"가 아니다. 좌표가 어긋나면 이름이 글자까지 같아도 제외된다.
위례2차아이파크아파트 실측 — K-apt 에 분명히 있다(A10027553 · 495세대 · 세대당 주차 1.76):
카카오 좌표 37.479738, 127.143743
K-apt 좌표 └─ 261m 떨어져 있음 ← 기본 radius_m=250 을 11m 넘긴다
radius_m | 이름 완전일치 후보 | 이름 무관 후보(힐스테이트) | 결과 |
|---|---|---|---|
| 250 (기본) | 후보에 없음 | 104m | NEARBY_BUT_NAME_MISMATCH |
| 400 | 0.543 | 0.558 ← 더 높다 | NEARBY_BUT_NAME_MISMATCH |
| 500 | 0.635 (임계 0.65에 0.015 부족) | 0.594 | LOW_CONFIDENCE_MATCH |
점수가 radius_m 에 따라 움직이고, 이름 완전일치가 거리에 밀린다. 반경을 늘려도 해결되지 않는다.
not_found 를 "K-apt 미매칭"으로 뭉뚱그려 적지 않는다. 도구가 주는 reason 을 그대로 구분해 쓴다.
NO_COMPLEX_WITHIN_RADIUS(반경 안에 후보 없음) · NEARBY_BUT_NAME_MISMATCH(후보는 있으나 이름 불일치)
· LOW_CONFIDENCE_MATCH(임계 미달). 사유가 다르면 사용자가 할 일도 다르다.candidates[] 에 입력과 이름이 사실상 같은 후보가 있으면 화면에 보인다.
조용히 버리면 "반경 내 전수"라고 읽힌다. 표본 수를 인용할 때 누락 가능성을 함께 적는다.matched(score 0.75)가 난다.
→ 후보 좌표는 반드시 그 단지의 카카오 좌표를 넣는다. 기준 단지 좌표를 돌려쓰면 엉뚱한 단지로 바뀐다.not_found 여도 candidates[] 는 kapt_code 를 함께 준다. 반경만 넓히면 이름 완전일치 후보가 그 안에 나타난다.
1. enrich_complex_info(complexes, radius_m=500) ← 기본 250 으로는 후보에조차 안 뜬다
2. status != "matched" 인 항목의 candidates[] 를 훑는다
3. 정규화한 이름이 입력과 같으면(공백·'아파트' 꼬리 제거 후 일치) 그 kapt_code 를 채택
4. get_complex_info(kapt_code, detail=true) 로 값을 직접 가져와 랭킹에 넣는다
5. 화면에 "좌표 불일치로 자동 매칭 실패 → 이름 일치로 복구" 를 명시한다
실측: 위례2차아이파크아파트 는 radius_m=500 에서 candidates[0] 으로 나오고(A10027553, 261m, score 0.635),
get_complex_info 는 parking_per_unit 1.76 을 정상 반환한다.
아파트 꼬리 제거 후 완전일치만 복구한다.
위례아이파크 와 위례2차아이파크 는 다른 단지다. 애매하면 복구하지 말고 제외 사유를 적는다.ipzitalk MCP 도구의 네임스페이스는 실행 환경(Codex, Claude Code, Hermes, claude.ai 커넥터 등)에 따라 다르다.
이 문서에 적힌 도구 이름(search_announcement_info, get_geocode, get_map_embed_url 등)은 접두사 없는 기본 도구명(base tool name) 이다.
ipzitalk-remote 플러그인의 ipzitalk 서버 provenance가 확인되는 도구만 우선 사용한다. Codex에서는 실제 도구 호출 이벤트의 server: ipzitalk과 기본 도구명을 기준으로 확인한다.presale-mcp 또는 다른 로컬 MCP provenance의 동명 도구는 Remote Skill의 대체 수단으로 사용하지 않는다.클라이언트가 연결 도구 목록에 plugin/server provenance를 구조적으로 제공하지 않을 때만 다음 명시적 fallback을 사용한다.
mcp__plugin_ipzitalk-remote_ipzitalk__<도구명>mcp__ipzitalk_mcp__<도구명>mcp__ipzitalk__<도구명>mcp__claude_ai_ipzitalk__<도구명>fallback으로도 Remote 출처를 유일하게 확인할 수 없으면 값을 추정하지 말고, 사용자에게 ipzitalk Remote MCP 연결 상태를 확인하도록 안내한 뒤 중단한다.