菜单
지역 또는 단지 주변의 청약홈 분양공고를 한 장으로 정리한다. 최근 6개월 신규 공고를 먼저 보여주고, 이어서 등록된 전량을 KPI·지도·입주 타임라인·공급유형/전용면적 도넛·연도별 물량·공고 목록으로 종합한다. "OO시 분양 어때", "분양 현황", "요즘 분양 뭐 있어", "이번달 신규 청약", "분양 리포트", "이 지역 분양물량", "분양 브리핑", "분양 대시보드" 등의 표현이 있으면 이 스킬을 사용한다.
用 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-presale-report |
| description | 지역 또는 단지 주변의 청약홈 분양공고를 한 장으로 정리한다. 최근 6개월 신규 공고를 먼저 보여주고, 이어서 등록된 전량을 KPI·지도·입주 타임라인·공급유형/전용면적 도넛·연도별 물량·공고 목록으로 종합한다. "OO시 분양 어때", "분양 현황", "요즘 분양 뭐 있어", "이번달 신규 청약", "분양 리포트", "이 지역 분양물량", "분양 브리핑", "분양 대시보드" 등의 표현이 있으면 이 스킬을 사용한다. |
| version | 1.1.4 |
| license | proprietary |
지역 하나를 입력받아 최근 신규와 전체 물량을 한 화면에 낸다. ※ 청약홈에 등록된 공고를 정리한 것이며 실시간 청약 일정이 아니다. 경쟁률·접수·발표 일정은 담지 않는다.
전량 1콜로 두 화면을 만든다. "최근 6개월"은 전량의 부분집합이므로
서버에 date_from을 넘길 필요가 없다. 전량을 받아 공고일로 거른다.
0건을 실패가 아니라 정보로 만든다. 최근 신규가 없으면 "최근 신규 공고 없음 · 마지막 공고 2025-08-19" 라고 쓰고, 하단 대시보드는 그대로 낸다. (송파구 실측: 전량 5건, 최근 6개월 0건. 최신 공고가 11개월 전이다.)
| 파라미터 | 필수 | 기본 | 설명 |
|---|---|---|---|
query(자유형) | ✅ | - | 지역명·주소·단지명·법정동코드 중 1개 |
recent_months | ✕ | 6 | 상단 "신규" 블록의 기간(공고일 기준) |
radius_km | ✕ | 3 | 주소·단지명 입력일 때만. 지역명이면 시군구 전량 |
스코프는 입력이 정한다.
⚠️ 지역 필터는 정확 일치다.
"김포"→ 0건,"김포시"→ 18건. raw 지역명을 필터에 그대로 넣지 말고 지역코드 정규화로 정확명을 만든 뒤 쓴다.
| 도구 | 용도 | 콜 |
|---|---|---|
get_region_code / get_geocode / get_address | 입력 해소 | 0~1 |
search_announcement_info(include_units=true, limit=100) | 전량 1콜 | 1 |
get_map_embed_url | 지도 | 1 |
| 2~3 |
search_announcement_info(sigungu=정확명, include_units=true, limit=100).
has_more이면 offset으로 이어 받는다. 안 받으면 조용히 잘린다.announcement_date >= 오늘-6개월만 고른다.
🚨 서버 날짜 필터를 쓰지 않는다. 아래 §감사장치 부재 참조.unlocated는 지번 지오코딩 → 단지명 주소검색.units 세대수 합 ≠ total_supply공공분양은 주택형을 전부 공개하지 않는다. 버그가 아니라 원천 데이터 특성이다.
남양주시 32건 중 11건 불일치. 합계 차이 4,001세대. 불일치 11건은 전부 LH·공공분양.
남양주진접2 A-1 공공분양 total_supply 920 vs Σ(units) 263 (−657)
왕숙 아테라 공공분양 812 vs 182 (−630)
덕소역 라온프라이빗 (민간) 348 vs 348 (일치)
주택형이 공개된 세대 기준임을 화면에 명시한다.
남양주: 총 공급 10,589 중 공개분 6,588세대(62%).총 공급세대와 도넛 합계가 다른 것이 정상이다. 억지로 맞추지 말 것.
맞추려 들면 없는 세대를 만들어낸다.⚠️ 예전
regional-presale-dashboard는"areaMix 합계 == 총 공급세대. 어긋나면 주택형을 빠뜨린 것"이라고 적었는데 틀렸다. 민간 위주 지역(송파 5건)에서 우연히 맞았을 뿐이다.
filters에 date_from이 안 실린다search_announcement_info(sigungu="송파구") → matched_count 5
search_announcement_info(sigungu="송파구", date_from="2026-01-10") → matched_count 0
두 응답의 summary.filters 는 {"sigungu":"송파구"} 로 글자 그대로 같다.
서버 필터는 정상 동작하지만 적용 여부가 응답에 드러나지 않는다. 필터를 빠뜨려도 응답이 항의하지 않아, 예전 브리핑이 조용히 틀렸다.
이 스킬은 서버 날짜 필터를 아예 쓰지 않으므로 이 함정에 걸리지 않는다.
남양주 32건: exact 21 · dong_fallback 6 · unlocated 5.
dong_fallback은 여러 공고가 같은 좌표를 갖는다. 왕숙 4건이 한 점에 겹친다.
→ 마커를 합치고 (같은 지점 N건)으로 표기한다. 따로 찍으면 서로를 가린다.unlocated는 반경 판정이 불가능하다. 지도에서 빼고 별도 회색 블록으로 분리,
"위치가 확인되지 않음"이라고 적는다. 반경 스코프면 "반경 확인 불가".| 공고 수 | 처리 |
|---|---|
| ≥ 20 | 도넛·타임라인 정상 |
| 5 ~ 19 | 구성 비율만. 추세 언급 금지 |
| < 5 | 표만. 도넛·타임라인 생략 |
| 쓰지 않는 말 | 대신 |
|---|---|
| 적재분 · REF_DB | 청약홈에 등록된 |
| 미측위 · unlocated | 위치가 확인되지 않음 |
| 특별공급 비중 | 특별공급 비율 |
| 상한제 | 분양가 상한제 적용 |
| 표본 부족 | 자료가 적어 참고용 |
1,615세대처럼 단위를 붙인다. 분양가는 7.09억처럼 억 단위로.| 블록 | 출처 |
|---|---|
| 최근 신규 · KPI · 도넛 · 타임라인 · 공고 목록 | 청약홈 |
| 지도 | 네이버 지도 · 청약홈 |
out/ipzitalk-presale-report/audit.json을 만들고 skillBaseDirectory, shellUsed, webUsed, generatedFiles를 기록한다.baseToolName, 입력 요약, resultCount, truncated, provenance, 조건부 호출 reason을 누적한다. 페이지네이션·좌표 보완·지도 호출도 실제 행 수에 포함한다.auditIncomplete:true로 남기고 완료 처리하지 않는다.audit.json에서 도구별 호출 횟수, Remote provenance, Skill base directory, shell/web 사용 여부, 생성 파일을 계산해 보고한다.templates/result.html의 비실행 ipzi-data JSON 블록을 채운다(스킬 폴더 내부, self-contained).
마크업·CSS·렌더 JS는 고정이다. 실행마다 바뀌는 것은 ipzi-data 블록 하나뿐.
result.json·audit.json은 내부 계약용 고정 이름으로 유지하고, 사용자 전달 HTML만 대상 기반 이름을 쓴다.<지역>_분양리포트, 주소·단지 반경 스코프는 resolver가 확정한 단지명 또는 정규화 주소로 <단지명>_인근_분양리포트를 만든다. 예: 송파구_분양리포트.html, 헬리오시티_인근_분양리포트.html. 대상값이 없으면 이름을 지어내지 말고 ipzitalk-presale-report.html로 폴백한다.out/ipzitalk-presale-report/<대상>_분양리포트.html이다.../../scripts/html_artifact_contract.mjs 검증기를 --file-name "<대상>_분양리포트"와 함께 사용한다. --skill-dir에는 이 스킬의 base directory, --data에는 완성한 JSON 파일, --output-root에는 작업공간의 out 디렉터리를 전달한다.shell-free 또는 셸 금지 환경에서는 File Read/Write로 templates/result.html을 직접 읽고 ipzi-data JSON 블록만 교체한다. 교체 전후의 fixed template region(고정 영역: 데이터 블록 앞 prefix와 뒤 suffix)이 원본과 같은지 비교한다.audit.json.generatedFiles에는 예시 이름이 아니라 실제 최종 파일명과 경로를 기록한다.섹션 순서(고정)
| 열 | 내용 |
|---|---|
| 공고명 | 굵게 + 신규 배지. 아랫줄에 작게 읍면동 · 공공/민간 · 상한제 |
| 공고일 | YYYY-MM-DD |
| 주택형 | units[].exclusive_area_sqm의 정수부만 중복 제거해 59·74·84㎡ |
| 최고 분양가 | 그 공고의 max_price_10k 최댓값을 억 단위로 |
| 공급세대 | total_supply |
| 입주 예정 | YYYY.MM |
| 원문 | detail_url을 공고문 링크로 |
detail_url을 반드시 건다. 우리가 가진 건 요약이고, 경쟁률·접수일정·평면은 원문에만 있다.
링크 없이 표만 주면 사용자가 다음 행동을 할 수 없다.target="_blank" rel="noopener noreferrer"..tbl-wrap{overflow-x:auto} + table{min-width:760px}.32건 중 10건을 적는다.| 상황 | 처리 |
|---|---|
| 최근 N개월 신규 0건 | 정상. "최근 신규 없음 + 마지막 공고일" 카드. 하단 대시보드는 그대로 |
| 전량 0건 | "청약홈에 등록된 공고가 없습니다". 리포트 생성 중단 |
| 지역 해소 실패 | 후보 나열 후 선택. raw 지역명 그대로 넣지 말 것 |
has_more: true | offset으로 이어 받는다 |
좌표 겹침(dong_fallback) | 마커 합치고 (같은 지점 N건) |
unlocated 존재 | 지도에서 빼고 별도 회색 블록 |
| 공고 < 5건 | 도넛·타임라인 생략. 표만 |
운영 MCP 실호출. search_announcement_info(sigungu="남양주시", include_units=true, limit=100) 1콜.
has_more: false다른 지역 대조
| 시군구 | 전량 | 최근 6개월 | 마지막 공고 |
|---|---|---|---|
| 남양주시 | 32 | 3 | 2026-05-13 |
| 김포시 | 18 | 2 | 2026-05-22 |
| 송파구 | 5 | 0 | 2025-08-19 |
스킬 폴더 밖 문서에 의존하지 않도록 규칙을 여기 인라인으로 둔다.
<symbol> 인라인 + <use> 참조로 self-contained.
(인라인 렌더 JS는 허용. 외부 스크립트만 금지.)prefers-color-scheme + :root[data-theme] 모두 대응.--g/--y/--o/--r/--x/--brand/--up/--down/--zebra (+ -s 배경 변형).null은 확인되지 않음(0 아님) · 공고 부족은 도넛 생략.★·☆는 활자 기호이며 이모지가 아니다.th.n·td.n 양쪽에 우측 정렬을 준다. th.n을 빠뜨리면 헤더만 좌측에 남는다..map{overflow-x:auto; overflow-y:hidden} + .map iframe{display:block; min-width:720px}.svg 규칙은 직계 자식으로 한정한다.
.box > svg{width:100%} /* 차트만 */
.box svg.ic{width:1.05em;height:1.05em} /* 가드 */
.box svg)로 쓰면 특이도가 .ic(0,1,0)보다 높아(0,1,1)
제목 옆 아이콘까지 카드 폭으로 부푼다. 그 아이콘이 flex 공간을 다 먹어 제목이 세로로 접힌다.
실제로 두 스킬에서 같은 버그가 났다. 새 카드 컨테이너를 만들 때마다 확인할 것.regional-presale-dashboard (지역 분양현황 대시보드) — 보류presale-briefing (분양 브리핑) — 보류합친 이유는 "결과가 같아서"가 아니다. 브리핑이 date_from을 제대로 걸면 송파구는 0건, 대시보드는 5건이다.
합친 진짜 이유는 ① 전량 1콜로 둘 다 만든다 ② 브리핑 단독은 대부분 지역에서 0건(빈 화면)
③ 사용자는 "최근 신규"와 "전체 물량"을 같이 보고 싶어한다.
ipzitalk-announcement-search(조건 검색·목록만)와는 여전히 별개다.
goal.purpose에 그대로 보존한다.4인가족 실거주 검토투자 심의 회의 자료분양 제안서용 자료건너뛰기기타(직접 입력)으로 자유 입력도 허용한다.건너뛰기를 기타(직접 입력)에 입력해도 된다고 알린다.원하는 분석 목적을 한 문장으로 알려주세요. (예: "4인가족 실거주 검토", "투자 심의 회의 자료", "분양 제안서용 자료") 건너뛰셔도 됩니다.
goal.purpose에 그대로 저장하고, 직접 입력을 고르면 사용자가 입력한 원문을 그대로 저장한다.건너뛰기를 고르거나 사용자가 건너뛰겠다고 답한 경우에만 goal:null로 두고 목적 섹션 없이 진행한다. 목적을 지어내지 않는다.purpose에는 사용자 문장을 그대로 보존한다.conclusions(결론)·evidence(근거)·cautions(주의사항)·nextActions(다음 행동 제안)를 작성한다. 조회 전에 문구나 결론을 미리 만들지 않는다.goal은 사용자 표현을 그대로 보존한 purpose, conclusions(3evidence(1cautions(0nextActions(1conclusions는 실제 조회·판정 결과만 목적에 맞춰 요약하고, 각 결론에 실제 evidence를 최소 1개 연결한다.evidence에는 이번 실행에서 확보한 필드·수치·비교 결과만 쓴다. 예시·검증값·모델 지식으로 빈 값을 채우지 않는다.YYYY.MM)을 연월 단위로 비교해 과거·당월·미래를 판정한다.입주 예정, 앞으로 입주, 입주 대기 물량으로 쓰지 않는다. 이미 입주 시점 경과 또는 확인된 사실만 쓴다.앞으로 입주할 신규 물량은 확인되지 않습니다처럼 금지 표현을 부정해 쓰지 말고, 반경 내 등록 공고 중 조회일 이후 입주월이 확인된 공고는 없습니다처럼 비교 기준과 확인 범위를 직접 쓴다.성숙 시장, 공급 소진이라고 단정하거나 추론하지 않는다. 확인된 반경·기간 안에 신규 등록 공고가 없다는 사실까지만 쓴다.cautions는 실제로 확인된 데이터 누락·표본 한계·시점 차이·방법상 제약만 쓴다. 본문 경고를 약화하거나 새 위험을 지어내지 않는다.nextActions는 실제 발견사항·누락·사용자 목적에서 이어지는 검토 행동만 제안한다. URL이나 원시 Skill ID 대신 한글 Skill 이름과 자연어 질의 예시를 쓰며, 단지 거래 후속 예시는 최근 실거래가 추이로 표현한다.goal:null이면 goal-box 전체를 숨긴다.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 연결 상태를 확인하도록 안내한 뒤 중단한다.