@nomadamas/k-skill 0.1.0

package/skills/building-register-search/scripts/building_register.py

@@ -0,0 +1,309 @@
+#!/usr/bin/env python3
+"""Read-only building-register title lookup helper using stdlib only."""
+# allow: SIZE_OK - Cohesive Building Register CLI adapter covering normalization, transport, and output contracts.
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import pathlib
+import sys
+import urllib.error
+import urllib.parse
+import urllib.request
+from typing import Any, Dict, Optional
+
+SCRIPTS_DIR = pathlib.Path(__file__).resolve().parent
+if str(SCRIPTS_DIR) not in sys.path:
+    sys.path.insert(0, str(SCRIPTS_DIR))
+from building_register_xml import parse_direct_xml
+
+
+DEFAULT_PROXY_BASE_URL = "https://k-skill-proxy.nomadamas.org"
+DEFAULT_SECRETS_PATH = pathlib.Path("~/.config/k-skill/secrets.env").expanduser()
+UPSTREAM_URL = "https://apis.data.go.kr/1613000/BldRgstHubService/getBrTitleInfo"
+PROXY_DOWN_MSG = "설정된 k-skill-proxy 프록시 서버가 응답하지 않습니다. 잠시 후 재시도하거나 운영자에게 문의하세요."
+PROXY_NOT_CONFIGURED_MSG = "k-skill-proxy에 건축물대장 API 키가 설정되어 있지 않습니다. 운영자에게 문의하세요."
+KAKAO_NOT_CONFIGURED_MSG = (
+    "k-skill-proxy에 Kakao Local API 키가 설정되어 있지 않습니다. "
+    "주소 조회는 Kakao geocode가 필요합니다. 운영자에게 문의하거나 PNU/개별 필지를 사용하세요."
+)
+
+
+class HelperError(RuntimeError):
+    pass
+
+
+def load_secrets(path: pathlib.Path) -> Dict[str, str]:
+    values: Dict[str, str] = {}
+    try:
+        lines = path.read_text(encoding="utf-8").splitlines()
+    except OSError:
+        return values
+    for raw in lines:
+        line = raw.strip()
+        if not line or line.startswith("#") or "=" not in line:
+            continue
+        key, value = line.split("=", 1)
+        values[key.strip()] = value.strip().strip('"').strip("'")
+    return values
+
+
+def resolve_api_key(args: argparse.Namespace) -> Optional[str]:
+    env_key = os.environ.get("KSKILL_BUILDING_REGISTER_API_KEY") or os.environ.get("DATA_GO_KR_API_KEY")
+    if env_key and env_key.strip():
+        return env_key.strip()
+    secrets = load_secrets(pathlib.Path(args.secrets_path).expanduser())
+    value = secrets.get("KSKILL_BUILDING_REGISTER_API_KEY") or secrets.get("DATA_GO_KR_API_KEY")
+    return value.strip() if value and value.strip() else None
+
+
+def _bounded_integer(value: int, label: str, maximum: int) -> int:
+    if value < 1 or value > maximum:
+        raise HelperError(f"{label} 값은 1~{maximum} 범위여야 합니다.")
+    return value
+
+
+def _exact_digits(value: Optional[str], length: int, label: str) -> str:
+    text = (value or "").strip()
+    if len(text) != length or not text.isdigit():
+        raise HelperError(f"{label} 값은 {length}자리 숫자여야 합니다.")
+    return text
+
+
+def _parcel(value: Optional[str], label: str, required: bool = False) -> str:
+    text = (value or "").strip()
+    if not text:
+        if required:
+            raise HelperError(f"{label} 값이 필요합니다.")
+        return "0000"
+    if not text.isdigit() or len(text) > 4:
+        raise HelperError(f"{label} 값은 1~4자리 숫자여야 합니다.")
+    return text.zfill(4)
+
+
+def normalize_parcel(pnu: Optional[str], sigungu_cd: Optional[str], bjdong_cd: Optional[str],
+                     plat_gb_cd: Optional[str], bun: Optional[str], ji: Optional[str]) -> Dict[str, str]:
+    explicit = any((sigungu_cd, bjdong_cd, plat_gb_cd, bun, ji))
+    if pnu and explicit:
+        raise HelperError("PNU와 개별 법정동/필지 값은 같이 입력할 수 없습니다.")
+    if pnu:
+        normalized_pnu = _exact_digits(pnu, 19, "PNU")
+        land_category = normalized_pnu[10:11]
+        plat_gb_cd_by_land_category = {"1": "0", "2": "1"}
+        if land_category not in plat_gb_cd_by_land_category:
+            raise HelperError("PNU 토지구분 값은 1(일반 토지) 또는 2(산)여야 합니다.")
+        result = {
+            "pnu": normalized_pnu,
+            "sigunguCd": normalized_pnu[:5],
+            "bjdongCd": normalized_pnu[5:10],
+            "platGbCd": plat_gb_cd_by_land_category[land_category],
+            "bun": normalized_pnu[11:15],
+            "ji": normalized_pnu[15:19],
+        }
+        return result
+    if not explicit:
+        raise HelperError("--pnu, --address 또는 개별 법정동/필지 값을 입력하세요.")
+    sigungu = _exact_digits(sigungu_cd, 5, "sigunguCd")
+    bjdong = _exact_digits(bjdong_cd, 5, "bjdongCd")
+    plat = (plat_gb_cd or "").strip()
+    if plat not in {"0", "1", "2"}:
+        raise HelperError("platGbCd 값은 0, 1, 2 중 하나여야 합니다.")
+    main = _parcel(bun, "bun", required=True)
+    sub = _parcel(ji, "ji")
+    result = {
+        "sigunguCd": sigungu,
+        "bjdongCd": bjdong,
+        "platGbCd": plat,
+        "bun": main,
+        "ji": sub,
+    }
+    land_category_by_plat_gb_cd = {"0": "1", "1": "2"}
+    land_category = land_category_by_plat_gb_cd.get(plat)
+    if land_category is not None:
+        result["pnu"] = f"{sigungu}{bjdong}{land_category}{main}{sub}"
+    return result
+
+
+def build_query(args: argparse.Namespace) -> Dict[str, Any]:
+    if args.address:
+        if args.direct:
+            raise HelperError("--address는 Kakao hosted proxy를 사용하는 proxy mode에서만 지원합니다. 직접 호출은 PNU나 개별 필지 값을 사용하세요.")
+        if any((args.pnu, args.sigungu_cd, args.bjdong_cd, args.plat_gb_cd, args.bun, args.ji)):
+            raise HelperError("--address와 PNU/개별 필지 값은 같이 입력할 수 없습니다.")
+        raise HelperError("주소를 먼저 법정동 코드와 필지로 변환해야 합니다.")
+    query: Dict[str, Any] = normalize_parcel(
+        args.pnu, args.sigungu_cd, args.bjdong_cd, args.plat_gb_cd, args.bun, args.ji
+    )
+    query["pageNo"] = _bounded_integer(args.page_no, "pageNo", 100000)
+    query["numOfRows"] = _bounded_integer(args.num_of_rows, "numOfRows", 100)
+    return query
+
+
+def query_from_address_payload(payload: Dict[str, Any]) -> Dict[str, str]:
+    documents = payload.get("documents")
+    if not isinstance(documents, list) or len(documents) != 1:
+        raise HelperError("주소 검색 결과가 없거나 하나로 확정되지 않았습니다. 법정동 주소와 필지 번호를 더 정확히 입력하세요.")
+    address = documents[0].get("address") if isinstance(documents[0], dict) else None
+    if not isinstance(address, dict):
+        raise HelperError("주소 결과에 법정동 필지 정보가 없습니다. 도로명만이 아니라 번지까지 포함한 주소를 입력하세요.")
+    b_code = str(address.get("b_code") or "").strip()
+    main = str(address.get("main_address_no") or "").strip()
+    sub = str(address.get("sub_address_no") or "0").strip() or "0"
+    mountain = str(address.get("mountain_yn") or "N").strip().upper()
+    if len(b_code) != 10 or not b_code.isdigit():
+        raise HelperError("주소 결과에 10자리 법정동 코드(b_code)가 없습니다.")
+    if not main:
+        raise HelperError("주소 결과에 본번이 없어 필지를 확정할 수 없습니다.")
+    return normalize_parcel(None, b_code[:5], b_code[5:], "1" if mountain == "Y" else "0", main, sub)
+
+
+def build_title_url(args: argparse.Namespace, query: Dict[str, Any], api_key: Optional[str]) -> str:
+    if args.direct:
+        if not api_key:
+            raise HelperError(
+                "KSKILL_BUILDING_REGISTER_API_KEY 또는 DATA_GO_KR_API_KEY가 없습니다. "
+                "공공데이터포털 데이터셋 15134735 활용신청 후 키를 설정하세요."
+            )
+        direct_query = {key: value for key, value in query.items() if key != "pnu"}
+        direct_query["serviceKey"] = api_key
+        return f"{UPSTREAM_URL}?{urllib.parse.urlencode(direct_query)}"
+    if args.pnu:
+        proxy_query = {key: value for key, value in query.items() if key not in {"sigunguCd", "bjdongCd", "platGbCd", "bun", "ji"}}
+    else:
+        proxy_query = {key: value for key, value in query.items() if key != "pnu"}
+    return f"{args.proxy_base_url.rstrip('/')}/v1/building-register/title?{urllib.parse.urlencode(proxy_query)}"
+
+
+def http_get_json(url: str, timeout: int, via_proxy: bool) -> Dict[str, Any]:
+    request = urllib.request.Request(url, headers={"accept": "application/json", "user-agent": "k-skill/building-register-search"})
+    try:
+        with urllib.request.urlopen(request, timeout=timeout) as response:
+            raw = response.read().decode("utf-8", errors="replace")
+    except urllib.error.HTTPError as error:
+        raw = error.read().decode("utf-8", errors="replace") if error.fp else ""
+        try:
+            payload = json.loads(raw)
+        except json.JSONDecodeError:
+            payload = {}
+        if via_proxy and error.code == 503 and payload.get("error") == "upstream_not_configured":
+            message = str(payload.get("message") or "")
+            if "KAKAO" in message.upper() or "/kakao-local/" in url:
+                raise HelperError(KAKAO_NOT_CONFIGURED_MSG) from error
+            raise HelperError(PROXY_NOT_CONFIGURED_MSG) from error
+        raise HelperError(str(payload.get("message") or f"API HTTP 오류: {error.code} {error.reason}")) from error
+    except urllib.error.URLError as error:
+        if via_proxy:
+            raise HelperError(f"{PROXY_DOWN_MSG} (상세: {error.reason})") from error
+        raise HelperError(f"상류 API 네트워크 오류: {error.reason}") from error
+    except TimeoutError as error:
+        target = "프록시 서버" if via_proxy else "상류 API"
+        raise HelperError(f"{target} 요청 시간이 초과되었습니다.") from error
+    try:
+        payload = json.loads(raw)
+    except json.JSONDecodeError as error:
+        raise HelperError("API 응답이 올바른 JSON이 아닙니다.") from error
+    if not isinstance(payload, dict):
+        raise HelperError("API 응답 형식이 올바르지 않습니다.")
+    return payload
+
+
+def http_get_direct_xml(url: str, timeout: int) -> Dict[str, Any]:
+    request = urllib.request.Request(url, headers={"accept": "application/xml", "user-agent": "k-skill/building-register-search"})
+    try:
+        with urllib.request.urlopen(request, timeout=timeout) as response:
+            raw = response.read()
+    except urllib.error.HTTPError as error:
+        raise HelperError(f"건축물대장 API HTTP 오류: {error.code} {error.reason}") from error
+    except urllib.error.URLError as error:
+        raise HelperError(f"건축물대장 API 네트워크 오류: {error.reason}") from error
+    except TimeoutError as error:
+        raise HelperError("건축물대장 API 요청 시간이 초과되었습니다.") from error
+    return parse_direct_xml(raw, HelperError)
+
+
+def format_text(payload: Dict[str, Any]) -> str:
+    items = payload.get("items") or []
+    if not isinstance(items, list):
+        items = [items]
+    total = payload.get("total_count", len(items))
+    lines = [f"건축물대장 표제부 조회 결과: {total}건"]
+    for item in items:
+        address = item.get("platPlc") or item.get("newPlatPlc") or "주소 없음"
+        purpose = item.get("mainPurpsCdNm") or "주용도 없음"
+        area = item.get("totArea") or "-"
+        floors = f"지상 {item.get('grndFlrCnt', '-')} / 지하 {item.get('ugrndFlrCnt', '-')}"
+        approved = item.get("useAprDay") or "-"
+        lines.append(f"- {address} / {purpose} / 연면적 {area}㎡ / {floors} / 사용승인일 {approved}")
+    if not items:
+        lines.append("해당 필지의 건축물대장 표제부가 없습니다.")
+    return "\n".join(lines)
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(description="건축물대장 표제부 조회")
+    subparsers = parser.add_subparsers(dest="command", required=True)
+    title = subparsers.add_parser("title", help="건축물대장 표제부 조회")
+    title.add_argument("--pnu")
+    title.add_argument("--sigungu-cd")
+    title.add_argument("--bjdong-cd")
+    title.add_argument("--plat-gb-cd")
+    title.add_argument("--bun")
+    title.add_argument("--ji")
+    title.add_argument("--address")
+    title.add_argument("--page-no", type=int, default=1)
+    title.add_argument("--num-of-rows", type=int, default=10)
+    title.add_argument("--proxy-base-url", default=os.environ.get("KSKILL_PROXY_BASE_URL", DEFAULT_PROXY_BASE_URL))
+    title.add_argument("--direct", action="store_true")
+    title.add_argument("--secrets-path", default=str(DEFAULT_SECRETS_PATH))
+    title.add_argument("--timeout", type=int, default=20)
+    title.add_argument("--dry-run", action="store_true")
+    title.add_argument("--json", action="store_true")
+    return parser
+
+
+def parse_args(argv: Optional[list[str]] = None) -> argparse.Namespace:
+    return build_parser().parse_args(argv)
+
+
+def run(argv: Optional[list[str]] = None) -> int:
+    try:
+        args = parse_args(argv)
+        if args.address:
+            if args.direct:
+                raise HelperError("--address는 proxy mode에서만 지원합니다. 직접 호출은 PNU나 개별 필지 값을 사용하세요.")
+            if any((args.pnu, args.sigungu_cd, args.bjdong_cd, args.plat_gb_cd, args.bun, args.ji)):
+                raise HelperError("--address와 PNU/개별 필지 값은 같이 입력할 수 없습니다.")
+            geocode_url = f"{args.proxy_base_url.rstrip('/')}/v1/kakao-local/geocode?{urllib.parse.urlencode({'q': args.address, 'limit': 2})}"
+            if args.dry_run:
+                print(json.dumps({
+                    "operation": "title",
+                    "geocode_url": geocode_url,
+                    "next": (
+                        "/v1/building-register/title?sigunguCd=<derived>&bjdongCd=<derived>"
+                        "&platGbCd=<derived>&bun=<derived>&ji=<derived>"
+                    ),
+                }, ensure_ascii=False, indent=2))
+                return 0
+            address_payload = http_get_json(geocode_url, args.timeout, via_proxy=True)
+            query = query_from_address_payload(address_payload)
+            query["pageNo"] = _bounded_integer(args.page_no, "pageNo", 100000)
+            query["numOfRows"] = _bounded_integer(args.num_of_rows, "numOfRows", 100)
+        else:
+            query = build_query(args)
+        api_key = resolve_api_key(args) if args.direct else None
+        url = build_title_url(args, query, "REDACTED" if args.dry_run and args.direct else api_key)
+        if args.dry_run:
+            print(json.dumps({"operation": "title", "url": url, "query": query}, ensure_ascii=False, indent=2))
+            return 0
+        payload = http_get_direct_xml(url, args.timeout) if args.direct else http_get_json(url, args.timeout, via_proxy=True)
+        print(json.dumps(payload, ensure_ascii=False, indent=2) if args.json else format_text(payload))
+        return 0
+    except HelperError as error:
+        print(str(error), file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(run())

package/skills/building-register-search/scripts/building_register_xml.py

@@ -0,0 +1,32 @@
+"""XML normalization for the building-register direct API."""
+
+import xml.etree.ElementTree as ET
+from typing import Any, Dict, Type
+
+
+def parse_direct_xml(raw: bytes, error_type: Type[RuntimeError]) -> Dict[str, Any]:
+    try:
+        root = ET.fromstring(raw)
+    except ET.ParseError as error:
+        raise error_type("건축물대장 API 응답 XML이 올바르지 않습니다.") from error
+    result_code = (root.findtext("./header/resultCode") or "").strip()
+    result_message = (root.findtext("./header/resultMsg") or "").strip()
+    if result_code not in {"", "0", "00"}:
+        raise error_type(f"건축물대장 API 오류: {result_message or result_code}")
+    body = root.find("./body")
+    if body is None:
+        raise error_type("건축물대장 API 응답 본문이 없습니다.")
+    items = [{child.tag: child.text or "" for child in item} for item in body.findall("./items/item")]
+    pagination = {}
+    for field, default in (("pageNo", 1), ("numOfRows", len(items)), ("totalCount", len(items))):
+        try:
+            pagination[field] = int(body.findtext(field) or default)
+        except ValueError as error:
+            raise error_type(f"건축물대장 API 응답 {field}가 올바른 정수가 아닙니다.") from error
+        if pagination[field] < 0:
+            raise error_type(f"건축물대장 API 응답 {field}가 음수입니다.")
+    return {
+        "page": pagination["pageNo"], "page_size": pagination["numOfRows"],
+        "total_count": pagination["totalCount"], "items": items,
+        "source": {"data_go_kr_dataset": "15134735", "operation": "getBrTitleInfo", "response_format": "XML"},
+    }

package/skills/building-register-search/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "building-register-search",
+  "description": "Use when the user asks to look up a Korean building-register title record by address, PNU, legal-dong code, or parcel number.",
+  "profiles": [
+    "vault",
+    "lookup"
+  ],
+  "frontmatter": "name: building-register-search\ndescription: Use when the user asks to look up a Korean building-register title record by address, PNU, legal-dong code, or parcel number.\nlicense: MIT\nmetadata:\n  category: real-estate\n  locale: ko-KR\n  phase: v1"
+}

package/skills/bunjang-search/instruction.md

@@ -0,0 +1,154 @@
+# Bunjang Search
+
+## What this skill does
+
+upstream [`bunjang-cli`](https://www.npmjs.com/package/bunjang-cli) / [`pinion05/bunjangcli`](https://github.com/pinion05/bunjangcli) 를 사용해 번개장터에서 아래 흐름을 처리한다.
+
+- 상품 검색
+- 상품 상세조회
+- 선택적 찜/채팅
+- 다페이지 대량 수집
+- AI 분석용 TOON chunk export
+
+## Core policy
+
+- 기본 경로는 **항상 CLI first** 다.
+- 기본 명령은 `npx --yes bunjang-cli ...` 형식을 쓴다.
+- `auth login` 은 headful 브라우저 + **TTY / interactive 터미널**이 필요하다.
+- 로그인 전에는 검색/상세조회/대량 수집 위주로 답하고, `favorite` / `chat` / `purchase` 는 **선택적 로그인 플로우**로만 안내한다.
+- 대량 수집은 `--start-page`, `--pages`, `--max-items`, `--with-detail`, `--output` 조합을 우선 쓴다.
+- AI 분석용 export 는 `--ai --output <directory>` 로 `.toon` chunk 를 만든다.
+- 찜/채팅은 명시적으로 요청받지 않으면 실행하지 않는다.
+
+## When to use
+
+- "번개장터에서 아이폰 검색해줘"
+- "번장에서 이 상품 상세 봐줘"
+- "여러 페이지 모아서 JSON으로 저장해줘"
+- "AI 평가용으로 번개장터 결과를 chunk 로 만들어줘"
+
+## When not to use
+
+- 계정 로그인 없이 바로 찜/채팅을 강행해야 하는 경우
+- 구매 확정/결제 자동화를 기대하는 경우
+- 번개장터 외 다른 중고거래 플랫폼을 동시에 다뤄야 하는 경우
+
+## Quick smoke test
+
+```bash
+npx --yes bunjang-cli --help
+npx --yes bunjang-cli --json auth status
+npx --yes bunjang-cli --json search "아이폰" --max-items 3 --sort date
+npx --yes bunjang-cli --json item get 354957625
+```
+
+## Login flow
+
+```bash
+npx --yes bunjang-cli auth login
+npx --yes bunjang-cli auth logout
+npx --yes bunjang-cli --json auth status
+```
+
+- `auth login` 은 브라우저에서 로그인한 뒤 **터미널로 돌아와 Enter 를 눌러야** 완료된다.
+- 그래서 비-TTY 실행 대신 interactive 세션에서만 진행한다.
+
+## Search flow
+
+```bash
+npx --yes bunjang-cli search "아이폰"
+npx --yes bunjang-cli search "아이폰" --price-min 500000 --price-max 1200000
+npx --yes bunjang-cli search "아이폰" --sort date
+npx --yes bunjang-cli --json search "아이폰" --max-items 5
+```
+
+검색 결과는 광고/매입글/악세서리 노이즈가 섞이고, search summary 의 `location` 이 noisy 하거나 `description` / `status` 가 비어 있을 수 있다. 그래서 **검색 단계는 제목/가격 중심 1차 triage** 로만 쓴다.
+
+- 기기명/용량 키워드 일치 여부
+- 가격대 범위
+- 판매 링크/썸네일 중복 여부
+
+`description`, `status`, 깔끔한 `location` 이 필요하면 **반드시 `item get` 또는 `--with-detail` 이후** 에만 판단한다.
+
+## Detail flow
+
+```bash
+npx --yes bunjang-cli item get 354957625
+npx --yes bunjang-cli --json item get 354957625
+npx --yes bunjang-cli --json item list --ids 354957625,354801707
+```
+
+상세조회에서는 아래 필드를 먼저 읽는다.
+
+- `price`
+- `description`
+- `location`
+- `category`
+- `status`
+- `sellerName`
+- `sellerItemCount`
+- `sellerFollowerCount`
+- `sellerReviewCount`
+- `favoriteCount`
+- `transportUsed`
+
+## Bulk collection
+
+```bash
+npx --yes bunjang-cli search "아이폰" \
+  --start-page 1 \
+  --pages 5 \
+  --max-items 50 \
+  --sort date \
+  --with-detail \
+  --output artifacts/bunjang-iphone.json
+```
+
+검증할 때는 export 파일 생성 여부와 top-level `items[]` 안의 `summary` / `detail` / optional `error` 구조, 그리고 각 item 의 `sourcePage` 또는 `summary.raw.page` 를 같이 확인한다.
+
+## AI export
+
+```bash
+npx --yes bunjang-cli search "아이폰" \
+  --start-page 1 \
+  --pages 5 \
+  --max-items 50 \
+  --with-detail \
+  --ai \
+  --output artifacts/bunjang-iphone-ai
+```
+
+- `--ai` 에서는 `--output` 이 **파일이 아니라 디렉토리** 여야 한다.
+- 결과는 `items-1.toon` 형태 chunk 로 저장된다.
+- AI 평가용으로 여러 서브에이전트에 분산 읽기시키기 좋다.
+
+## Optional favorite/chat flow
+
+로그인된 interactive 세션에서만 아래 액션을 진행한다.
+
+```bash
+npx --yes bunjang-cli --json favorite list
+npx --yes bunjang-cli --json favorite add 354957625
+npx --yes bunjang-cli --json favorite remove 354957625
+npx --yes bunjang-cli --json chat list
+npx --yes bunjang-cli --json chat start 354957625 --message "안녕하세요"
+npx --yes bunjang-cli --json chat send 84191651 --message "상품 상태 괜찮을까요?"
+```
+
+- 찜/채팅은 **로그인이 필요한 선택적 기능**이다.
+- 검증 목적이면 `favorite list` 로 세션을 먼저 확인하고, 같은 상품에 대해 `favorite add` / `favorite remove` 를 왕복 실행한다.
+- `chat start` 는 상품 페이지에서 새 대화를 열 때, `chat send` 는 기존 thread 에 메시지를 보낼 때 쓴다.
+
+## Recommended response format
+
+1. 검색어가 넓으면 예산/모델/지역을 먼저 좁힌다.
+2. 검색 결과 상위 3~5개는 제목/가격 중심 1차 요약만 한다.
+3. `description` / `status` / `location` 판단이 필요하면 `item get` 또는 `--with-detail` 로 상세를 먼저 읽는다.
+4. 로그인 액션이 필요하면 "지금은 로그인 세션이 없으니 interactive TTY 에서 `auth login` 후 다시 진행" 이라고 분명히 말한다.
+5. 대량 분석이면 JSON export 또는 TOON chunk 생성 경로를 제안한다.
+
+## Done when
+
+- 검색/상세조회/대량 수집/AI export 중 필요한 경로가 안내되었다.
+- 찜/채팅은 로그인 필요성과 선택적 성격이 명확히 고지되었다.
+- 자동 구매/결제는 범위 밖이라고 분명히 말했다.

package/skills/bunjang-search/skill.json

@@ -0,0 +1,10 @@
+{
+  "name": "bunjang-search",
+  "description": "번개장터 검색, 상세조회, 찜, 채팅, 대량 수집, AI TOON export를 bunjang-cli로 안내한다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
+  "profiles": [
+    "vault",
+    "browser",
+    "action:commerce"
+  ],
+  "frontmatter": "name: bunjang-search\ndescription: 번개장터 검색, 상세조회, 찜, 채팅, 대량 수집, AI TOON export를 bunjang-cli로 안내한다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: marketplace\n  locale: ko-KR\n  phase: v1"
+}