메뉴
시군구 여러 곳의 매매 거래량·중위 평당가·중위 거래가를 전월 대비로 비교해 지역 시장동향을 만든다. "최근 시장동향", "요즘 시장 어때", "거래 늘었어?", "어느 구가 오르나", "지역별 비교" 등의 표현이 있으면 이 스킬을 사용한다. 시군구 집계는 전용타입을 통일할 수 없어 구성 편향이 있으므로 "참고 신호"로만 제시한다.
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 연결 상태를 확인하도록 안내한 뒤 중단한다.