@nomadamas/k-skill 0.1.0

package/skills/library-book-search/instruction.md

@@ -0,0 +1,139 @@
+# Library Book Search (Data4Library)
+
+## What this skill does
+
+국립중앙도서관의 **도서관 정보나루(Data4Library)** Open API를 `k-skill-proxy`가 중계하는 HTTP API로 조회한다.
+
+- 키워드로 도서를 검색한다.
+- ISBN으로 상세 서지·대출정보를 확인한다.
+- ISBN + 지역코드로 해당 도서를 소장한 도서관 목록을 찾는다.
+- 도서관 코드 + ISBN으로 특정 도서관의 소장/대출 가능 여부를 확인한다.
+
+## When to use
+
+- "역사 관련 책 도서관 정보나루에서 찾아줘"
+- "이 ISBN 소장한 서울 도서관 찾아줘"
+- "정독도서관에 이 책 있는지 확인해줘"
+- "도서관 도서 조회 가능해?"
+
+## Prerequisites
+
+- 인터넷 연결
+- `curl` 사용 가능 환경
+- `k-skill-proxy`에 `DATA4LIBRARY_AUTH_KEY`가 설정된 배포(기본 hosted 또는 self-host)에 접근 가능할 것
+
+## Credential requirements
+
+사용자에게 필요한 시크릿은 없으며, `DATA4LIBRARY_AUTH_KEY`는 프록시 서버에서만 관리한다.
+
+- 사용자 측 **필수 시크릿 없음**.
+- `KSKILL_PROXY_BASE_URL` — self-host·별도 프록시를 쓸 때만 설정. 비우면 기본 hosted `https://k-skill-proxy.nomadamas.org` 를 사용한다.
+- `DATA4LIBRARY_AUTH_KEY` 는 **프록시 서버** 환경에만 둔다. 사용자에게 인증키를 요구하거나 응답에 노출하지 않는다.
+
+## Proxy base URL
+
+```bash
+BASE="${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}"
+BASE="${BASE%/}"
+```
+
+## Workflow
+
+### 1) Collect the intent and minimal inputs
+
+사용자 요청에 따라 필요한 값만 묻는다.
+
+- 키워드 도서 검색: `keyword`만 있으면 시작한다.
+- 상세 조회: ISBN(10자리 또는 13자리)이 필요하다.
+- 소장 도서관 조회: ISBN + 광역 지역코드(`region`)가 필요하다. 시군구 상세코드(`dtl_region`)가 있으면 같이 쓴다.
+- 특정 도서관 소장 확인: 도서관 코드(`libraryCode`) + ISBN이 필요하다.
+
+도서관 코드나 지역코드가 없으면 먼저 `library-search`로 후보를 보거나, 사용자에게 알고 있는 도서관명·지역을 더 물어본다. 이름만으로 확정되지 않으면 임의로 하나를 고르지 않는다.
+
+### 2) Search books (`/v1/data4library/book-search`)
+
+```bash
+curl -fsS --get "${BASE}/v1/data4library/book-search" \
+  --data-urlencode "keyword=역사" \
+  --data-urlencode "pageNo=1" \
+  --data-urlencode "pageSize=10"
+```
+
+별칭: `q`, `query`, `page`, `limit`도 허용된다.
+
+응답의 `response.docs[].doc`에서 주로 볼 필드:
+
+- `bookname` — 도서명
+- `authors` — 저자
+- `publisher` — 출판사
+- `publication_year` — 출판연도
+- `isbn13` — 상세/소장 조회에 쓸 ISBN
+
+### 3) Fetch book detail (`/v1/data4library/book-detail`)
+
+```bash
+curl -fsS --get "${BASE}/v1/data4library/book-detail" \
+  --data-urlencode "isbn13=9788971998557" \
+  --data-urlencode "loaninfoYN=Y"
+```
+
+- `loaninfoYN=Y`를 주면 upstream이 제공하는 인기 대출 지역·연령·대출건수 같은 추가 정보를 함께 요청한다.
+- 상세 응답이 비어 있으면 ISBN 오타, 미수집 도서, upstream 지연 가능성을 안내한다.
+
+### 4) Find libraries that hold a book (`/v1/data4library/libraries-by-book`)
+
+```bash
+curl -fsS --get "${BASE}/v1/data4library/libraries-by-book" \
+  --data-urlencode "isbn=9788971998557" \
+  --data-urlencode "region=11" \
+  --data-urlencode "pageNo=1" \
+  --data-urlencode "pageSize=10"
+```
+
+- `region`은 도서관 정보나루 지역코드다. 예: 서울특별시 코드가 필요한 경우 `11`처럼 숫자 코드를 사용한다.
+- `dtl_region`이 있으면 더 좁힌다.
+- 결과가 여러 개면 도서관명·주소·홈페이지·전화번호(응답에 있는 경우)를 요약해 보여 주고, 실시간 대출가능 여부는 별도 `book-exists`로 확인한다.
+
+### 5) Check one library's holding (`/v1/data4library/book-exists`)
+
+```bash
+curl -fsS --get "${BASE}/v1/data4library/book-exists" \
+  --data-urlencode "libraryCode=111001" \
+  --data-urlencode "isbn13=9788971998557"
+```
+
+- `hasBook`, `loanAvailable` 등 upstream 응답 필드를 그대로 해석한다.
+- 대출 가능 여부는 도서관 시스템 동기화 지연이 있을 수 있으므로, 최종 방문 전 도서관 홈페이지/전화 확인을 권한다.
+
+### 6) Optional: library list (`/v1/data4library/library-search`)
+
+```bash
+curl -fsS --get "${BASE}/v1/data4library/library-search" \
+  --data-urlencode "region=11" \
+  --data-urlencode "pageNo=1" \
+  --data-urlencode "pageSize=10"
+```
+
+## Summarize for the user
+
+- 도서명, 저자, 출판사, 출판연도, ISBN을 먼저 정리한다.
+- 소장 도서관 목록은 사용자의 지역·이동 가능성을 기준으로 상위 후보만 보여 준다.
+- JSON 전체를 길게 붙이지 말고, 필요한 필드와 다음 단계(상세 조회/소장 확인/도서관 선택)를 제안한다.
+
+## Upstream reference
+
+- 도서관 정보나루 Open API 활용방법: `https://www.data4library.kr/apiUtilization`
+
+## Failure modes
+
+- 프록시에 `DATA4LIBRARY_AUTH_KEY` 미설정 → `503` / `upstream_not_configured`
+- 키워드·ISBN·지역코드·도서관 코드 누락 → `400` / `bad_request`
+- ISBN 자리수 오류 → 하이픈을 제외한 ISBN-10(마지막 X 허용) 또는 ISBN-13으로 다시 요청
+- 도서관 코드/지역코드 불명확 — 사용자에게 후보를 보여 주고 선택 받기
+- Data4Library API 일시 장애·호출 제한·데이터 미수집
+
+## Notes
+
+- 기본 posture는 read-only 조회다. 예약, 대출, 개인정보 기반 도서관 로그인 자동화는 하지 않는다.
+- `DATA4LIBRARY_AUTH_KEY`는 프록시 서버 전용이다. 사용자 측에는 시크릿이 없다.
+- 프록시가 upstream `authKey`와 `format=json`을 주입하므로, 사용자가 넘긴 `authKey`/`format`은 신뢰하지 않는다.

package/skills/library-book-search/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "library-book-search",
+  "description": "Use when the user asks to search Korean library books, book details, library holdings, or whether a Korean public library owns a book via k-skill-proxy Data4Library routes. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
+  "profiles": [
+    "proxy",
+    "action:booking"
+  ],
+  "frontmatter": "name: library-book-search\ndescription: Use when the user asks to search Korean library books, book details, library holdings, or whether a Korean public library owns a book via k-skill-proxy Data4Library routes. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: utility\n  locale: ko-KR\n  phase: v1"
+}

package/skills/local-election-candidate-search/instruction.md

@@ -0,0 +1,77 @@
+# Local Election Candidate Search
+
+## What this skill does
+
+중앙선거관리위원회(NEC) 선거통계시스템의 공개 통합검색에서 후보자 이름을 조회하고, 지방선거 관련 후보자 이력만 기본으로 정리한다. 후보자명, 한자명, 생년월일/성별, 선거일, 선거명, 선거종류, 정당, 선거구, 득표, 직업, 학력, 경력 등을 반환한다.
+
+## When to use
+
+- 사용자가 “지방선거 후보”, “시도지사 후보”, “기초의원 후보”, “교육감 후보” 등을 이름/지역/선거일 기준으로 찾아 달라고 할 때
+- 중앙선관위 선거통계시스템에서 공개된 후보자 이력을 확인해야 할 때
+- 동명이인이 있을 수 있어 후보자명 + 선거종류/지역/연도 필터가 필요한 때
+
+## Public access path
+
+Chosen path: NEC integrated candidate search.
+
+- Entry page: `https://info.nec.go.kr/search/searchCandidate.xhtml`
+- Method: unauthenticated public `POST`
+- Required form field: `searchKeyword=<정확한 후보자 성명>`
+- Helper package: `local-election-candidate-search`
+
+Why this path: the visible NEC UI explicitly exposes candidate-name integrated search across recent and historical elections, and it returns the candidate result cards in server-rendered HTML. It is more stable than scraping per-election menu pages because it does not require selecting every city/town/constituency combo first.
+
+## Workflow
+
+1. Use the package CLI from this repository or installed workspace:
+
+```bash
+npx local-election-candidate-search 오세훈 --election 시도지사 --region 서울 --limit 5
+```
+
+2. Narrow ambiguous/homonym results:
+
+```bash
+npx local-election-candidate-search 김동연 --date 2014 --election 기초의원 --region 동작
+```
+
+3. Include non-local races only when the user asks for all NEC integrated-search matches:
+
+```bash
+npx local-election-candidate-search 이재명 --all --limit 20
+```
+
+## Inputs
+
+- Candidate name: exact Korean name; required.
+- `--election`: one of `시도지사`, `기초단체장`, `광역의원`, `기초의원`, `광역비례`, `기초비례`, `교육감`.
+- `--date` / `--year`: `YYYY`, `YYYYMMDD`, or `YYYY.MM.DD`.
+- `--region`: free text filter against parsed district/region text.
+- `--limit`: max rows, capped at 100.
+- `--all`: include non-local election results.
+
+## Outputs
+
+Return concise JSON. Each `items[]` row may include:
+
+- `name`, `hanja`, `birth_date`, `gender`
+- `election_date`, `election_name`, `election_code`, `election_type`
+- `party`, `district`, `votes`, `vote_share`, `elected`
+- `job`, `education`, `career[]`
+- upstream code fields such as `city_code`, `sgg_city_code`, `town_code`
+
+`summary.upstream_result_limit` shows the NEC row count requested before local client-side filters. Filtered searches request up to 100 upstream rows first, then apply exact-name matching, local/election/date/region filters, deduplication, and the final `--limit`.
+
+## Failure modes
+
+- `no candidate results`: NEC returned no matching card or filters removed all matches.
+- `unexpected NEC search HTML`: upstream may be in maintenance, NetFunnel queue, login/blocked state, or markup changed.
+- `NEC search page was capped`: filtered results are based on the maximum fetched page and may require upstream pagination for exhaustive coverage.
+- Homonyms: the same name can appear across many elections; always show election date/type/district and apply user-provided filters.
+- Future elections: candidate registration data may be incomplete until NEC publishes it.
+
+## Done when
+
+- Results are sourced from `info.nec.go.kr` public HTML.
+- Local-election filtering is applied unless the user requested `--all`.
+- Any warnings/failure modes are shown instead of silently claiming no results.

package/skills/local-election-candidate-search/skill.json

@@ -0,0 +1,8 @@
+{
+  "name": "local-election-candidate-search",
+  "description": "중앙선거관리위원회 선거통계시스템 공개 통합검색으로 한국 지방선거 후보자 정보를 이름/선거종류/지역 기준으로 조회한다.",
+  "profiles": [
+    "lookup"
+  ],
+  "frontmatter": "name: local-election-candidate-search\ndescription: 중앙선거관리위원회 선거통계시스템 공개 통합검색으로 한국 지방선거 후보자 정보를 이름/선거종류/지역 기준으로 조회한다.\nlicense: MIT\nmetadata:\n  category: civic\n  locale: ko-KR\n  phase: v1"
+}

package/skills/localdata-business-status/instruction.md

@@ -0,0 +1,64 @@
+# 지방행정 인허가 영업상태 조회 (동네 사업장)
+
+## What this skill does
+
+행정안전부 **지방행정 인허가데이터(LOCALDATA)**의 지역별 CSV를 `file.localdata.go.kr`에서 직접 받아, 동네 사업장의 영업상태를 조회한다.
+
+- 영업상태(영업/휴업/폐업), 상세영업상태, 인허가일자(업력), 폐업일자, 업태구분, 도로명/지번 주소, 데이터갱신시점
+- 인허가 업종 **208종 전체** 지원 — 한글명("약국", "숙박업", "일반음식점")으로 지정 가능
+
+전국 통파일이 업종당 수백 MB라 **시군구 단위 지역 지정**(`--region`)이 필요하다. 받은 파일은 1일 로컬 캐시한다.
+
+이 자료에는 **사업자등록번호가 수록되지 않는다.** 상호(사업장명) 문자열 일치 후보의 사실만 나열하며, 동명 상호 가능성은 사용자가 판단한다. 자료는 매일 갱신되며 2일 전 기준으로 현행화된다.
+
+## Design principles
+
+- 점수·등급·해석 라벨을 만들지 않는다. 조회된 사실 + 출처 + 조회시각만 담는다.
+- 인증 없이 동작하는 공개 파일 서버이므로 프록시를 거치지 않고 사용자 머신에서 직접 호출한다.
+
+## When to use
+
+- "제주시 ○○호텔 지금 영업 중이야? 오래된 곳이야?" — 사업자번호를 몰라도 상호+시군구로 조회
+- "이 동네 가게 폐업했어?", "이 식당 인허가가 언제야(업력)?"
+
+## Prerequisites
+
+- 인터넷 연결, `python3` (stdlib만 사용 — 추가 의존성 없음)
+- `scripts/localdata_business_status.py` helper
+- `data/localdata_industries.json`(업종 208종), `data/localdata_orgcodes.json`(지자체 245종)
+
+## Credential requirements
+
+- 없음. 무인증 공개 파일 다운로드다.
+
+## Inputs
+
+- `--name`: 상호(사업장명) — 필수
+- `--region`: 시군구 — 필수 (예: `제주제주시`, `서울종로구`, `경기수원시`)
+- `--industry`: 업종 slug 또는 한글명 (여러 번 지정 가능). 생략 시 일반음식점·휴게음식점·숙박업
+
+## Privacy boundary
+
+- 입력한 상호·지역은 LOCALDATA 파일 서버로 전송된다(다운로드 요청 파라미터).
+- 자료에 사업자등록번호가 없어 상호 문자열 매칭이며 동일성을 단정하지 않는다.
+
+## CLI examples
+
+```bash
+python3 localdata-business-status/scripts/localdata_business_status.py \
+  --name "호텔샬롬" --region 제주제주시 --industry 숙박업
+
+# 업종 여러 개
+python3 localdata-business-status/scripts/localdata_business_status.py \
+  --name "○○약국" --region 서울종로구 --industry 약국
+```
+
+## Failure modes
+
+- `unavailable` + 안내: 상호/지역 미입력, 지역·업종 특정 실패(후보 나열), 다운로드 실패 — 수동 확인 URL 제공.
+- 0건: 매치 없음 (`total_match_count: 0`).
+
+## Official surfaces
+
+- 인허가 영업상태: `https://file.localdata.go.kr/file/download/<업종slug>/info?orgCode=<지자체코드>` (무인증, Referer 필요, CP949 CSV)
+- 본체: <https://www.localdata.go.kr>

package/skills/localdata-business-status/scripts/localdata_business_status.py

@@ -0,0 +1,206 @@
+"""LOCALDATA (지방행정 인허가) business operating-status lookup (unauthenticated).
+
+행정안전부 지방행정 인허가데이터를 file.localdata.go.kr 지역별 CSV로 직접 받아
+동네 사업장(식당·카페·숙박·약국 등 인허가 업종 208종)의 영업/휴업/폐업 상태를
+조회한다. 인증키가 필요 없는 공개 파일 서버이므로 프록시를 거치지 않는다.
+
+The data does NOT contain business registration numbers, so this is a trade-name
+(사업장명) string match only — it cannot assert identity against a given number.
+전국 통파일이 업종당 수백 MB라 시군구 단위 파일을 받으려면 --region 이 필요하다.
+"""
+
+from __future__ import annotations
+
+import argparse
+import csv
+import datetime as dt
+import io
+import json
+import pathlib
+import sys
+import time
+import urllib.error
+import urllib.parse
+import urllib.request
+from typing import Any
+
+BASE = "https://file.localdata.go.kr"
+LANDING = f"{BASE}/file/general_restaurants/info"
+SOURCE = ("지방행정 인허가데이터(LOCALDATA) 업종별 영업상태 — 행정안전부 "
+          "(file.localdata.go.kr 지역별 CSV, 매일 갱신·2일 전 기준 현행화)")
+USER_AGENT = ("Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 "
+              "(KHTML, like Gecko) Chrome/126.0 Safari/537.36")
+KST = dt.timezone(dt.timedelta(hours=9))
+
+_DATA_DIR = pathlib.Path(__file__).resolve().parent.parent / "data"
+INDUSTRIES: dict = json.loads((_DATA_DIR / "localdata_industries.json").read_text(encoding="utf-8"))
+DEFAULT_INDUSTRIES = ("general_restaurants", "rest_cafes", "lodgings")
+
+RESULT_COLUMNS = ("사업장명", "영업상태명", "상세영업상태명", "인허가일자", "폐업일자",
+                  "업태구분명", "도로명주소", "지번주소", "데이터갱신시점")
+
+CACHE_DIR = pathlib.Path.home() / ".cache" / "k-skill" / "localdata-business-status"
+CACHE_TTL_SECONDS = 24 * 3600  # 원천이 일 단위 갱신이므로 1일 캐시
+
+IDENTITY_NOTE = ("인허가 자료에는 사업자등록번호가 수록되지 않아 입력 사업자번호와의 "
+                 "동일성은 확인할 수 없다 — 상호(사업장명) 문자열 일치 후보의 사실만 "
+                 "나열하며, 동명 상호 가능성은 사용자가 판단한다. 자료는 매일 갱신되며 "
+                 "2일 전 기준으로 현행화된다.")
+
+
+def _now_iso() -> str:
+    return dt.datetime.now(KST).isoformat(timespec="seconds")
+
+
+def _envelope(status: str, *, result: dict | None = None, note: str | None = None) -> dict:
+    return {
+        "source": SOURCE,
+        "looked_up_at": _now_iso(),
+        "status": status,
+        "result": result,
+        "origin": "unauthenticated-public",
+        "note": note,
+    }
+
+
+def org_codes() -> dict:
+    return json.loads((_DATA_DIR / "localdata_orgcodes.json").read_text(encoding="utf-8"))
+
+
+def resolve_industry(token: str) -> tuple[str | None, list[str]]:
+    """업종 지정 해석 — slug 정확 일치 또는 한글명 일치. (slug, 후보들)."""
+    token = token.strip()
+    if token in INDUSTRIES:
+        return token, [INDUSTRIES[token]]
+    squeezed = token.replace(" ", "")
+    exact = [(slug, nm) for slug, nm in INDUSTRIES.items()
+             if nm.replace(" ", "") == squeezed
+             or nm.split("_", 1)[-1].replace(" ", "") == squeezed]
+    if len(exact) == 1:
+        return exact[0][0], [exact[0][1]]
+    hits = exact or [(slug, nm) for slug, nm in INDUSTRIES.items()
+                     if squeezed in nm.replace(" ", "")]
+    if len(hits) == 1:
+        return hits[0][0], [hits[0][1]]
+    return None, [nm for _, nm in hits]
+
+
+def _resolve_region(region: str) -> tuple[str | None, list[str]]:
+    table = org_codes()
+    region = region.strip()
+    if region in table:
+        return table[region], [region]
+    squeezed = region.replace(" ", "")
+    hits = [nm for nm in table if squeezed in nm.replace(" ", "")]
+    if len(hits) == 1:
+        return table[hits[0]], hits
+    return None, hits
+
+
+def _fetch_csv(slug: str, org_code: str, *, opener: Any = None) -> str:
+    CACHE_DIR.mkdir(parents=True, exist_ok=True)
+    cache = CACHE_DIR / f"{slug}_{org_code}.csv"
+    if cache.exists() and time.time() - cache.stat().st_mtime < CACHE_TTL_SECONDS:
+        return cache.read_text(encoding="utf-8")
+    params = urllib.parse.urlencode({"orgCode": org_code})
+    request = urllib.request.Request(
+        f"{BASE}/file/download/{slug}/info?{params}",
+        headers={"User-Agent": USER_AGENT, "Referer": LANDING},
+        method="GET",
+    )
+    open_fn = opener or urllib.request.urlopen
+    with open_fn(request, timeout=120) as response:
+        status = getattr(response, "status", 200)
+        content_type = response.headers.get("Content-Type", "") if hasattr(response, "headers") else ""
+        if status != 200 or "csv" not in (content_type or ""):
+            raise RuntimeError(f"HTTP {status} ({content_type or '?'})")
+        text = response.read().decode("cp949", errors="replace")
+    cache.write_text(text, encoding="utf-8")
+    return text
+
+
+def _search_rows(csv_text: str, name: str) -> list[dict]:
+    needle = name.replace(" ", "")
+    out = []
+    for row in csv.DictReader(io.StringIO(csv_text)):
+        biz_name = (row.get("사업장명") or "").strip()
+        if needle and needle in biz_name.replace(" ", ""):
+            out.append({col: (row.get(col) or "").strip() for col in RESULT_COLUMNS})
+    return out
+
+
+def lookup(name: str, region: str, industries: list[str] | None = None, *, opener: Any = None) -> dict:
+    """인허가 영업상태 조회 — 상호+지역 필수 (자료에 사업자번호 없음)."""
+    if not (name or "").strip():
+        return _envelope("unavailable",
+                         note="인허가 자료에 사업자등록번호가 수록되지 않아 상호 없이 검색할 수 "
+                              "없습니다. --name 으로 상호를 지정하세요.")
+    if not (region or "").strip():
+        return _envelope("unavailable",
+                         note="전국 통파일이 업종당 수백 MB라 시군구 지역 지정이 필요합니다. "
+                              "--region 으로 지정하세요 (예: 제주제주시, 서울종로구, 경기수원시).")
+    name = name.strip()
+
+    code, hits = _resolve_region(region)
+    if code is None:
+        return _envelope("unavailable",
+                         note=(f"지역 '{region}' 특정 실패 — "
+                               + (f"후보 {len(hits)}곳: {', '.join(hits[:8])}. 하나로 지정하세요."
+                                  if hits else "등록 지자체명과 일치하지 않습니다 (예: 서울종로구).")))
+
+    selected, bad = [], []
+    for token in (industries or DEFAULT_INDUSTRIES):
+        slug, cand = resolve_industry(token)
+        if slug:
+            selected.append(slug)
+        else:
+            bad.append(f"'{token}'" + (f" (후보 {len(cand)}종: {', '.join(cand[:6])})" if cand
+                                       else " (일치 업종 없음)"))
+    if bad:
+        return _envelope("unavailable",
+                         note=(f"업종 특정 실패: {'; '.join(bad)}. slug 또는 한글명(예: 약국, "
+                               "일반음식점, 숙박업)으로 하나씩 지정하세요. 총 208종 지원."))
+
+    searched, failures = {}, []
+    try:
+        for slug in selected:
+            try:
+                rows = _search_rows(_fetch_csv(slug, code, opener=opener), name)
+                searched[slug] = {"industry": INDUSTRIES[slug], "match_count": len(rows), "matches": rows}
+            except (urllib.error.URLError, RuntimeError) as err:
+                failures.append(f"{INDUSTRIES[slug]}({type(err).__name__})")
+    except Exception as err:  # 경계 계약: 어떤 오류든 강등
+        return _envelope("unavailable", note=f"예상 외 오류({type(err).__name__}).")
+
+    if not searched:
+        return _envelope("unavailable",
+                         note=f"전 업종 다운로드 실패: {', '.join(failures)}. "
+                              f"수동 확인: https://www.localdata.go.kr")
+
+    result = {
+        "query": {"name": name, "region": hits[0], "org_code": code},
+        "industries_searched": searched,
+        "total_match_count": sum(v["match_count"] for v in searched.values()),
+        "identity_note": IDENTITY_NOTE,
+    }
+    note = (f"일부 업종 다운로드 실패: {', '.join(failures)}" if failures else None)
+    return _envelope("ok", result=result, note=note)
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(description="지방행정 인허가 영업상태 조회 (무인증)")
+    parser.add_argument("--name", required=True, help="상호(사업장명) — 필수")
+    parser.add_argument("--region", required=True, help="시군구 (예: 제주제주시, 서울종로구)")
+    parser.add_argument("--industry", action="append", dest="industries",
+                        help="업종 slug 또는 한글명(예: 약국, 숙박업). 여러 번 지정 가능. 생략 시 음식점·카페·숙박")
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = build_parser().parse_args(argv)
+    print(json.dumps(lookup(args.name, args.region, args.industries), ensure_ascii=False, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/skills/localdata-business-status/skill.json

@@ -0,0 +1,8 @@
+{
+  "name": "localdata-business-status",
+  "description": "지방행정 인허가데이터(LOCALDATA)로 동네 사업장(식당·카페·숙박·약국·미용실·학원 등 인허가 업종 208종)의 영업/휴업/폐업 상태, 인허가일자(업력), 폐업일자, 업태, 주소를 조회한다. 상호+시군구로 검색하며 인증키 불필요.",
+  "profiles": [
+    "lookup"
+  ],
+  "frontmatter": "name: localdata-business-status\ndescription: 지방행정 인허가데이터(LOCALDATA)로 동네 사업장(식당·카페·숙박·약국·미용실·학원 등 인허가 업종 208종)의 영업/휴업/폐업 상태, 인허가일자(업력), 폐업일자, 업태, 주소를 조회한다. 상호+시군구로 검색하며 인증키 불필요.\nlicense: MIT\nmetadata:\n  category: business\n  locale: ko-KR\n  phase: v1"
+}

package/skills/lotto-results/instruction.md

@@ -0,0 +1,80 @@
+# Lotto Results
+
+## What this skill does
+
+`k-lotto` 패키지로 동행복권 로또 최신 회차, 특정 회차, 상세 당첨 결과, 번호 대조를 처리한다.
+
+## When to use
+
+- "이번 주 로또 번호 뭐야"
+- "1210회 당첨번호 알려줘"
+- "내 번호가 몇 등인지 봐줘"
+
+## Prerequisites
+
+- Node.js 18+
+- 배포 후: `npm install -g k-lotto`
+- 실행 전: `export NODE_PATH="$(npm root -g)"`
+- 이 저장소에서 개발할 때: 루트에서 `npm install`
+
+## Inputs
+
+- 회차 번호 또는 "latest"
+- 선택 사항: 사용자가 가진 6개 번호
+
+## Workflow
+
+### 0. Install the package globally when missing
+
+`node -e 'require("k-lotto")'` 가 실패하면 다른 구현으로 우회하지 말고 전역 Node 패키지 설치를 먼저 시도한다.
+
+```bash
+npm install -g k-lotto
+export NODE_PATH="$(npm root -g)"
+```
+
+패키지가 없다는 이유로 HTML 파서를 다시 짜거나 다른 비공식 소스를 찾지 않는다.
+
+### 1. Get the latest round when needed
+
+```bash
+NODE_PATH="$(npm root -g)" node - <<'JS'
+const lotto = require("k-lotto");
+lotto.getLatestRound().then((round) => console.log(round));
+JS
+```
+
+### 2. Fetch result or detailed payout data
+
+```bash
+NODE_PATH="$(npm root -g)" node - <<'JS'
+const lotto = require("k-lotto");
+lotto.getDetailResult(1216).then((result) => console.log(JSON.stringify(result, null, 2)));
+JS
+```
+
+### 3. Check user's numbers when provided
+
+```bash
+NODE_PATH="$(npm root -g)" node - <<'JS'
+const lotto = require("k-lotto");
+lotto.checkNumber(1216, ["3", "10", "14", "15", "23", "24"])
+  .then((result) => console.log(JSON.stringify(result, null, 2)));
+JS
+```
+
+## Done when
+
+- 최신 또는 요청 회차의 번호가 확인되어 있다
+- 상세 요청이면 추첨일과 당첨금 분포가 정리되어 있다
+- 번호 대조 요청이면 일치 번호와 등수가 확인되어 있다
+
+## Failure modes
+
+- 최신 회차는 결과 페이지 HTML에서 읽기 때문에 upstream HTML 변경의 영향을 받을 수 있다
+- 상세 회차 정보는 동행복권 JSON 응답 스키마 변경의 영향을 받을 수 있다
+
+## Notes
+
+- 사용자 번호를 받아도 영구 저장하지 않는다
+- 조회 전용 스킬이다

package/skills/lotto-results/skill.json

@@ -0,0 +1,8 @@
+{
+  "name": "lotto-results",
+  "description": "Check Korean Lotto draw results, latest rounds, and ticket matches with the k-lotto npm package. Use when the user asks for winning numbers, payout details, or whether their numbers matched.",
+  "profiles": [
+    "lookup"
+  ],
+  "frontmatter": "name: lotto-results\ndescription: Check Korean Lotto draw results, latest rounds, and ticket matches with the k-lotto npm package. Use when the user asks for winning numbers, payout details, or whether their numbers matched.\nlicense: MIT\nmetadata:\n  category: utility\n  locale: ko-KR\n  phase: v1"
+}