菜单
주소 또는 단지명을 입력받아 교통·생활·교육 환경을 한 번에 분석해 세부 입지 보고서(통합 HTML 리포트 + 종합 지도)를 생성한다. "세부 입지", "입지 분석", "입지 보고서", "이 사업지 입지 어때", "입지 종합", "주변 환경 종합" 등의 표현이 있으면 이 스킬을 사용한다. 단일 분야만 물으면(교통만/학군만) 해당 단일 스킬을 쓴다. 점수화는 입지 평가 스킬로 분리한다.
用 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-location-report |
| description | 주소 또는 단지명을 입력받아 교통·생활·교육 환경을 한 번에 분석해 세부 입지 보고서(통합 HTML 리포트 + 종합 지도)를 생성한다. "세부 입지", "입지 분석", "입지 보고서", "이 사업지 입지 어때", "입지 종합", "주변 환경 종합" 등의 표현이 있으면 이 스킬을 사용한다. 단일 분야만 물으면(교통만/학군만) 해당 단일 스킬을 쓴다. 점수화는 입지 평가 스킬로 분리한다. |
| version | 1.3.5 |
| license | proprietary |
tier: L2
주소/단지명 하나로 교통 + 생활 + 교육을 종합해 대표 보고용 리포트를 만든다.
※ 각 분야의 직선거리·개수 근사와 hedge를 그대로 승계한다. 정성 판단·우열 단정 금지.
※ 점수를 매기지 않는다. 종합 점수화는 location-score(입지 평가) 담당.
이 스킬의 모든 데이터 조회는 입지톡(ipzitalk) Remote MCP 서버(https://ipzi-talk.synergylabs.kr/mcp)의 도구로만 한다.
아래 문서에서 get_address·search_by_nearby_category·search_by_nearby_keyword·get_map_embed_url 처럼 접두사 없이 적힌 이름은 전부 이 서버의 도구를 가리킨다.
ipzitalk-remote 플러그인의 ipzitalk 서버 provenance가 확인되는 도구만 우선 사용한다. Codex에서는 실제 호출 이벤트의 server: ipzitalk과 기본 도구명을 기준으로 확인한다.presale-mcp 또는 다른 로컬 MCP provenance의 동명 도구는 Remote Skill의 대체 수단으로 사용하지 않는다. provenance를 확인할 수 없거나 같은 기본 도구명이 여러 서버에 있어 모호하면 임의 선택하지 말고 중단하여 필요한 Remote 도구명을 안내한다.mcp__plugin_ipzitalk-remote_ipzitalk__<도구명>, mcp__ipzitalk_mcp__<도구명>, mcp__ipzitalk__<도구명>, mcp__claude_ai_ipzitalk__<도구명>. fallback으로도 Remote 출처가 유일하지 않으면 중단한다.| 파라미터 | 필수 | 기본 | 설명 |
|---|---|---|---|
address 또는 complex_query | ✅(택1) | - | 주소 또는 단지명 |
radius_m | ✕ | 1500 | 근린 축 검색·사용자 표시·통합 지도 원의 공통 반경. 최대 5,000m. 광역 축(철도·터미널·대학)에는 미적용 |
후보 다수면 자동 확정 말고 선택받는다. ⚠️ 3개 분야 종합 = 검색 다수 → 크레딧·시간 소요 큼.
스킬 간 호출은 불가하다. 하위 스킬을 부르지 않고, 스킬 폴더 안 references/의 복사본을 읽어 각 단계를 이 실행 안에서 수행한다.
references/transit-workflow.md 교통 환경
references/living-workflow.md 생활 환경
references/education-workflow.md 교육 환경
complex_query)은 get_complex_info(detail=true)를 먼저 1회 호출한다. 좌표가 없으면 그 응답의 공식 도로명 또는 지번 주소로 get_geocode를 한 번만 호출한다. 단지 해소가 성공한 뒤 get_address를 호출하거나 모델하우스 검색을 반복하는 것은 금지한다.resolve-site 규약의 주소 resolver를 1회 사용한다. 좌표를 반환하면 보강용 get_geocode를 호출하지 않고 없는 보조 필드는 null로 둔다.references/transit-workflow.md를 읽어 검색·밴드·등급 단계를 center로 실행.references/living-workflow.md를 읽어 실행.references/education-workflow.md를 읽어 실행.radius_m과 같은 반경 원 + 3분야 대표 마커. 아래 지도 규칙 준수.result.json 및 호출 ledger out/ipzitalk-location-report/audit.json 저장 → 출력 형식(html/pptx/docx) 1개 필수 선택 후 렌더. 아래 출력 포맷 참조. 모든 정본 산출물과 과정 문서는 out/ipzitalk-location-report/ 안에만 저장하고 작업 루트에 중복 파일을 만들지 않는다.reason allowlist로 구분한다.out/ipzitalk-location-report/audit.json에 skillBaseDirectory, axis, baseToolName, query 또는 category, radius_m, resultCount, truncated, provenance와 함께 한 행씩 누적한다. 조건부 재호출은 reason도 기록하고, 파일 도구·실행 환경은 shellUsed, webUsed, generatedFiles로 별도 기록한다.audit.json 행에서 자동 집계한다. 중간 자연어 메모를 더해 수기로 합계를 만들지 않는다.auditIncomplete:true로 남긴 뒤 재조회하지 않는다.audit.json의 총 호출 수를 16 + center 해소 호출 수 + 허용된 0건 fallback 수와 비교한다. center 체인은 complex_info·official_address_geocode처럼 각 단계와 사유를 기록하고, 그 밖의 초과 행에 allowlist reason이 없으면 완료 처리하지 않는다.radius_m은 근린 검색·통합 지도 원·지도 캡션에서 같은 의미와 값을 사용한다. 광역 축은 radius_m: null로 ledger에 구분한다.0건으로 표현하지 않는다.audit.json의 selection에 남긴다. 고정 fixture는 값 자체가 아니라 center·검색 인자·필터·정렬의 재현성을 검증한다.audit.json에서 도구별 호출 횟수, Remote provenance, Skill base directory, shell/web 사용 여부, 생성 파일을 계산해 보고한다.axes[].stars / axes[].tone / sections[].tone / sections[].gradeLabel 은 아래 표대로만 쓴다.
| 등급 | stars | tone | gradeLabel |
|---|---|---|---|
| 우수 | 3 | g | ★★★ 우수 |
| 양호 | 2 | y | ★★☆ 양호 |
| 미흡 | 1 | o | ★☆☆ 미흡 |
| 판정 유보(표본·데이터 부족) | null | x | 판정 유보 |
r(red)는 등급에 쓰지 않는다. pills[].tone 도 같은 토큰을 쓴다(강점 pill = g).보통: 지하철·상권·공원·공공기관 밴드는 4단계(우수/양호/보통/미흡)다. 여기서의 보통은 축 등급으로 접을 때 y(양호)가 아니라 하위 기여다(대부분 보통~미흡 → ★☆☆). 축 등급 라벨에는 보통을 쓰지 않는다 — 위 표의 4개만 쓴다. 3단계 밴드(중·고, 철도, 터미널)의 가운데는 양호다.truncated, 데이터 부족, 확인 필요 같은 문구는 포인트 컬러·굵은 글씨로 강조하지 말고 회색 각주로 작게, 블록 구석에 단다. 사고가 난 게 아니라 데이터 한계일 뿐이다.references/*-workflow.md 의 밴드 기준을 따른다. 여기서 새로 만들지 않는다.#6B7280.#16a34a · 교육(초등) #f59e0b · 교육(중·고) #ea580c · SITE #2563eb| 노선 | 색 | 노선 | 색 |
|---|---|---|---|
| 1호선 | #0052A4 | 신분당선 | #D4003B |
| 2호선 | #00A84D | 수인분당선 | #FABE00 |
| 3호선 | #EF7C1C | 경의중앙선 | #77C4A3 |
| 4호선 | #00A5DE | 공항철도 | #0090D2 |
| 5호선 | #996CAC | 경춘선 | #0C8E72 |
| 6호선 | #CD7C2F | 우이신설선 | #B7C452 |
| 7호선 | #747F00 | 신림선 | #6789CA |
| 8호선 | #E6186C | 김포골드라인 | #A17E46 |
| 9호선 | #BB8336 | 서해선 | #81A914 |
| 인천1호선 | #7CA8D5 | 인천2호선 | #ED8B00 |
| 의정부경전철 | #FDA600 | 용인에버라인 | #56AD2D |
| 부산1호선 | #F06A00 | 부산2호선 | #81BF48 |
| 부산3호선 | #BB8C00 | 부산4호선 | #217DCB |
| 대구1호선 | #D93F5C | 대구2호선 | #00AA80 |
| 대구3호선 | #FFB100 | 대전1호선 | #007448 |
| 광주1호선 | #009088 | 그 외 | #6B7280 |
fitBounds가 반경 원을 무시해 원이 잘리는 걸 막으려고
정북·남·동·서에 회색 더미 마커 4개를 심었다. 사용자에게는 정체를 알 수 없는 점으로 보여 혼란만 준다.
원이 잘리더라도 마커는 실제 장소만 찍는다. (근본 해결은 render.ts가 원을 bounds에 포함하도록 고치는 것 — 발견사항 6번)center + radius_m 항상 함께, 마커 2개 이상..map{overflow-x:auto; overflow-y:hidden} + .map iframe{display:block; min-width:720px}.
overflow:hidden만 주면 iframe이 카드 폭에 짓눌려 지도가 최소 줌(한반도)으로 떨어진다.map_payloads TTL). 산출물 지도 캡션에 유효기간과 재발급 필요를 반드시 적는다.
만료 시 iframe이 빈 화면이 되는데, 원인 표기가 없으면 리포트가 고장난 것처럼 보인다.result.json (항상 만든다)분석이 끝나면 먼저 result.json 하나를 저장한다. 모든 렌더러의 유일한 입력이다.
templates/result.html 의 templateDataShape 객체와 동일한 필드(그게 곧 JSON 스키마다) + disclaimer.
필드: brand · title · subtitle · pills[] · map{url,caption,ttlNote} · summary · axes[] · sections[] · wide · manual[] · hedges[] · sources[] · collectedAt · disclaimer
각 필드의 의미·허용값은 템플릿 templateDataShape의 주석이 정본이다(값 없으면 null, 절대 0·추정값으로 채우지 않는다).disclaimer 값(고정):
입지톡 베타 결과물입니다. 공식 데이터에 없는 값은 임의로 채우지 않지만, 신고·갱신 지연이나 조회 실패, 단지명 매칭 문제, 검색 건수 제한으로 일부 정보가 누락될 수 있습니다. 기준년월과 공식 원문을 확인해 주세요.result.json 저장 직후, 사용자가 형식을 미리 지정하지 않았다면 반드시 묻고 답을 기다린다.
어떤 형식으로 만들어 드릴까요? (1) HTML (2) PPTX (3) DOCX — 하나를 선택해 주세요.
선택된 1개만 렌더한다. 요청 없이 여러 형식을 만들지 않는다. 세 렌더러 모두 result.json만 읽고 레이아웃은 고정이다(데이터만 통째로 갈아끼운다).
| 선택 | 절차 | 산출 |
|---|---|---|
| (1) HTML | templates/result.html 복사 → 비실행 ipzi-data JSON 블록을 result.json 내용으로 통째 치환. 마크업·CSS·렌더 JS는 손대지 않는다 | <대상>_입지보고서.html (동적 지도 iframe) |
| (2) PPTX | python3 templates/build_pptx.py result.json <대상>_입지보고서.pptx (pip install python-pptx) | <대상>_입지보고서.pptx — HTML 리포트와 같은 다크 스타일(동일 토큰). 표지 → 종합요약(좌: 지도 / 우: 요약·축 카드 2분할) → 섹션별 표(등급 pill·밴드·회색 각주) → 광역축 → 유의사항. 표는 한 장에 8행까지 |
| (3) DOCX | python3 templates/build_docx.py result.json <대상>_입지보고서.docx (pip install python-docx) | <대상>_입지보고서.docx — 상단에 지도 이미지 + 동적 지도 링크 |
result.json·audit.json은 모든 렌더러가 공유하는 내부 계약용 고정 이름으로 유지한다. 사용자 전달 HTML·PPTX·DOCX만 같은 <대상>_입지보고서 basename을 쓴다.<대상>은 resolver가 확정한 공식 단지명이다. 주소 입력에서 공식 단지명이 없으면 정규화 주소를 사용하며, 둘 다 없으면 이름을 지어내지 말고 ipzitalk-location-report로 폴백한다.out/ipzitalk-location-report/<대상>_입지보고서.html에 저장한다. 셸 사용이 허용된 환경에서는 스킬 기준 ../../scripts/html_artifact_contract.mjs 검증기를 --file-name "<대상>_입지보고서"와 함께 사용한다. --skill-dir에는 이 스킬의 base directory, --data에는 result.json, --output-root에는 작업공간의 out 디렉터리를 전달한다.shell-free 또는 셸 금지 환경에서는 File Read/Write로 templates/result.html을 직접 읽고 ipzi-data JSON 블록만 교체한다. 교체 전후의 fixed template region(고정 영역: 데이터 블록 앞 prefix와 뒤 suffix)이 원본과 같은지 비교한다.audit.json.generatedFiles에는 실제 최종 파일명과 경로를 추가하고 과정 문서도 갱신한다.PPTX·DOCX에는 iframe을 넣을 수 없으므로 지도 이미지 파일이 필요하다. templates/mapshot.py 가 map.url(= get_map_embed_url 결과) 페이지를 설치된 Chrome 헤드리스로 캡처한다. 반경 원·마커 라벨이 그대로 들어온다. 두 렌더러가 알아서 호출하므로 스킬이 따로 할 일은 result.json 의 map.url 을 채우는 것뿐이다.
지도 이미지를 이미 로컬에 갖고 있으면 3번째 인자로 넘긴다: build_pptx.py result.json out.pptx map.png
Chrome이 없거나 캡처가 실패하면 지도 없이 렌더하고 경고만 남긴다. 리포트는 멈추지 않는다.
get_static_map 도구는 이미지를 대화창에만 반환하고 파일로 저장되지 않는다. 산출물 렌더링에 쓰지 않는다.
지도 링크는 발급 후 7일 만료다. 만료 뒤에는 캡처도 빈 화면이 되므로 재발급이 필요하다.
HTML 리포트 구성: 상단 pill(트리플 역세권 등) → 종합 지도 히어로 → 종합 요약 + 축 카드 3개 → 교통/생활/교육 3섹션(밴드 + 근거 표) → 수기 편집 영역 → 출처·hedge·베타고지 푸터.
디자인 규칙(스킬 폴더 밖 문서에 의존하지 않도록 여기 인라인):
<symbol> 인라인 + <use> 참조로 self-contained.prefers-color-scheme + :root[data-theme] 모두 대응.--g/--y/--o/--r/--x/--brand/--up/--down/--zebra (+ -s 배경 변형).★·☆는 활자 기호이며 이모지가 아니다. 등급 표기에 사용 가능.| 상황 | 처리 |
|---|---|
지오코딩 실패 / NOT_FOUND | 재입력 요청 |
후보 다수 / AMBIGUOUS | 후보(지역 포함) 나열 후 선택 |
| 특정 분야 전 축 0건 | 해당 섹션 "없음/원거리" 명시. 나머지 분야는 정상 렌더 |
metadata.truncated = true | "목록 불완전" 경고 표기(등급은 유지 — 최근접은 정확) |
| 지하철 0건 | 교통 등급을 철도·터미널로 대체 판정(transit-workflow 참조) |
A그룹 단독 스킬 3종의 검증값을 재사용해 조립했다. 신규 POI 호출 0건, 지도 1콜(1크레딧).
| 축 | 등급 | 근거 |
|---|---|---|
| 교통 | ★★★ 우수 | 지하철 279m · 터미널 2.8km · 철도 5.4km(도심 입지 보정) · 트리플 역세권{7,4,2} |
| 생활 | ★★☆ 양호 | 공원 137m · 도서관 425m · 주민센터 428m · SSM 320m · 백화점 0건 |
| 교육 | ★★☆ 양호 | 초등 425m(동작구·배정주의) · 중 613m · 고 702m · 대학 3곳 · 학원 59곳 |
references/ 복사본 3종을 읽어 실행하는 방식이 동작함을 확인. 마스터 갱신(2026-07-09) 후 9개 사본 재배포 완료.데이터 블록 하단에 .src 한 줄. 도구·API 이름은 쓰지 않는다. 사용자가 아는 기관명만.
| 블록 | 출처 표기 |
|---|---|
| 단지 개요·세대수·준공·주차·연차 | 공동주택관리정보시스템(K-apt) |
| 매매·전세·평당가·거래량 | 국토교통부 실거래가 |
| 학교·교통·생활·상권 등 장소 | 카카오맵 |
| 분양공고·분양가·주택형·입주월 | 청약홈 |
| 지도 (장소 마커) | 네이버 지도 · 카카오맵 |
| 지도 (분양공고 마커) | 네이버 지도 · 청약홈 |
ipzi-data로 받지 않고 템플릿 마크업에 직접 박는다.
어느 블록이 어디서 왔는지는 실행마다 달라지지 않는다. 데이터로 받으면 채우는 걸 잊거나 틀리게 쓸 여지만 생긴다.세대수·주차 — 공동주택관리정보시스템(K-apt) · 위치 — 카카오맵.
하나로 뭉뚱그리면 어느 숫자가 어디서 왔는지 사용자가 알 수 없다.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 전체를 숨긴다.