@nomadamas/k-skill 0.1.0

package/skills/lovebug-report/instruction.md

@@ -0,0 +1,185 @@
+# Lovebug Report
+
+## What this skill does
+
+`러브버그.com`(`https://xn--2i0bt2q2wd1wb.com/`)의 공개 지도/제보 표면을 이용해 러브버그(붉은등우단털파리) 관련 지역 정보를 취득하고, 사용자가 제공한 현재 위치 좌표로 익명 제보를 제출한다.
+
+- 수도권 시·구별 러브버그 스코어와 최근 제보량을 조회한다.
+- 동/읍/면 단위 area snapshot을 함께 조회해 어느 동네 제보인지 좁힌다.
+- 사이트가 쓰는 익명 Supabase RPC 표면으로 제보를 보낸다.
+- 좌표가 선택한 구 밖이거나 정확도가 낮거나 오늘 이미 같은 익명 기기에서 제보한 경우 upstream 거절을 그대로 알린다.
+
+## When to use
+
+- "우리 동네 러브버그 많아?"
+- "중랑구 러브버그 현황 알려줘"
+- "러브버그 지도에서 동안구 제보량 확인해줘"
+- "현재 위치로 러브버그 많다고 제보해줘"
+
+## Prerequisites
+
+- 인터넷 연결
+- Node.js 18+
+- 이 저장소의 `lovebug-report` npm package 또는 동일 로직
+- 제보 제출 시: 사용자가 제공한 현재 좌표(`lng`, `lat`), GPS 정확도, 구 코드(`gu_code`), 안정적인 익명 device hash
+
+## Public access path discovered
+
+### Primary source: lovebug.com public map JSON
+
+- site: `https://xn--2i0bt2q2wd1wb.com/`
+- gu score: `GET https://xn--2i0bt2q2wd1wb.com/api/map/gu-score`
+- weekly report count: `GET https://xn--2i0bt2q2wd1wb.com/api/map/weekly-report-count`
+- cluster snapshot: `GET https://xn--2i0bt2q2wd1wb.com/api/map/clusters?level=sigungu&historicalYear=2026`
+- area snapshot: `GET https://xn--2i0bt2q2wd1wb.com/api/map/areas?historicalYear=2026&includePolygon=false`
+- boundary GeoJSON: `GET https://xn--2i0bt2q2wd1wb.com/api/map/boundaries?level=sigungu`
+
+Discovery result: the Next.js page loads these unauthenticated JSON endpoints directly. A live smoke on 2026-06-24 returned current `gu-score`, `weekly-report-count`, `clusters`, `areas`, and `boundaries` JSON.
+
+No `k-skill-proxy` route is used because these upstream surfaces are public and do not require an API key.
+
+### Anonymous report surface
+
+The site bundle calls Supabase RPC `submit_anonymous_report` for logged-out reporting:
+
+```http
+POST https://sewrbxfawkmusnyzjoab.supabase.co/rest/v1/rpc/submit_anonymous_report
+Content-Type: application/json
+apikey: <site anon key>
+Authorization: Bearer <site anon key>
+```
+
+Body:
+
+```json
+{
+  "p_gu_code": "11070",
+  "p_lng": 127.09,
+  "p_lat": 37.59,
+  "p_accuracy_m": 25,
+  "p_level": 2,
+  "p_device_hash": "stable-anonymous-device-id",
+  "p_context": "street",
+  "p_image_url": null,
+  "p_indoor": false
+}
+```
+
+Official level labels:
+
+| `p_level` | Label |
+| --- | --- |
+| `0` | 잠잠해요 |
+| `1` | 살짝 보임 |
+| `2` | 많아요 |
+| `3` | 매우 많아요 |
+
+Official context labels:
+
+| `p_context` | Label |
+| --- | --- |
+| `indoor` | 실내 |
+| `street` | 길거리 |
+| `park` | 공원 |
+| `transit` | 지하철·버스 |
+| `shop` | 상가 |
+| `other` | 기타 |
+
+## Workflow
+
+### 1. Resolve the region
+
+Use `searchLovebugRegions` first. It combines gu score and area snapshot rows.
+
+```js
+const { searchLovebugRegions } = require("lovebug-report")
+
+const result = await searchLovebugRegions({
+  query: "중랑",
+  includeAreas: true,
+  limit: 5
+})
+
+console.log(result.items)
+```
+
+CLI:
+
+```bash
+node packages/lovebug-report/src/cli.js search --query 중랑 --include-areas
+node packages/lovebug-report/src/cli.js list --limit 10
+node packages/lovebug-report/src/cli.js find --query 동안
+```
+
+Returned gu fields include:
+
+- `gu_code`, `gu_name`, `sido`
+- `score`, `score_label`, `level`, `level_label`, `advisory`
+- `counts.report`, `counts.report_24h`, `counts.spotted`, `counts.quiet`, `counts.low`, `counts.medium`, `counts.high`
+- `coordinates`
+- `areas[]` when `includeAreas` is enabled
+
+### 2. Answer conservatively
+
+State that the score is based on recent lovebug.com user reports, not government-certified pest density.
+
+Good answer shape:
+
+- 지역: `중랑구`
+- 러브버그 스코어: `77` / `엄청 많아요, 조심!`
+- 최근 제보: `14일 439건`, `24시간 105건`
+- 동네 detail: area rows that matched the query
+- 출처: `러브버그.com 공개 지도 JSON`
+
+### 3. Submit a report only when required inputs are known
+
+Do not invent coordinates or device hash. If the user asks to report but the automation environment has no current location, state that `lng`, `lat`, and GPS accuracy are required.
+
+```js
+const { reportLovebug } = require("lovebug-report")
+
+await reportLovebug({
+  guCode: "11070",
+  level: "많아요",
+  context: "길거리",
+  lng: 127.09,
+  lat: 37.59,
+  accuracyM: 25,
+  deviceHash: "stable-anonymous-device-id"
+})
+```
+
+CLI:
+
+```bash
+node packages/lovebug-report/src/cli.js report \
+  --gu-code 11070 \
+  --level 많아요 \
+  --context 길거리 \
+  --lng 127.09 \
+  --lat 37.59 \
+  --accuracy 25 \
+  --device-hash stable-anonymous-device-id
+```
+
+## Done when
+
+- Region status was fetched from `러브버그.com` public JSON.
+- Region ambiguity was resolved with `gu_code`/`gu_name` when needed.
+- Report submission used real current coordinates and the upstream RPC returned success.
+- Source URL and user-report nature were disclosed.
+
+## Failure modes
+
+- `ANON_DAILY_DUPLICATE`: the same anonymous device already reported that region today.
+- `OUTSIDE_GU_AREA`: supplied coordinates are outside `p_gu_code`.
+- `ACCURACY_TOO_LOW`: GPS accuracy is too low for the upstream validation.
+- Public Next.js/Supabase bundle keys, routes, table names, or RPC names can change.
+- The map is user-report-based and can lag or be noisy.
+- The site may add stricter rate limits, bot checks, login requirements, or image-upload restrictions.
+
+## Notes
+
+- No login, CAPTCHA bypass, queue bypass, or privileged workflow automation.
+- No `k-skill-proxy` because upstream is public and keyless from the user's machine.
+- Image upload is not handled by this skill; pass `imageUrl` only when a site-compatible image URL already exists.

package/skills/lovebug-report/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "lovebug-report",
+  "description": "러브버그.com 공개 지도 표면으로 수도권 시·구별 러브버그 출몰 지수·동네별 제보 현황을 조회하고, 사용자가 제공한 현재 좌표로 익명 러브버그 제보를 제출한다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
+  "profiles": [
+    "proxy",
+    "action:submission"
+  ],
+  "frontmatter": "name: lovebug-report\ndescription: 러브버그.com 공개 지도 표면으로 수도권 시·구별 러브버그 출몰 지수·동네별 제보 현황을 조회하고, 사용자가 제공한 현재 좌표로 익명 러브버그 제보를 제출한다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: local-info\n  locale: ko-KR\n  phase: v1"
+}

package/skills/market-kurly-search/instruction.md

@@ -0,0 +1,125 @@
+# Market Kurly Search
+
+## What this skill does
+
+마켓컬리 웹앱이 실제로 사용하는 **비로그인 검색/상품 상세 표면**을 사용해 아래 흐름을 처리한다.
+
+- 키워드로 상품 후보를 검색한다.
+- 현재 가격과 할인 여부를 확인한다.
+- 품절 여부와 배송 타입을 확인한다.
+- 상품 링크를 함께 반환한다.
+- **주문/장바구니 같은 액션은 하지 않는다. 조회형으로만 답한다.**
+
+## When to use
+
+- "마켓컬리에서 우유 얼마야?"
+- "컬리에서 딸기 검색해줘"
+- "이 상품 품절인지 보고 링크도 줘"
+- "지금 컬리 가격만 빠르게 보고 싶어"
+
+## When not to use
+
+- 주문/장바구니/결제까지 자동화해야 하는 경우
+- 주소 기반 배송 가능 여부나 회원 전용 가격을 확정해야 하는 경우
+- 로그인 세션이 필요한 개인화 추천/찜 정보를 조회해야 하는 경우
+
+## Prerequisites
+
+- 인터넷 연결
+- `node` 18+
+- 이 저장소의 `market-kurly-search` package 또는 동일 로직
+
+## Required inputs
+
+### 1. Ask for a product keyword if it is missing
+
+상품명 또는 검색어가 없으면 먼저 물어본다.
+
+- 권장 질문: `찾을 마켓컬리 상품명이나 검색어를 알려주세요. 예: 우유, 딸기, 닭가슴살`
+- 너무 넓으면: `검색어가 너무 넓어요. 브랜드나 용량까지 같이 알려주시면 가격 후보를 더 정확히 추릴 수 있어요.`
+
+### 2. Confirm which candidate they want when the query is ambiguous
+
+검색 결과가 여러 개면 상위 2~3개만 보여주고 다시 확인받는다.
+
+- 권장 질문: `후보가 여러 개예요. 아래 상품 중 어떤 상품 가격을 볼까요?`
+- 응답에는 상품명 + 현재 가격 + 품절 여부 + 링크를 같이 붙인다.
+
+## Official Market Kurly surfaces
+
+- search list: `https://api.kurly.com/search/v4/sites/market/normal-search?keyword=<keyword>&page=1`
+- search count: `https://api.kurly.com/search/v3/sites/market/normal-search/count?keyword=<keyword>&filters=&allow_replace=true`
+- product detail page: `https://www.kurly.com/goods/<productNo>`
+
+## Workflow
+
+### 1. Search by keyword first
+
+```js
+const { searchProducts } = require("market-kurly-search")
+
+const result = await searchProducts("우유")
+console.log(result.items.slice(0, 3))
+```
+
+검색 결과에서는 아래 필드를 우선 본다.
+
+- 상품명
+- 현재 가격 (`discountedPrice` 우선, 없으면 `salesPrice`)
+- 할인율
+- 품절 여부
+- 배송 타입
+- 상품 링크
+
+### 2. Use the count endpoint when the result set is broad
+
+```js
+const { countProducts } = require("market-kurly-search")
+
+const count = await countProducts("우유")
+console.log(count)
+```
+
+후보가 너무 많으면 `count` 를 먼저 보여 주고 검색어를 좁히라고 안내한다.
+
+### 3. Use the goods page detail as a fallback or follow-up lookup
+
+```js
+const { getProductDetail } = require("market-kurly-search")
+
+const detail = await getProductDetail(5063110)
+console.log(detail)
+```
+
+`goods/<productNo>` HTML 안의 `__NEXT_DATA__` 에서 상품명, 가격, 품절 여부, 배송 타입을 추출한다.
+
+### 4. Respond conservatively
+
+응답은 짧고 보수적으로 정리한다.
+
+- 상품명
+- 현재 가격
+- 필요하면 원가/할인가 여부
+- 품절 여부 또는 판매 가능 여부
+- 상품 링크
+- **가격/품절/노출 정보는 시점에 따라 달라질 수 있으니 조회 시각 기준 참고값이라고 분명히 말한다.**
+
+## Done when
+
+- 상품 키워드를 확인했다.
+- 검색 결과에서 후보와 현재 가격을 최소 1개 이상 반환했다.
+- 필요하면 상품 상세 페이지로 보조 확인했다.
+- 주문/장바구니 같은 범위 밖 액션은 하지 않았다.
+
+## Failure modes
+
+- 검색어가 너무 넓으면 후보가 과도하게 많아질 수 있다.
+- 가격/품절/배송 문구는 시점에 따라 달라질 수 있다.
+- 현재 확인한 표면은 **공식 개발자 Open API가 아니라 웹이 쓰는 공개 표면** 이므로 스키마가 바뀌면 깨질 수 있다.
+- 회원 전용/주소 전용 정보는 비로그인 조회만으로 확정할 수 없다.
+
+## Notes
+
+- 조회형 스킬이다.
+- 비로그인 공개 표면 우선 원칙을 유지한다.
+- 주문/장바구니/로그인 요구 기능은 시도하지 않는다.

package/skills/market-kurly-search/skill.json

@@ -0,0 +1,8 @@
+{
+  "name": "market-kurly-search",
+  "description": "로그인 없이 접근 가능한 마켓컬리 검색/상품 상세 표면으로 상품 후보, 현재 가격, 할인 여부, 품절 여부를 조회한다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
+  "profiles": [
+    "action:commerce"
+  ],
+  "frontmatter": "name: market-kurly-search\ndescription: 로그인 없이 접근 가능한 마켓컬리 검색/상품 상세 표면으로 상품 후보, 현재 가격, 할인 여부, 품절 여부를 조회한다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: retail\n  locale: ko-KR\n  phase: v1"
+}

package/skills/mfds-drug-safety/instruction.md

@@ -0,0 +1,86 @@
+# 의약품 안전 체크
+
+## What this skill does
+
+식약처 공식 OpenAPI를 **`k-skill-proxy` 경유**로 조회해 **의약품개요정보(e약은요)** 와 **안전상비의약품 정보**를 확인한다.
+
+하지만 사용자가 증상이나 복용 상황을 말하면 **바로 단정하지 말고 먼저 되묻는다.**
+
+- 본인/아이/임산부/고령자 여부
+- 어떤 약을 이미 먹었는지 / 지금 먹으려는지
+- 언제부터 얼마나 복용했는지
+- 현재 증상, 기저질환, 알레르기, 복용 중인 다른 약
+- red flag (`호흡곤란`, `의식저하`, `심한 발진`, `지속되는 구토/흉통`)
+
+red flag 가 있으면 API 조회보다 **즉시 119·응급실·의료진 연결**을 우선한다.
+
+## When to use
+
+- "이 약이랑 이 약 같이 먹어도 되니?"
+- "타이레놀 먹는 중인데 판콜 같이 먹어도 돼?"
+- "두드러기가 있는데 이 약 계속 먹어도 되나?"
+- "식약처 공식 약 정보로 효능/주의사항 확인해줘"
+
+## Prerequisites
+
+- 인터넷 연결
+- `python3`
+- 설치된 skill payload 안에 `scripts/mfds_drug_safety.py` helper 포함
+- `k-skill-proxy`의 `/v1/mfds/drug-safety/lookup` route가 있는 hosted/self-host 프록시에 접근 가능할 것
+
+## Credential requirements
+
+- 사용자 측 **필수** 시크릿 없음.
+- `KSKILL_PROXY_BASE_URL` — self-host·별도 프록시를 쓸 때만 설정. 비우면 기본 hosted `https://k-skill-proxy.nomadamas.org` 를 사용한다.
+- `DATA_GO_KR_API_KEY` 는 **프록시 운영 서버** 환경에만 둔다.
+
+## Mandatory interview first
+
+증상/복용상황이 언급되면 바로 결론을 말하지 말고 먼저 되묻는다.
+
+권장 첫 질문 예시:
+
+- `누가 복용하려는지(본인/아이/임산부/고령자), 이미 먹은 약 이름, 언제 얼마나 복용했는지, 지금 있는 증상을 먼저 알려주세요.`
+- `호흡곤란, 의식저하, 입술·혀 붓기, 심한 전신 발진이 있으면 즉시 119 또는 응급실로 가야 합니다.`
+
+## Official surfaces
+
+- 공공데이터포털 문서: `https://www.data.go.kr/data/15075057/openapi.do`
+- e약은요 endpoint: `https://apis.data.go.kr/1471000/DrbEasyDrugInfoService/getDrbEasyDrugList`
+- 공공데이터포털 문서: `https://www.data.go.kr/data/15097208/openapi.do`
+- 안전상비의약품 endpoint: `https://apis.data.go.kr/1471000/SafeStadDrugService/getSafeStadDrugInq`
+- 프록시 route: `GET /v1/mfds/drug-safety/lookup`
+
+## Workflow
+
+1. 증상/복용상황이 있으면 인터뷰를 먼저 진행한다.
+2. red flag 가 하나라도 있으면 즉시 응급 안내로 전환한다.
+3. 약 이름이 확인되면 `k-skill-proxy`의 `/v1/mfds/drug-safety/lookup` 으로 공식 정보를 조회한다.
+4. 효능, 사용법, 주의사항, 상호작용, 이상반응, 보관법을 짧게 정리한다.
+5. `같이 먹어도 되나?` 질문에는 공식 상호작용 문구만 근거로 제시하고, 최종 판단은 약사·의료진 확인이 필요하다고 명시한다.
+
+## CLI examples
+
+```bash
+python3 scripts/mfds_drug_safety.py interview \
+  --question "타이레놀이랑 판콜 같이 먹어도 되나요?" \
+  --symptoms "두드러기와 어지러움"
+```
+
+```bash
+python3 scripts/mfds_drug_safety.py lookup --item-name "타이레놀" --item-name "판콜"
+```
+
+## Response policy
+
+- 이 스킬은 **진단/처방/복용 지시**를 하지 않는다.
+- 공식 문서에 있는 효능/주의/상호작용 문구만 근거로 요약한다.
+- 상호작용 문구가 모호하거나 red flag 가 있으면 약사·의사 상담으로 넘긴다.
+- 증상이 있는 질문은 인터뷰 없이 바로 답하지 않는다.
+
+## Done when
+
+- 증상 또는 복용상황을 먼저 되물었다.
+- red flag 여부를 확인했다.
+- 프록시 route를 통해 공식 endpoint 조회 결과를 JSON으로 정리했다.
+- 최소한 제품명, 업체명, 효능/주의/상호작용이 포함된 요약을 제공했다.

package/skills/mfds-drug-safety/scripts/mfds_drug_safety.py

@@ -0,0 +1,184 @@
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import re
+import sys
+import urllib.error
+import urllib.parse
+import urllib.request
+from html import unescape
+from typing import Any
+
+PROXY_BASE_URL_ENV_VAR = "KSKILL_PROXY_BASE_URL"
+DEFAULT_PROXY_BASE_URL = "https://k-skill-proxy.nomadamas.org"
+PROXY_DOWN_MSG = "설정된 k-skill-proxy 서버가 응답하지 않습니다. 잠시 후 재시도하거나 운영자에게 문의하세요."
+PROXY_KEY_NOT_CONFIGURED_MSG = "k-skill-proxy에 필요한 API 키가 설정되어 있지 않습니다. 운영자에게 문의하세요."
+
+
+class ApiError(RuntimeError):
+    def __init__(self, message: str, *, status_code: int | None = None, url: str | None = None):
+        super().__init__(message)
+        self.status_code = status_code
+        self.url = url
+
+
+def summarize_text(value: Any) -> str:
+    if value is None:
+        return ""
+    text = unescape(str(value))
+    text = re.sub(r"<[^>]+>", " ", text)
+    text = re.sub(r"\s+", " ", text).strip()
+    return text
+
+
+def resolve_proxy_base_url(explicit_base_url: str | None = None, env: dict[str, str] | None = None) -> str:
+    env = env or os.environ
+    candidate = summarize_text(explicit_base_url or env.get(PROXY_BASE_URL_ENV_VAR))
+    if candidate.casefold() in {"off", "false", "0", "disable", "disabled", "none"}:
+        raise ValueError("KSKILL_PROXY_BASE_URL 가 비활성화되어 있습니다.")
+    if candidate and candidate != "replace-me":
+        return candidate.rstrip("/")
+    return DEFAULT_PROXY_BASE_URL
+
+
+def build_drug_interview(question: str | None = None, symptoms: str | None = None) -> dict[str, Any]:
+    return {
+        "domain": "drug",
+        "question": summarize_text(question),
+        "symptoms": summarize_text(symptoms),
+        "must_ask": [
+            "누가 복용하려는지 알려주세요. (본인/아이/임산부/고령자)",
+            "무슨 약을 이미 먹었거나 지금 먹으려는지, 제품명/성분명을 각각 알려주세요.",
+            "언제부터, 얼마나 자주, 한 번에 얼마나 복용했는지 알려주세요.",
+            "지금 있는 증상과 언제 시작됐는지 알려주세요.",
+            "복용 중인 약, 기저질환, 알레르기 여부를 알려주세요.",
+        ],
+        "red_flags": [
+            "호흡곤란 또는 숨쉬기 힘듦",
+            "의식저하, 실신, 혼동",
+            "입술·혀 붓기 또는 심한 전신 발진",
+            "지속되는 구토, 경련, 심한 흉통",
+        ],
+        "urgent_action": "red flag 가 하나라도 있으면 약 정보 조회보다 즉시 119·응급실·의료진 연결을 우선하세요.",
+        "policy": "이 helper 는 진단이나 복용 지시를 하지 않고, 공식 식약처 안전정보 확인 전에 반드시 되묻기 흐름을 제공합니다.",
+    }
+
+
+EASY_FIELD_MAP = {
+    "item_name": "item_name",
+    "company_name": "company_name",
+    "efficacy": "efficacy",
+    "how_to_use": "how_to_use",
+    "warnings": "warnings",
+    "cautions": "cautions",
+    "interactions": "interactions",
+    "side_effects": "side_effects",
+    "storage": "storage",
+    "item_seq": "item_seq",
+}
+
+SAFE_STAD_FIELD_MAP = {
+    "item_name": "item_name",
+    "company_name": "company_name",
+    "efficacy": "efficacy",
+    "how_to_use": "how_to_use",
+    "warnings": "warnings",
+    "cautions": "cautions",
+    "interactions": "interactions",
+    "side_effects": "side_effects",
+}
+
+
+def normalize_easy_drug_item(item: dict[str, Any]) -> dict[str, Any]:
+    normalized = {key: summarize_text(item.get(source_key)) for key, source_key in EASY_FIELD_MAP.items()}
+    normalized["source"] = "drug_easy_info"
+    return normalized
+
+
+def normalize_safe_stad_item(item: dict[str, Any]) -> dict[str, Any]:
+    normalized = {key: summarize_text(item.get(source_key)) for key, source_key in SAFE_STAD_FIELD_MAP.items()}
+    normalized["source"] = "safe_standby_medicine"
+    return normalized
+
+
+def read_json_response(request: urllib.request.Request | str) -> dict[str, Any]:
+    try:
+        with urllib.request.urlopen(request, timeout=30) as response:
+            return json.loads(response.read().decode("utf-8"))
+    except urllib.error.HTTPError as error:
+        body = error.read().decode("utf-8", errors="replace")
+        try:
+            payload = json.loads(body)
+        except json.JSONDecodeError:
+            payload = None
+        if error.code == 503 and isinstance(payload, dict) and payload.get("error") == "upstream_not_configured":
+            raise ApiError(PROXY_KEY_NOT_CONFIGURED_MSG, status_code=error.code, url=getattr(error, "url", None)) from error
+
+        if isinstance(payload, dict) and payload.get("message"):
+            raise ApiError(str(payload["message"]), status_code=error.code, url=getattr(error, "url", None)) from error
+        raise ApiError(
+            f"MFDS drug proxy request failed with HTTP {error.code}",
+            status_code=error.code,
+            url=getattr(error, "url", None),
+        ) from error
+    except urllib.error.URLError as error:
+        raise ApiError(f"{PROXY_DOWN_MSG} (상세: {error.reason})") from error
+
+
+def lookup_drugs(
+    item_names: list[str],
+    *,
+    limit: int = 5,
+    base_url: str | None = None,
+    request_json: Any = read_json_response,
+) -> dict[str, Any]:
+    resolved_base_url = resolve_proxy_base_url(base_url)
+    url = f"{resolved_base_url}/v1/mfds/drug-safety/lookup"
+    params: list[tuple[str, str]] = [("itemName", item_name) for item_name in item_names]
+    params.append(("limit", str(limit)))
+    query = urllib.parse.urlencode(params)
+    request = urllib.request.Request(
+        f"{url}?{query}",
+        headers={"Accept": "application/json", "User-Agent": "k-skill-mfds/1.0"},
+    )
+    return request_json(request)
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(description="MFDS drug-safety helper")
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    interview = subparsers.add_parser("interview", help="print the mandatory symptom follow-up interview")
+    interview.add_argument("--question", default="")
+    interview.add_argument("--symptoms", default="")
+
+    lookup = subparsers.add_parser("lookup", help="look up official MFDS drug safety records through k-skill-proxy")
+    lookup.add_argument("--item-name", action="append", required=True)
+    lookup.add_argument("--limit", type=int, default=5)
+    lookup.add_argument("--proxy-base-url")
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = build_parser().parse_args(argv)
+
+    if args.command == "interview":
+        print(json.dumps(build_drug_interview(question=args.question, symptoms=args.symptoms), ensure_ascii=False, indent=2))
+        return 0
+
+    if args.command == "lookup":
+        try:
+            payload = lookup_drugs(args.item_name, limit=args.limit, base_url=args.proxy_base_url)
+            print(json.dumps(payload, ensure_ascii=False, indent=2))
+            return 0
+        except (ValueError, ApiError) as error:
+            print(json.dumps({"error": str(error)}, ensure_ascii=False, indent=2), file=sys.stderr)
+            return 1
+
+    return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/skills/mfds-drug-safety/skill.json

@@ -0,0 +1,10 @@
+{
+  "name": "mfds-drug-safety",
+  "description": "식약처 공공 OpenAPI를 k-skill-proxy 경유로 조회하기 전에 증상·복용상황을 반드시 되묻는 인터뷰형 의약품 안전 체크 스킬.",
+  "profiles": [
+    "proxy",
+    "vault",
+    "lookup"
+  ],
+  "frontmatter": "name: mfds-drug-safety\ndescription: 식약처 공공 OpenAPI를 k-skill-proxy 경유로 조회하기 전에 증상·복용상황을 반드시 되묻는 인터뷰형 의약품 안전 체크 스킬.\nlicense: MIT\nmetadata:\n  category: public-health\n  locale: ko-KR\n  phase: v1"
+}