菜单
시군구 여러 곳의 매매 거래량·중위 평당가·중위 거래가를 전월 대비로 비교해 지역 시장동향을 만든다. "최근 시장동향", "요즘 시장 어때", "거래 늘었어?", "어느 구가 오르나", "지역별 비교" 등의 표현이 있으면 이 스킬을 사용한다. 시군구 집계는 전용타입을 통일할 수 없어 구성 편향이 있으므로 "참고 신호"로만 제시한다.
用 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)를 권한다.
주소·단지명·K-apt 코드 중 하나 또는 비교할 단지 2개 이상을 입력받아 K-apt 단지 기본/상세정보를 조회하고, 세대수·동수·사용승인일·시공사·주차·승강기·CCTV·지하철 도보분·면적 믹스를 단지 스펙 카드 또는 비교표로 정리한다. "단지 스펙", "단지 비교", "주차 몇 대", "몇 년식", "단지 정보", "K-apt 정보", "아파트 상세"를 물을 때 사용한다.
| name | ipzitalk-recent-market-trend |
| description | 시군구 여러 곳의 매매 거래량·중위 평당가·중위 거래가를 전월 대비로 비교해 지역 시장동향을 만든다. "최근 시장동향", "요즘 시장 어때", "거래 늘었어?", "어느 구가 오르나", "지역별 비교" 등의 표현이 있으면 이 스킬을 사용한다. 시군구 집계는 전용타입을 통일할 수 없어 구성 편향이 있으므로 "참고 신호"로만 제시한다. |
| version | 1.2.7 |
| license | proprietary |
tier: L2
시군구 N곳의 확정월 vs 전월 매매 지표를 비교한다. ※ 구성 미보정 참고 신호다. 전용타입·단지 구성 변화가 중위값에 그대로 반영된다. 시세 감정이 아니다.
| 파라미터 | 필수 | 기본 | 설명 |
|---|---|---|---|
regions | ✅ | - | 지역명 또는 region_code 배열. 최대 5곳 |
year_month | ✕ | 최신 확정월 | 기준월. 최근 2개월은 신고 지연으로 자동 제외 |
⚠️ 시군구 × 2개월 = 2크레딧. 5곳이면 10크레딧. 데모·기본값은 3곳 권장.
| 도구 | 용도 |
|---|---|
get_region_code | 지역명 → sigungu_code 5자리 |
get_complex_trades | region_code + year_month + trade_type='sale' + limit=1 |
💡
limit=1로 부른다.summary는 전체 필터 결과 기준으로 계산되므로 items를 안 받아도 거래량·중위값이 정확하다. 응답 크기를 100배 줄인다.
get_region_code로 sigungu_code 확보.get_complex_trades(..., limit=1).metadata.coverage.complete, missing_months, provisional_months, reason_code를 먼저 확인한다. 미확인·잠정 월을 거래 0건으로 바꾸지 않는다.--up(빨강) / 하락 --down(파랑) — 국내 관행. ±1% 미만은 flat(회색)로 중립 표기.metadata.truncated는 items 상한 때문에 항상 true다. summary는 영향받지 않는다 — 이 구분을 리포트에 명시한다(화면에는 "중위값·거래량은 전체 거래 기준"으로만).{n:"표시값"} 형식을 사용한다.평당가와 거래가가 반대 방향이면 거래 구성(면적·단지 비중) 변화일 수 있다. 이 사실은 두 곳에만 낸다.
| 위치 | 내용 |
|---|---|
| KPI 카드 칩 | 구성 변화 가능성 (템플릿이 자동 부착) |
푸터 hedges | 실제 수치와 함께 한 줄. 예: "중위 평당가(−9.5%)와 중위 거래가(+2.6%)가 서로 반대로 움직였다 — 시장 방향이 아니라 거래 구성 변화일 수 있다." |
templates/result.html. 마크업·CSS·렌더 JS는 고정이고 실행마다 바뀌는 것은 비실행 ipzi-data JSON 블록 하나뿐이다.out/ipzitalk-recent-market-trend/result.json과 out/ipzitalk-recent-market-trend/audit.json은 내부 계약용 고정 이름으로 먼저 만든다._로 잇고 기준월을 YYYY-MM으로 바꿔 <지역묶음>_시장동향_<기준월>을 만든다. 예: 강남구_송파구_서초구_시장동향_2026-05.html. 지역명을 확보하지 못하면 이름을 지어내지 말고 ipzitalk-recent-market-trend.html로 폴백한다.out/ipzitalk-recent-market-trend/<지역묶음>_시장동향_<기준월>.html이다.../../scripts/html_artifact_contract.mjs를 --file-name "<지역묶음>_시장동향_<기준월>"과 함께 사용해 렌더·검증한다. shell-free 또는 셸 금지 환경에서는 같은 파일명으로 ipzi-data 블록만 교체하고 fixed template region을 비교한다.audit.json 최상위에는 skillBaseDirectory, 입력 요약, calls, auditIncomplete, shellUsed, webUsed, generatedFiles를 둔다.calls에 한 행을 추가한다. 행 필드는 sequence, baseToolName, region, regionCode, yearMonth, tradeType, limit, resultCount, sampleCount, truncated, reasonCode, coverageComplete, missingMonths, provisionalMonths, provenance다. 해당하지 않는 값은 null로 두고 필드를 생략하지 않는다.get_complex_trades는 지역 N곳마다 기준월·비교월을 조회하므로 정확히 2N회다. 지역명이어서 코드 해소가 필요한 곳의 수를 R이라 하면 get_region_code는 R회이고 정상 총 호출 수는 2N + R회다. 입력이 이미 region_code면 해당 지역의 해소 호출은 0회다.calls에서 자동 계산한다. 수기 집계나 별도 실행 기록을 감사 원장보다 우선하지 않는다.auditIncomplete:true로 남기고 재조회하지 않는다.audit.json의 calls에서 도구별 호출 횟수·Remote provenance·Skill base directory·shell/web 사용 여부·생성 파일을 계산한다.audit.json.generatedFiles에는 예시 이름이 아니라 실제 최종 파일명과 경로를 기록한다.| 상황 | 처리 |
|---|---|
성공 + NO_TRADES_FOR_REQUESTED_SCOPE + coverage.complete=true | 정상적으로 확인된 거래 0건. 해당 행만 "거래 없음" 표기 |
PARTIAL_COVERAGE 또는 coverage.complete=false | "조회 불완전"과 미확인 월 표기. 거래 0건·전월 대비 변동률로 렌더하지 않음 |
coverage.provisional_months에 대상월 포함 | 잠정 집계로 표시. 확정 거래량·변동률로 단정하지 않음 |
도구 오류 NOT_FOUND | 조회 실패로 표시. 거래 0건과 구분하고 나머지 지역만 정상 렌더 |
| 거래량 < 30건인 시군구 | 변동률 신뢰 낮음 → "참고" 꼬리표 |
| 평당가·거래가 방향 불일치 | 구성 변화 경고 강제 표기 |
| 지역 해소 실패 | 후보 나열 후 선택 |
검증된 사항은 런타임 fallback 또는 실행값 대체에 사용하지 않는다.
운영 MCP 실호출. trade_type='sale', limit=1, 기준월 2026.05 / 비교월 2026.04.
| 시군구 | 거래량 04→05 | Δ | 중위 평당가 04→05 | Δ | 중위 거래가 04→05 | Δ |
|---|---|---|---|---|---|---|
| 서초 11650 | 301 → 350 | +16.3% | 9,382 → 9,664 | +3.0% | 255,000 → 265,000 | +3.9% |
| 강남 11680 | 397 → 433 | +9.1% | 11,920 → 11,966 | +0.4% | 267,000 → 270,000 | +1.1% |
| 송파 11710 | 600 → 582 | −3.0% | 9,269 → 8,393 | −9.5% | 199,500 → 204,750 | +2.6% |
total_count 49 vs 2026.05 350건.limit=1로도 summary.sample_count가 전체(301/350/…)로 나오는 것을 확인 → items 없이 요약만 받는 전략 유효.truncated:true(items 상한). summary는 정확.데이터 블록 하단에 .src 한 줄. 도구·API 이름은 쓰지 않는다. 사용자가 아는 기관명만.
| 블록 | 출처 표기 |
|---|---|
| 단지 개요·세대수·준공·주차·연차 | 공동주택관리정보시스템(K-apt) |
| 매매·전세·평당가·거래량 | 국토교통부 실거래가 |
| 학교·교통·생활·상권 등 장소 | 카카오맵 |
| 분양공고·분양가·주택형·입주월 | 청약홈 |
| 지도 (장소 마커) | 네이버 지도 · 카카오맵 |
| 지도 (분양공고 마커) | 네이버 지도 · 청약홈 |
ipzi-data로 받지 않고 템플릿 마크업에 직접 박는다.
어느 블록이 어디서 왔는지는 실행마다 달라지지 않는다. 데이터로 받으면 채우는 걸 잊거나 틀리게 쓸 여지만 생긴다.세대수·주차 — 공동주택관리정보시스템(K-apt) · 위치 — 카카오맵.
하나로 뭉뚱그리면 어느 숫자가 어디서 왔는지 사용자가 알 수 없다.스킬 폴더 밖 문서에 의존하지 않도록 규칙을 여기 인라인으로 둔다.
<symbol> 인라인 + <use> 참조로 self-contained.prefers-color-scheme + :root[data-theme] 모두 대응.--g/--y/--o/--r/--x/--brand/--up/--down/--zebra (+ -s 배경 변형).null은 "정보없음"(0 아님) · 표본 부족은 판정 유보 · 목록 상한 도달은 "목록 불완전" 표기.★·☆는 활자 기호이며 이모지가 아니다. 등급 표기에 사용 가능.goal.purpose에 그대로 보존한다.4인가족 실거주 검토투자 심의 회의 자료분양 제안서용 자료건너뛰기기타(직접 입력)으로 자유 입력도 허용한다.건너뛰기를 기타(직접 입력)에 입력해도 된다고 알린다.원하는 분석 목적을 한 문장으로 알려주세요. (예: "4인가족 실거주 검토", "투자 심의 회의 자료", "분양 제안서용 자료") 건너뛰셔도 됩니다.
goal.purpose에 그대로 저장하고, 직접 입력을 고르면 사용자가 입력한 원문을 그대로 저장한다.건너뛰기를 고르거나 사용자가 건너뛰겠다고 답한 경우에만 goal:null로 두고 목적 섹션 없이 진행한다. 목적을 지어내지 않는다.purpose에는 사용자 문장을 그대로 보존한다.conclusions(결론)·evidence(근거)·cautions(주의사항)·nextActions(다음 행동 제안)를 작성한다. 조회 전에 문구나 결론을 미리 만들지 않는다.goal은 사용자 표현을 그대로 보존한 purpose, conclusions(3evidence(1cautions(0nextActions(1conclusions는 실제 조회·판정 결과만 목적에 맞춰 요약하고, 각 결론에 실제 evidence를 최소 1개 연결한다.evidence에는 이번 실행에서 확보한 필드·수치·비교 결과만 쓴다. 예시·검증값·모델 지식으로 빈 값을 채우지 않는다.cautions는 실제로 확인된 데이터 누락·표본 한계·시점 차이·방법상 제약만 쓴다. 본문 경고를 약화하거나 새 위험을 지어내지 않는다.nextActions는 실제 발견사항·누락·사용자 목적에서 이어지는 검토 행동만 제안한다. URL이나 원시 Skill ID 대신 한글 Skill 이름과 자연어 질의 예시를 쓴다.goal:null이면 goal-box 전체를 숨긴다.resultCount·sampleCount·truncated와 지표 값을 null로 기록한다. 예시·검증값으로 대체하지 않는다.auditIncomplete:true이면 정상 완료를 주장하지 않는다. 해당 셀을 "확인되지 않음"으로 표시하고 부분 완료 또는 실패로 보고한다.| 버전 | 날짜 | 내용 |
|---|---|---|
| 1.2.7 | 2026-07-20 | 지역·월별 커버리지와 잠정월을 확인해 부분 조회를 거래 0건으로 오인하지 않도록 하고 감사 필드 확장 |
| 1.2.6 | 2026-07-15 | 정규화 지역 묶음과 기준월 기반 시장동향 HTML 파일명을 동적화하고 내부 JSON·감사 파일 고정 이름 유지 |
| 1.2.5 | 2026-07-15 | 단지·전용타입 후속 분석의 사용자 노출 명칭을 시세 추이 분석에서 실거래 추이 분석으로 통일 |
| 1.2.4 | 2026-07-15 | 팝업 지원 환경의 4개 목적 프리셋+직접 입력과 텍스트 대체 질문을 함께 지원하는 하이브리드 목적 입력 계약 추가 |
| 1.2.3 | 2026-07-15 | 상세 표의 첫 열 이후 헤더와 숫자 값을 같은 오른쪽 정렬로 맞춰 열 밀림 개선 |
| 1.2.2 | 2026-07-15 | 목적 질문 대기·실데이터 후속 추론 계약과 검증값 런타임 대체 금지, 불완전 감사의 정상 완료 금지 규칙 추가 |
| 1.2.1 | 2026-07-14 | 지역·월·호출 인자를 보존하는 호출별 calls 감사 원장과 2N + R 호출식 추가 |
| 1.2.0 | 2026-07-14 | main 승격. 비실행 JSON·고유 출력·공통 audit 계약과 목적 맞춤 요약 내러티브 레일 추가 |
| 1.1.0 | 2026-07-14 | 목적 맞춤 요약 goal 스키마 추가 |
| 1.0.0 | 2026-07-09 | 패키지 확정. 데모를 templates/result.html 템플릿(고정 마크업 + ipzi-data JSON 렌더)으로 이식. 차트를 regions 데이터에서 그리도록 전환 |
| 0.1 | 2026-07-09 | 서초·강남·송파 실데이터로 신규 작성. limit=1 요약 전략 확립 · 송파 평당가/거래가 모순 실증 · 최근월 지연(49건) 직접 확인 · 구성 미보정 경고 규칙 · 등급 미부여 원칙 · 정본 토큰/아이콘 적용 |
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 연결 상태를 확인하도록 안내한 뒤 중단한다.