@nomadamas/k-skill 0.1.0

package/skills/gangnamunni-clinic-search/instruction.md

@@ -0,0 +1,113 @@
+# Gangnam Unni Clinic Search
+
+## What this skill does
+
+강남언니(Gangnam Unni) 웹 검색 페이지의 **비로그인 공개 Next.js payload**를 읽어 병원 후보를 조회한다.
+
+- 키워드로 병원 후보를 검색한다.
+- 공개 검색 결과에 포함된 평점, 평점 수, 리뷰 수, 지원 언어, 공개 이미지, 병원 링크를 정리한다.
+- 예약, 상담, 결제, 리뷰 작성, 앱 로그인 등 사용자 계정이 필요한 액션은 하지 않는다.
+
+## When to use
+
+- "강남언니에서 강남 성형외과 찾아줘"
+- "강남언니 병원 평점이랑 리뷰 수 봐줘"
+- "코성형 병원 후보를 강남언니 기준으로 몇 개만 보여줘"
+- "성형외과/피부과 병원 공개 링크를 찾아줘"
+
+## When not to use
+
+- 상담 신청, 예약, 결제, 병원 채팅, 찜 같은 계정 기반 액션이 필요한 경우
+- 로그인 사용자에게만 보이는 이벤트, 가격, 개인화 추천을 확정해야 하는 경우
+- 의료적 판단, 시술 적합성, 안전성 보증을 대신해야 하는 경우
+
+## Prerequisites
+
+- 인터넷 연결
+- Node.js 18+
+- 이 저장소의 `gangnamunni-clinic-search` package 또는 동일 로직
+
+## Required inputs
+
+### 1. Ask for a search keyword if it is missing
+
+검색어가 없으면 먼저 확인한다.
+
+- 권장 질문: `강남언니에서 찾을 병원/시술/지역 키워드를 알려주세요. 예: 강남 성형외과, 코성형, 피부과`
+- 너무 넓으면: `검색어가 넓어요. 지역이나 시술명을 같이 주시면 후보를 더 좁힐 수 있어요.`
+
+### 2. Keep the answer conservative
+
+강남언니 공개 페이지 기준으로 확인한 후보임을 분명히 말한다. 병원 선택, 의료 조언, 수술 권유처럼 해석될 수 있는 표현은 피한다.
+
+## Public Gangnam Unni surface
+
+- search list: `https://www.gangnamunni.com/search?q=<keyword>`
+- parsed payload: `<script id="__NEXT_DATA__" type="application/json">...props.pageProps.hospitals...</script>`
+- public hospital URL: `https://www.gangnamunni.com/hospitals/<id>`
+
+Discovery result: `curl`/Node fetch로 비로그인 검색 HTML이 200으로 응답하고, 병원 후보는 server-rendered `__NEXT_DATA__`의 `props.pageProps.hospitals` 배열에 포함된다. 이 경로는 공개 read-only endpoint이므로 `k-skill-proxy`를 사용하지 않는다.
+
+## Workflow
+
+### 1. Search by keyword
+
+```js
+const { searchClinics } = require("gangnamunni-clinic-search")
+
+const result = await searchClinics({ query: "강남 성형외과", limit: 5 })
+console.log(result.items)
+```
+
+CLI:
+
+```bash
+npx gangnamunni-clinic-search "강남 성형외과" --limit 5
+```
+
+### 2. Interpret returned fields
+
+우선 아래 필드를 본다.
+
+- `name`: 병원명
+- `rating`, `ratingCount`, `reviewCount`: 공개 검색 페이지에 포함된 평점/리뷰 지표
+- `languages`: 공개 지원 언어
+- `url`: 강남언니 공개 병원 페이지
+- `profileImage`, `mainImage`: 공개 이미지 URL
+
+### 3. Fallback order
+
+1. 기본: `https://www.gangnamunni.com/search?q=<keyword>`의 `__NEXT_DATA__` payload를 파싱한다.
+2. payload가 없으면 로그인벽, CAPTCHA, 차단, 빈 shell 페이지를 실패 모드로 분류한다.
+3. 검색 결과가 너무 적거나 앱 전용 정보가 필요하면 자동화를 멈추고 사용자가 공식 앱/웹에서 직접 확인하도록 안내한다.
+
+### 4. Respond safely
+
+응답은 짧고 보수적으로 정리한다.
+
+- 병원명
+- 공개 평점/리뷰 수
+- 지원 언어
+- 강남언니 공개 링크
+- `조회 시점 공개 검색 결과 기준이며, 의료 판단이나 실제 예약 가능 여부는 병원/공식 앱에서 확인해야 합니다.` 라고 명시한다.
+
+## Done when
+
+- 검색 키워드를 확인했다.
+- 공개 검색 결과에서 병원 후보를 반환했거나, 실패 모드를 명확히 설명했다.
+- 계정 기반 액션과 의료 판단은 하지 않았다.
+
+## Failure modes
+
+- 검색어가 너무 넓거나 강남언니가 병원 후보를 공개 payload에 일부만 넣을 수 있다.
+- 강남언니 웹 구조가 바뀌면 `__NEXT_DATA__` 경로가 깨질 수 있다.
+- 로그인 필요, CAPTCHA, 접근 차단, 빈 HTML shell은 자동 우회하지 않고 실패로 보고한다.
+- 평점, 리뷰 수, 노출 순서는 시점에 따라 달라진다.
+- 앱 전용/로그인 전용 정보는 비로그인 공개 조회만으로 확정할 수 없다.
+
+## Notes
+
+- 조회형 스킬이다.
+- 비로그인 공개 표면 우선 원칙을 유지한다.
+- 프록시와 API key는 사용하지 않는다.
+- 의료 조언이나 병원 추천 보증이 아니라 공개 후보 정리로만 답한다.

package/skills/gangnamunni-clinic-search/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "gangnamunni-clinic-search",
+  "description": "강남언니 공개 검색 페이지에서 성형외과·피부과 병원 후보, 평점, 리뷰 수, 지원 언어, 공개 병원 링크를 조회한다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
+  "profiles": [
+    "proxy",
+    "action:booking"
+  ],
+  "frontmatter": "name: gangnamunni-clinic-search\ndescription: 강남언니 공개 검색 페이지에서 성형외과·피부과 병원 후보, 평점, 리뷰 수, 지원 언어, 공개 병원 링크를 조회한다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: beauty\n  locale: ko-KR\n  phase: v1"
+}

package/skills/geeknews-search/instruction.md

@@ -0,0 +1,69 @@
+# GeekNews Search
+
+## What this skill does
+
+GeekNews 공개 RSS/Atom 피드(`https://feeds.feedburner.com/geeknews-feed`)를 사용해 최신 글을 읽기 전용으로 조회한다.
+
+- 최신 글 목록 조회
+- 제목/요약/작성자 기준 검색
+- 항목 id/link 기준 상세 확인
+
+## When to use
+
+- "긱뉴스 오늘 뭐 올라왔어?"
+- "긱뉴스에서 Claude 관련 글 찾아줘"
+- "이 GeekNews 글 요약/링크 확인해줘"
+
+## Inputs
+
+- 기본: 별도 인증 없이 public feed만 사용
+- 목록 조회: `limit`
+- 검색: `query`, 선택 `limit`
+- 상세 조회: `id` 또는 링크/토픽 번호 일부
+
+## Official surface
+
+- GeekNews RSS/Atom feed: `https://feeds.feedburner.com/geeknews-feed`
+- GeekNews home: `https://news.hada.io`
+
+## Workflow
+
+### 1) List recent entries
+
+```bash
+python3 scripts/geeknews_search.py list --limit 10
+```
+
+### 2) Search the feed conservatively
+
+```bash
+python3 scripts/geeknews_search.py search --query Claude --limit 5
+```
+
+검색은 제목, 요약, 작성자, 링크/id 기준으로만 동작한다.
+
+### 3) Inspect a specific item
+
+```bash
+python3 scripts/geeknews_search.py detail --id 28439
+```
+
+상세 조회는 RSS 피드에 포함된 `content`/요약과 원문 링크를 함께 돌려준다.
+
+## Done when
+
+- 최신 GeekNews 글 목록을 바로 보여줄 수 있다.
+- 키워드 검색 결과에서 제목/링크/작성자/요약을 정리할 수 있다.
+- 특정 항목의 RSS 기반 내용을 보수적으로 확인하고 원문 링크를 함께 제시할 수 있다.
+
+## Failure modes
+
+- FeedBurner/GeekNews feed가 일시적으로 응답하지 않을 수 있다.
+- RSS 피드가 제공하는 범위를 넘는 전체 본문/댓글/투표 정보는 포함되지 않는다.
+- HTML 요약은 feed 원문 기준이라 일부가 잘릴 수 있다.
+
+## Notes
+
+- v1은 RSS-first, read-only 범위다.
+- 비공식 API나 로그인 세션에 의존하지 않는다.
+- 테스트/오프라인 검증 시 `--feed-file` 로 저장된 Atom XML을 넣을 수 있다.

package/skills/geeknews-search/scripts/geeknews_search.py

@@ -0,0 +1,296 @@
+#!/usr/bin/env python3
+
+from __future__ import annotations
+
+import argparse
+import json
+import re
+import urllib.request
+from dataclasses import asdict, dataclass
+from html import unescape
+from html.parser import HTMLParser
+from pathlib import Path
+
+GEEKNEWS_FEED_URL = "https://feeds.feedburner.com/geeknews-feed"
+
+
+class _TextExtractor(HTMLParser):
+    def __init__(self) -> None:
+        super().__init__()
+        self.parts: list[str] = []
+
+    def handle_data(self, data: str) -> None:
+        self.parts.append(data)
+
+    def text(self) -> str:
+        return " ".join(part.strip() for part in self.parts if part.strip())
+
+
+@dataclass(frozen=True)
+class GeekNewsItem:
+    id: str
+    title: str
+    link: str
+    published: str | None
+    updated: str | None
+    author_name: str | None
+    author_url: str | None
+    summary: str
+    content_html: str
+
+    def to_dict(self) -> dict[str, object]:
+        return asdict(self)
+
+
+@dataclass(frozen=True)
+class GeekNewsFeed:
+    title: str
+    source_id: str | None
+    updated: str | None
+    home_url: str | None
+    feed_url: str | None
+    category: str | None
+    items: list[GeekNewsItem]
+
+    def source_dict(self) -> dict[str, object]:
+        return {
+            "title": self.title,
+            "id": self.source_id,
+            "updated": self.updated,
+            "home_url": self.home_url,
+            "feed_url": self.feed_url,
+            "category": self.category,
+        }
+
+
+def _strip_cdata(value: str | None) -> str:
+    if not value:
+        return ""
+    stripped = value.strip()
+    if stripped.startswith("<![CDATA[") and stripped.endswith("]]>"):
+        return stripped[9:-3]
+    return stripped
+
+
+def _collapse_whitespace(value: str) -> str:
+    return re.sub(r"\s+", " ", value).strip()
+
+
+def _clean_xml_text(value: str | None) -> str:
+    return _collapse_whitespace(unescape(_strip_cdata(value)))
+
+
+def _html_to_text(html: str) -> str:
+    parser = _TextExtractor()
+    parser.feed(html)
+    parser.close()
+    return _collapse_whitespace(unescape(parser.text()))
+
+
+def _first_tag(block: str, tag: str) -> str | None:
+    match = re.search(rf"<{tag}\b[^>]*>(.*?)</{tag}>", block, re.DOTALL)
+    if not match:
+        return None
+    return _clean_xml_text(match.group(1))
+
+
+def _first_raw_tag(block: str, tag: str) -> str | None:
+    match = re.search(rf"<{tag}\b[^>]*>(.*?)</{tag}>", block, re.DOTALL)
+    if not match:
+        return None
+    return _strip_cdata(match.group(1)).strip()
+
+
+def _first_link_href(block: str) -> str | None:
+    patterns = (
+        r"<link\b[^>]*rel=['\"]alternate['\"][^>]*href=['\"]([^'\"]+)['\"]",
+        r"<link\b[^>]*href=['\"]([^'\"]+)['\"]",
+    )
+    for pattern in patterns:
+        match = re.search(pattern, block)
+        if match:
+            return unescape(match.group(1).strip())
+    return None
+
+
+def _link_href(block: str, *, rel: str | None = None) -> str | None:
+    if rel:
+        match = re.search(
+            rf"<link\b[^>]*(?:rel|ref)=['\"]{re.escape(rel)}['\"][^>]*href=['\"]([^'\"]+)['\"]",
+            block,
+        )
+        if match:
+            return unescape(match.group(1).strip())
+    return _first_link_href(block)
+
+
+def _feed_prefix(xml_text: str) -> str:
+    if "<entry" not in xml_text:
+        return xml_text
+    return xml_text.split("<entry", 1)[0]
+
+
+def _entry_blocks(xml_text: str) -> list[str]:
+    return re.findall(r"<entry\b[^>]*>(.*?)</entry>", xml_text, re.DOTALL)
+
+
+def _validate_limit(limit: int) -> int:
+    if limit <= 0:
+        raise ValueError("limit must be positive")
+    return limit
+
+
+def load_feed(xml_text: str) -> GeekNewsFeed:
+    prefix = _feed_prefix(xml_text)
+    items = []
+    for entry in _entry_blocks(xml_text):
+        author_block_match = re.search(r"<author\b[^>]*>(.*?)</author>", entry, re.DOTALL)
+        author_block = author_block_match.group(1) if author_block_match else ""
+        content_html = (_first_raw_tag(entry, "content") or "").strip()
+        items.append(
+            GeekNewsItem(
+                id=_first_tag(entry, "id") or "",
+                title=_first_tag(entry, "title") or "",
+                link=_first_link_href(entry) or (_first_tag(entry, "id") or ""),
+                published=_first_tag(entry, "published") or _first_tag(entry, "updated"),
+                updated=_first_tag(entry, "updated"),
+                author_name=_first_tag(author_block, "name"),
+                author_url=_first_tag(author_block, "uri"),
+                summary=_html_to_text(content_html),
+                content_html=content_html,
+            )
+        )
+
+    category_match = re.search(r"<category\b[^>]*term=['\"]([^'\"]+)['\"]", prefix)
+    return GeekNewsFeed(
+        title=_first_tag(prefix, "title") or "GeekNews",
+        source_id=_first_tag(prefix, "id"),
+        updated=_first_tag(prefix, "updated"),
+        home_url=_link_href(prefix, rel="alternate"),
+        feed_url=_link_href(prefix, rel="self") or _first_tag(prefix, "id"),
+        category=category_match.group(1) if category_match else None,
+        items=items,
+    )
+
+
+def list_items(feed: GeekNewsFeed, limit: int = 10) -> list[GeekNewsItem]:
+    return feed.items[:_validate_limit(limit)]
+
+
+def search_items(feed: GeekNewsFeed, query: str, limit: int = 10) -> list[GeekNewsItem]:
+    if not query.strip():
+        raise ValueError("query is required")
+    limit = _validate_limit(limit)
+    needle = query.casefold()
+    matches = []
+    for item in feed.items:
+        haystack = "\n".join(
+            part
+            for part in (
+                item.title,
+                item.summary,
+                item.author_name or "",
+                item.author_url or "",
+                item.id,
+                item.link,
+            )
+            if part
+        ).casefold()
+        if needle in haystack:
+            matches.append(item)
+        if len(matches) >= limit:
+            break
+    return matches
+
+
+def get_item_detail(feed: GeekNewsFeed, lookup: str) -> GeekNewsItem:
+    normalized_lookup = lookup.strip().casefold()
+    if not normalized_lookup:
+        raise ValueError("lookup is required")
+    for item in feed.items:
+        candidates = [item.id, item.link, item.title]
+        lowered = [candidate.casefold() for candidate in candidates if candidate]
+        if normalized_lookup in lowered or any(normalized_lookup in candidate for candidate in lowered):
+            return item
+    raise LookupError(f"No GeekNews entry matched: {lookup}")
+
+
+def _serialize_items(items: list[GeekNewsItem]) -> list[dict[str, object]]:
+    return [item.to_dict() for item in items]
+
+
+def build_list_payload(feed: GeekNewsFeed, limit: int = 10) -> dict[str, object]:
+    items = list_items(feed, limit=limit)
+    return {"source": feed.source_dict(), "count": len(items), "items": _serialize_items(items)}
+
+
+def build_search_payload(feed: GeekNewsFeed, query: str, limit: int = 10) -> dict[str, object]:
+    items = search_items(feed, query=query, limit=limit)
+    return {
+        "source": feed.source_dict(),
+        "query": query,
+        "count": len(items),
+        "items": _serialize_items(items),
+    }
+
+
+def build_detail_payload(feed: GeekNewsFeed, lookup: str) -> dict[str, object]:
+    item = get_item_detail(feed, lookup)
+    return {"source": feed.source_dict(), "item": item.to_dict()}
+
+
+def fetch_feed(url: str = GEEKNEWS_FEED_URL, timeout: int = 20) -> str:
+    request = urllib.request.Request(url, headers={"User-Agent": "k-skill-geeknews/1.0"})
+    with urllib.request.urlopen(request, timeout=timeout) as response:
+        charset = response.headers.get_content_charset() or "utf-8"
+        return response.read().decode(charset, errors="replace")
+
+
+def _add_feed_source_args(parser: argparse.ArgumentParser) -> None:
+    parser.add_argument("--feed-url", default=GEEKNEWS_FEED_URL, help="기본값: GeekNews public feed URL")
+    parser.add_argument("--feed-file", help="테스트/오프라인 검증용 로컬 Atom XML 파일")
+
+
+def parse_args(argv: list[str] | None = None) -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description="Read GeekNews entries from the public RSS/Atom feed.")
+
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    list_parser = subparsers.add_parser("list", help="최신 GeekNews 항목 목록")
+    _add_feed_source_args(list_parser)
+    list_parser.add_argument("--limit", type=int, default=10)
+
+    search_parser = subparsers.add_parser("search", help="제목/요약/작성자 기준 검색")
+    _add_feed_source_args(search_parser)
+    search_parser.add_argument("--query", required=True)
+    search_parser.add_argument("--limit", type=int, default=10)
+
+    detail_parser = subparsers.add_parser("detail", help="항목 상세 확인")
+    _add_feed_source_args(detail_parser)
+    detail_parser.add_argument("--id", required=True, help="entry id/link/topic id 일부")
+
+    return parser.parse_args(argv)
+
+
+def _load_feed_text(args: argparse.Namespace) -> str:
+    if args.feed_file:
+        return Path(args.feed_file).read_text(encoding="utf-8")
+    return fetch_feed(url=args.feed_url)
+
+
+def main(argv: list[str] | None = None) -> None:
+    args = parse_args(argv)
+    feed = load_feed(_load_feed_text(args))
+
+    if args.command == "list":
+        payload = build_list_payload(feed, limit=args.limit)
+    elif args.command == "search":
+        payload = build_search_payload(feed, query=args.query, limit=args.limit)
+    else:
+        payload = build_detail_payload(feed, lookup=args.id)
+
+    print(json.dumps(payload, ensure_ascii=False, indent=2))
+
+
+if __name__ == "__main__":
+    main()

package/skills/geeknews-search/skill.json

@@ -0,0 +1,8 @@
+{
+  "name": "geeknews-search",
+  "description": "GeekNews public RSS/Atom feed로 긱뉴스 게시물을 조회, 검색, 상세 확인하는 읽기 전용 스킬.",
+  "profiles": [
+    "lookup"
+  ],
+  "frontmatter": "name: geeknews-search\ndescription: GeekNews public RSS/Atom feed로 긱뉴스 게시물을 조회, 검색, 상세 확인하는 읽기 전용 스킬.\nlicense: MIT\nmetadata:\n  category: news\n  locale: ko-KR\n  source: geeknews-rss"
+}

package/skills/gongsijiga-search/instruction.md

@@ -0,0 +1,128 @@
+# 개별공시지가 조회
+
+## What this skill does
+
+한국 국토교통부 부동산공시가격알리미(realtyprice.kr)에서 특정 필지의 **개별공시지가**(원/㎡)를 조회한다. 다년도 추이(최근 5년 이내)와 전년 대비 변동률을 정규화된 JSON으로 반환한다.
+
+공시지가는 매년 1월 1일 기준, 4~5월 공시. 세금(재산세, 종합부동산세, 양도소득세) 산정의 법적 기준 단가다.
+
+## When to use
+
+- "서울 강남구 역삼동 736 공시지가 알려줘"
+- "전라남도 무안군 청계면 청천리 100번지 개별공시지가"
+- "서초동 산 1-2 공시지가 추이"
+- 세무 계산에서 토지 공시 단가가 필요할 때
+
+## When NOT to use
+
+- 시세, 실거래가, 매매가, 호가 → 다른 데이터 소스 필요
+- 공동주택가격, 표준지공시지가, 단독주택가격 → 별도 스킬
+- 토지이용계획 → eum.go.kr 별도 스킬
+
+## Prerequisites
+
+- 인터넷 연결
+- `curl` (또는 HTTP 호출 도구)
+
+사용자에게 필요한 시크릿 없음 (공개 데이터).
+
+## Default path
+
+`gongsijiga-search` npm 패키지를 직접 호출한다. realtyprice.kr는 API 키가 필요 없는 공개 엔드포인트이므로 `k-skill-proxy`를 경유하지 않는다.
+
+설치:
+
+```bash
+npm install gongsijiga-search
+```
+
+호출:
+
+```bash
+node -e "
+const { lookupGongsijiga } = require('gongsijiga-search');
+lookupGongsijiga('서울 강남구 역삼동 736').then(console.log).catch(console.error);
+"
+```
+
+## Workflow
+
+### 1. 사용자 입력 수집
+
+사용자에게 **시도 + 시군구 + 읍면동 + 지번**이 포함된 주소를 요청한다.
+
+- 최소 필수: 시도, 시군구, 읍면동, 본번
+  - **세종특별자치시**는 시군구가 없으므로 "세종 [읍면동] [지번]" 형식
+- 산 지번이면 "산" 키워드 포함
+- 부번이 있으면 "100-5" 형식
+
+예시: "서울 강남구 역삼동 736", "전남 무안군 청계면 청천리 산 1-2", "세종 고용동 100"
+
+시도가 누락된 주소(예: "역삼동 736")는 조회 불가 — 시도를 물어본다.
+
+### 2. 직접 호출
+
+`gongsijiga-search` 모듈을 사용해 realtyprice.kr를 직접 호출한다 (API 키 불필요, 프록시 경유 안 함):
+
+```javascript
+const { lookupGongsijiga } = require('gongsijiga-search');
+
+const result = await lookupGongsijiga('서울 강남구 역삼동 736');
+```
+
+### 3. 응답 해석 및 출력
+
+성공 응답 예시:
+
+```json
+{
+  "address": "서울 강남구 역삼동 736",
+  "jibun": "736번지",
+  "san": false,
+  "latest": {
+    "year": 2026,
+    "price_per_sqm": 72340000,
+    "notice_date": "2026-04-30",
+    "base_date": "2026-01-01"
+  },
+  "history": [...],
+  "yoy_change_pct": 5.45,
+  "source_url": "https://www.realtyprice.kr/notice/gsindividual/search.htm"
+}
+```
+
+**출력 규칙:**
+
+1. 반드시 "공시지가" 단어 사용. "가격/시세/매매가" 단어 금지.
+2. 헤더: `[정부 공시] 개별공시지가 — {address}`
+3. 최신값: `{year}년 공시지가: {price_per_sqm:,}원/㎡ (전년 대비 +{yoy_change_pct}%)`
+4. 추이 표 (history 배열을 연도순 테이블로):
+
+| 연도 | 공시지가 (원/㎡) | 공시일 |
+|------|-----------------|--------|
+| 2026 | 72,340,000 | 2026-04-30 |
+| ... | ... | ... |
+
+5. 마지막 줄 disclaimer:
+   `본 단가는 세금 산정용 정부 공시 가격으로, 시세나 실거래가와 다릅니다.`
+
+### 4. 올해 미발표 안내
+
+`latest.year`가 올해보다 작으면: "올해 공시지가는 아직 미발표 상태입니다. 최신 데이터는 {latest.year}년 기준입니다." 안내.
+
+## Failure modes
+
+| error.code | 의미 | 행동 |
+|---|---|---|
+| `ADDRESS_PARSE_FAILED` | 주소 파싱 실패 | "행정구역 + 본번까지 포함된 주소가 필요합니다" + 예시 |
+| `INVALID_BUNJI` | 본번 형식 오류 | 본번 입력 형식 재요청 |
+| `REGION_NOT_FOUND` | 행정구역 매칭 실패 | candidates 배열이 있으면 제안, 없으면 오타 확인 요청 |
+| `LAND_NOT_FOUND` | 해당 지번 미등재 | "본번/부번 오타이거나 도로/하천 등 미과세 토지" 설명 |
+| `UPSTREAM_ERROR` | realtyprice.kr 장애 | "데이터 출처 일시 장애. 잠시 후 재시도" + source_url |
+| `UPSTREAM_TIMEOUT` | 30초 초과 | UPSTREAM_ERROR와 동일 |
+
+## Notes
+
+- 공시지가 ≠ 시세. 시세는 통상 공시지가의 1.5~3배.
+- 매년 1월 1일 기준, 4~5월 발표. 1~4월은 전년도가 최신.
+- realtyprice.kr는 API 키 불필요 (공개 데이터).

package/skills/gongsijiga-search/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "gongsijiga-search",
+  "description": "|",
+  "profiles": [
+    "proxy",
+    "lookup"
+  ],
+  "frontmatter": "name: gongsijiga-search\ndescription: |\n  대한민국 국토교통부가 매년 공시하는 \"개별공시지가\"(원/㎡) 조회.\n  지번 단위 토지의 정부 공시 단가로, 재산세·종부세·양도세 등\n  세금 산정의 법적 기준이다. **시세/실거래가가 아니다.**\n  Use when the user asks for 공시지가, 개별공시지가, 토지 공시단가,\n  세무 계산용 토지 단가, or \"이 땅 공시지가 얼마야\".\n  Do NOT use for 시세, 실거래가, 매매가, 호가, 공동주택가격\n  (those need a different data source).\nlicense: MIT\nmetadata:\n  category: real-estate\n  locale: ko-KR\n  phase: v1"
+}