smart-web-mcp 0.9.1 → 0.10.0

package/CHANGELOG.md

@@ -8,6 +8,8 @@ The format is based on Keep a Changelog[^1] and this project uses SemVer.
 
 ### Added
 
+- 16 new Korean MCP tools: `kr_geeknews` (GeekNews RSS), `kr_subway` (서울 지하철 실시간 도착정보), `kr_weather` (기상청 단기예보), `kr_fine_dust` (에어코리아 미세먼지), `kr_stock` (KRX 주식), `kr_dart` (금감원 DART 전자공시), `kr_real_estate` (국토부 부동산 실거래가), `kr_drug_safety` (식약처 의약품 안전), `kr_food_safety` (식품안전나라), `kr_naver_news` (네이버 뉴스 검색), `kr_naver_shopping` (네이버 쇼핑 가격비교), `kr_coupang` (쿠팡 상품 키워드검색 + anti-bot 우회), `kr_spellcheck` (한국어 맞춤법 검사), `kr_zipcode` (우체국 우편번호 검색), `kr_law` (법망 한국 법령 검색), `kr_public_restroom` (공공데이터 공중화장실 조회). Most tools call the public k-skill-proxy endpoint; `kr_coupang` uses the Retention Corp hosted backend (a.retn.kr) to bypass Coupang anti-bot; `kr_dart` uses `API_K_DART` env var; `kr_public_restroom` uses the official nationwide CSV dataset.
+
 - `smartfetch` now recognizes Naver Map and Kakao Map place URLs as first-class targets and normalizes place metadata such as title, address, phone, hours, review counts, and canonical place links instead of treating them as generic map shells
 - `smartsearch` now has site-native public fallbacks for `site:reddit.com`, `site:github.com` repository discovery, and `site:npmjs.com` queries alongside the existing Velog, Stack Exchange, and Hacker News fallbacks
 - `smartfetch` now has first-class competitive-programming fetch coverage for BOJ, Codeforces, AtCoder, QOJ, and Jungol problem/profile-style pages, plus solved.ac profile normalization through the unofficial user APIs
@@ -28,6 +30,20 @@ The format is based on Keep a Changelog[^1] and this project uses SemVer.
 - `smart-web-dev` issue reporting now points at `jojo-labs/smart-web`, and the dev hot-reload runtime writes explicit ESM snapshot metadata before loading rebuilt `dist/*.js` modules
 - `initSettings` now writes `settings.json` through a temp file + rename so crashes during first-run or `--force` initialization cannot leave the runtime config truncated
 
+## [0.10.0](https://github.com/jojo-labs/smart-web/compare/v0.9.2...v0.10.0) (2026-04-25)
+
+
+### Features
+
+* **korea:** add 16 Korean MCP tools ([#122](https://github.com/jojo-labs/smart-web/issues/122)) ([42df840](https://github.com/jojo-labs/smart-web/commit/42df840f95fd820fc3da420ae6ec235f37cb28e4))
+
+## [0.9.2](https://github.com/jojo-labs/smart-web/compare/v0.9.1...v0.9.2) (2026-04-25)
+
+
+### CI / Release
+
+* make required PR verify match main checks ([#120](https://github.com/jojo-labs/smart-web/issues/120)) ([89920af](https://github.com/jojo-labs/smart-web/commit/89920aff2e6ba8caaebc42c6a2be2eb59471addf))
+
 ## [0.9.1](https://github.com/jojo-labs/smart-web/compare/v0.9.0...v0.9.1) (2026-04-25)
 
 

package/dist/korea/coupang.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Coupang product keyword search via Retention Corp hosted backend.
+ *
+ * Two execution paths (same as upstream coupang_partners library):
+ *   1. Operator path — COUPANG_ACCESS_KEY + COUPANG_SECRET_KEY both set.
+ *      Calls Coupang Partners API with local HMAC signing.
+ *      Not implemented here; use the Python library for that path.
+ *   2. Hosted fallback — keys absent or OPENCLAW_SHOPPING_FORCE_HOSTED=1.
+ *      Calls https://a.retn.kr/v1/public/assist with X-OpenClaw-Client-Id: openclaw-skill.
+ *      This path works without any credentials.
+ *
+ * This module implements the hosted fallback path only.
+ * For URL-based product pages (www.coupang.com/vp/products/...), the existing
+ * commerce provider in smartfetch handles fetching and anti-bot fallback.
+ *
+ * Affiliate disclosure: links from this endpoint are Retention Corp affiliate links
+ * (https://a.retn.kr/s/...). Disclose to users per the SKILL.md policy.
+ */
+export type CoupangProduct = {
+    title: string;
+    price?: string;
+    is_rocket: boolean;
+    url: string;
+    image_url?: string;
+    rating?: string;
+    review_count?: string;
+};
+export type CoupangResult = {
+    source: "coupang";
+    action: string;
+    query: string;
+    products: CoupangProduct[];
+    disclosure: string;
+    note: string;
+};
+export declare function runCoupang(options: {
+    action?: "search" | "rocket" | "budget" | "compare" | "goldbox";
+    query?: string;
+    maxPrice?: number;
+    limit?: number;
+    timeoutMs?: number;
+}): Promise<CoupangResult | {
+    ok: false;
+    message: string;
+}>;
+export declare function renderCoupang(result: CoupangResult): string;

package/dist/korea/coupang.js

@@ -0,0 +1,165 @@
+/**
+ * Coupang product keyword search via Retention Corp hosted backend.
+ *
+ * Two execution paths (same as upstream coupang_partners library):
+ *   1. Operator path — COUPANG_ACCESS_KEY + COUPANG_SECRET_KEY both set.
+ *      Calls Coupang Partners API with local HMAC signing.
+ *      Not implemented here; use the Python library for that path.
+ *   2. Hosted fallback — keys absent or OPENCLAW_SHOPPING_FORCE_HOSTED=1.
+ *      Calls https://a.retn.kr/v1/public/assist with X-OpenClaw-Client-Id: openclaw-skill.
+ *      This path works without any credentials.
+ *
+ * This module implements the hosted fallback path only.
+ * For URL-based product pages (www.coupang.com/vp/products/...), the existing
+ * commerce provider in smartfetch handles fetching and anti-bot fallback.
+ *
+ * Affiliate disclosure: links from this endpoint are Retention Corp affiliate links
+ * (https://a.retn.kr/s/...). Disclose to users per the SKILL.md policy.
+ */
+import { httpPost } from "./proxy-client.js";
+const RETN_BASE = (process.env["OPENCLAW_SHOPPING_BASE_URL"] || "https://a.retn.kr").replace(/\/$/, "");
+const RETN_ASSIST = `${RETN_BASE}/v1/public/assist`;
+const CLIENT_ID = process.env["OPENCLAW_SHOPPING_CLIENT_ID"] || "openclaw-skill";
+function parseProducts(raw) {
+    if (!Array.isArray(raw)) {
+        // Try text extraction if result is a string
+        if (typeof raw === "string") {
+            return parseProductsFromText(raw);
+        }
+        return [];
+    }
+    return raw.map((item) => {
+        const priceRaw = item["price"] ?? item["salePrice"];
+        return {
+            title: String(item["productName"] ?? item["title"] ?? item["name"] ?? ""),
+            is_rocket: Boolean(item["isRocket"] ?? item["rocket"] ?? false),
+            url: String(item["productUrl"] ?? item["url"] ?? item["link"] ?? ""),
+            ...(priceRaw !== undefined ? { price: String(priceRaw) } : {}),
+            ...(item["imageUrl"] ? { image_url: String(item["imageUrl"]) } : {}),
+            ...(item["rating"] !== undefined ? { rating: String(item["rating"]) } : {}),
+            ...(item["reviewCount"] !== undefined ? { review_count: String(item["reviewCount"]) } : {}),
+        };
+    }).filter((p) => p.title || p.url);
+}
+function parseProductsFromText(text) {
+    // Best-effort: extract JSON array from MCP content text
+    try {
+        const jsonMatch = text.match(/\[[\s\S]*\]/);
+        if (jsonMatch) {
+            const arr = JSON.parse(jsonMatch[0]);
+            if (Array.isArray(arr))
+                return parseProducts(arr);
+        }
+    }
+    catch {
+        // ignore
+    }
+    return [];
+}
+async function callRetentionAssist(tool, args, timeoutMs) {
+    const body = JSON.stringify({
+        jsonrpc: "2.0",
+        id: 1,
+        method: "tools/call",
+        params: { name: tool, arguments: args },
+    });
+    const result = await httpPost(RETN_ASSIST, body, {
+        "Content-Type": "application/json",
+        "X-OpenClaw-Client-Id": CLIENT_ID,
+        accept: "application/json",
+    }, timeoutMs);
+    if (!result.ok)
+        return { ok: false, message: result.message };
+    const envelope = result.data;
+    return envelope;
+}
+function extractProducts(envelope) {
+    const payload = envelope.data?.payload;
+    const resultContent = payload?.["result"]?.["content"];
+    if (Array.isArray(resultContent)) {
+        for (const block of resultContent) {
+            if (block["type"] === "text") {
+                const text = String(block["text"] ?? "");
+                const products = parseProductsFromText(text);
+                if (products.length > 0)
+                    return products;
+            }
+        }
+    }
+    if (envelope.data?.result)
+        return parseProducts(envelope.data.result);
+    return [];
+}
+export async function runCoupang(options) {
+    const { action = "search", query, maxPrice, limit = 10, timeoutMs = 20000 } = options;
+    const disclosure = "파트너스 활동을 통해 일정액의 수수료를 제공받을 수 있음";
+    const note = "가격·품절·배송 정보는 실시간으로 변동될 수 있습니다.";
+    if (action === "goldbox") {
+        const envelope = await callRetentionAssist("get_coupang_goldbox", { limit }, timeoutMs);
+        if (!envelope.ok)
+            return { ok: false, message: "message" in envelope ? envelope.message : "Coupang goldbox failed" };
+        const products = extractProducts(envelope);
+        return { source: "coupang", action: "goldbox", query: "골드박스 특가", products, disclosure, note };
+    }
+    if (!query)
+        return { ok: false, message: "검색어(query)가 필요합니다." };
+    let tool = "search_coupang_products";
+    const args = { keyword: query, limit };
+    if (action === "rocket") {
+        tool = "search_coupang_rocket";
+    }
+    else if (action === "budget" && maxPrice !== undefined) {
+        tool = "search_coupang_budget";
+        args["max_price"] = maxPrice;
+    }
+    else if (action === "compare") {
+        tool = "compare_coupang_products";
+        args["query"] = query;
+    }
+    const envelope = await callRetentionAssist(tool, args, timeoutMs);
+    if (!envelope.ok) {
+        const msg = "message" in envelope ? envelope.message : "Coupang search failed";
+        return { ok: false, message: msg };
+    }
+    const ev = envelope;
+    if (!ev.ok || !ev.data) {
+        return { ok: false, message: `Coupang hosted backend error: ${ev.error ?? "no data returned"}` };
+    }
+    const products = extractProducts(ev);
+    return { source: "coupang", action, query, products, disclosure, note };
+}
+export function renderCoupang(result) {
+    const lines = [
+        `# 쿠팡 ${result.action === "goldbox" ? "골드박스" : `"${result.query}"`}`,
+        result.action === "rocket" ? "_(로켓배송 전용)_" : "",
+        "",
+    ].filter((l) => l !== "");
+    if (result.products.length === 0) {
+        lines.push("검색 결과가 없습니다.");
+        lines.push("");
+    }
+    const rocket = result.products.filter((p) => p.is_rocket);
+    const normal = result.products.filter((p) => !p.is_rocket);
+    if (rocket.length > 0) {
+        lines.push("## 로켓배송");
+        for (const p of rocket.slice(0, 5)) {
+            lines.push(`- **${p.title}**${p.price ? ` — ${p.price}` : ""}`);
+            if (p.url)
+                lines.push(`  [보러가기](${p.url})`);
+        }
+        lines.push("");
+    }
+    if (normal.length > 0) {
+        lines.push("## 일반배송");
+        for (const p of normal.slice(0, 5)) {
+            lines.push(`- **${p.title}**${p.price ? ` — ${p.price}` : ""}`);
+            if (p.url)
+                lines.push(`  [보러가기](${p.url})`);
+        }
+        lines.push("");
+    }
+    lines.push(`_${result.disclosure}_`);
+    lines.push(`_${result.note}_`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=coupang.js.map

package/dist/korea/coupang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coupang.js","sourceRoot":"","sources":["../../src/korea/coupang.ts"],"names":[],"mappings":"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"}

package/dist/korea/dart.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 금감원 DART 전자공시 조회 — direct API, requires API_K_DART env var
+ * API base: https://opendart.fss.or.kr/api/
+ */
+export type DartDisclosure = {
+    corp_code: string;
+    corp_name: string;
+    stock_code: string;
+    corp_cls: string;
+    report_nm: string;
+    rcept_no: string;
+    flr_nm: string;
+    rcept_dt: string;
+    rm: string;
+};
+export type DartCompany = {
+    corp_code: string;
+    corp_name: string;
+    corp_name_eng?: string;
+    stock_code?: string;
+    ceo_nm?: string;
+    adres?: string;
+    est_dt?: string;
+    hm_url?: string;
+    induty_code?: string;
+    acc_mt?: string;
+};
+export type DartResult = {
+    source: "dart";
+    status: string;
+    message: string;
+    action: string;
+    data: Record<string, unknown>;
+};
+export declare function runDart(options: {
+    action: "search" | "company" | "financials" | "disclosures";
+    corp_code?: string;
+    corp_name?: string;
+    stock_code?: string;
+    bgn_de?: string;
+    end_de?: string;
+    bsns_year?: string;
+    reprt_code?: string;
+    fs_div?: "OFS" | "CFS";
+    pblntf_ty?: string;
+    page_no?: number;
+    page_count?: number;
+    timeoutMs?: number;
+}): Promise<DartResult | {
+    ok: false;
+    message: string;
+}>;
+export declare function renderDart(result: DartResult): string;

package/dist/korea/dart.js

@@ -0,0 +1,105 @@
+/**
+ * 금감원 DART 전자공시 조회 — direct API, requires API_K_DART env var
+ * API base: https://opendart.fss.or.kr/api/
+ */
+import { httpGet } from "./proxy-client.js";
+const DART_BASE = "https://opendart.fss.or.kr/api";
+function dartKey() {
+    return process.env["API_K_DART"] ?? null;
+}
+async function dartGet(endpoint, params, timeoutMs = 20000) {
+    const key = dartKey();
+    if (!key) {
+        return { ok: false, message: "API_K_DART 환경변수가 없습니다. https://opendart.fss.or.kr 에서 발급하세요." };
+    }
+    const url = new URL(`${DART_BASE}/${endpoint}`);
+    url.searchParams.set("crtfc_key", key);
+    for (const [k, v] of Object.entries(params)) {
+        if (v)
+            url.searchParams.set(k, v);
+    }
+    const result = await httpGet(url.toString(), {}, timeoutMs);
+    if (!result.ok)
+        return { ok: false, message: result.message };
+    const d = result.data;
+    if (d["status"] && d["status"] !== "000") {
+        return { ok: false, message: `DART API 오류: [${d["status"]}] ${String(d["message"] ?? "")}` };
+    }
+    return { ok: true, data: result.data };
+}
+export async function runDart(options) {
+    const { action, corp_code, bgn_de, end_de, bsns_year, reprt_code = "11011", fs_div = "CFS", pblntf_ty, page_no = 1, page_count = 10, timeoutMs = 20000, } = options;
+    if (action === "company") {
+        if (!corp_code)
+            return { ok: false, message: "corp_code가 필요합니다." };
+        const result = await dartGet("company.json", { corp_code }, timeoutMs);
+        if (!result.ok)
+            return result;
+        return { source: "dart", status: "000", message: "정상", action, data: result.data };
+    }
+    if (action === "financials") {
+        if (!corp_code)
+            return { ok: false, message: "corp_code가 필요합니다." };
+        if (!bsns_year)
+            return { ok: false, message: "bsns_year(사업연도)가 필요합니다." };
+        const result = await dartGet("fnlttSinglAcntAll.json", { corp_code, bsns_year, reprt_code, fs_div }, timeoutMs);
+        if (!result.ok)
+            return result;
+        return { source: "dart", status: "000", message: "정상", action, data: result.data };
+    }
+    // disclosures (list.json)
+    const today = new Date().toISOString().slice(0, 10).replace(/-/g, "");
+    const threeMonthsAgo = new Date(Date.now() - 90 * 24 * 60 * 60 * 1000).toISOString().slice(0, 10).replace(/-/g, "");
+    const params = {
+        bgn_de: bgn_de ?? threeMonthsAgo,
+        end_de: end_de ?? today,
+        page_no: String(page_no),
+        page_count: String(page_count),
+        sort: "date",
+        sort_mth: "desc",
+    };
+    if (corp_code)
+        params["corp_code"] = corp_code;
+    if (pblntf_ty)
+        params["pblntf_ty"] = pblntf_ty;
+    const result = await dartGet("list.json", params, timeoutMs);
+    if (!result.ok)
+        return result;
+    return { source: "dart", status: "000", message: "정상", action, data: result.data };
+}
+export function renderDart(result) {
+    if (result.action === "company") {
+        const d = result.data;
+        return [
+            `# DART 기업개황 — ${String(d["corp_name"] ?? "")}`,
+            d["corp_name_eng"] ? `영문명: ${String(d["corp_name_eng"])}` : "",
+            `종목코드: ${String(d["stock_code"] ?? "-")}`,
+            `대표자: ${String(d["ceo_nm"] ?? "-")}`,
+            `업종코드: ${String(d["induty_code"] ?? "-")}`,
+            `설립일: ${String(d["est_dt"] ?? "-")}`,
+            `결산월: ${String(d["acc_mt"] ?? "-")}월`,
+            d["adres"] ? `주소: ${String(d["adres"])}` : "",
+            d["hm_url"] ? `홈페이지: ${String(d["hm_url"])}` : "",
+            "",
+            "_금감원 DART 공시 데이터 기준 / 투자 조언 아님_",
+        ].filter((l) => l !== "").join("\n");
+    }
+    if (result.action === "financials") {
+        const list = (result.data["list"] ?? []);
+        const lines = ["# DART 재무제표", ""];
+        for (const item of list.slice(0, 20)) {
+            lines.push(`- **${String(item["account_nm"] ?? "")}**: ${String(item["thstrm_amount"] ?? "")}`);
+        }
+        lines.push("\n_금감원 DART 공시 데이터 기준 / 투자 조언 아님_");
+        return lines.join("\n");
+    }
+    // disclosures
+    const list = (result.data["list"] ?? []);
+    const lines = ["# DART 공시 목록", `총 ${String(result.data["total_count"] ?? "?")}건`, ""];
+    for (const item of list) {
+        lines.push(`- **${item.report_nm}** — ${item.corp_name} (${item.rcept_dt})`);
+    }
+    lines.push("\n_금감원 DART 공시 데이터 기준 / 투자 조언 아님_");
+    return lines.join("\n");
+}
+//# sourceMappingURL=dart.js.map

package/dist/korea/dart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dart.js","sourceRoot":"","sources":["../../src/korea/dart.ts"],"names":[],"mappings":"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"}

package/dist/korea/drug-safety.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Drug safety info (식약처 의약품) via k-skill-proxy
+ * Endpoint: GET /v1/mfds/drug-safety/lookup?itemName=타이레놀
+ *
+ * Policy: always surface red flags first. This tool returns data only.
+ * Do NOT use for emergency diagnosis — always refer to 119/응급실 when needed.
+ */
+export type DrugItem = {
+    item_name?: string;
+    entp_name?: string;
+    efcy_qesitm?: string;
+    use_method_qesitm?: string;
+    atpn_qesitm?: string;
+    intrc_qesitm?: string;
+    se_qesitm?: string;
+    deposit_method_qesitm?: string;
+    item_image?: string;
+    source?: string;
+};
+export type DrugSafetyResult = {
+    source: "drug-safety";
+    query: string[];
+    total: number;
+    items: DrugItem[];
+};
+export declare function runDrugSafety(options: {
+    itemNames: string[];
+    timeoutMs?: number;
+}): Promise<DrugSafetyResult | {
+    ok: false;
+    message: string;
+}>;
+export declare function renderDrugSafety(result: DrugSafetyResult): string;

package/dist/korea/drug-safety.js

@@ -0,0 +1,60 @@
+/**
+ * Drug safety info (식약처 의약품) via k-skill-proxy
+ * Endpoint: GET /v1/mfds/drug-safety/lookup?itemName=타이레놀
+ *
+ * Policy: always surface red flags first. This tool returns data only.
+ * Do NOT use for emergency diagnosis — always refer to 119/응급실 when needed.
+ */
+import { proxyGet } from "./proxy-client.js";
+export async function runDrugSafety(options) {
+    const { itemNames, timeoutMs = 20000 } = options;
+    if (!itemNames.length)
+        return { ok: false, message: "itemName이 필요합니다." };
+    const allItems = [];
+    for (const itemName of itemNames) {
+        const result = await proxyGet("/v1/mfds/drug-safety/lookup", { itemName }, timeoutMs);
+        if (!result.ok) {
+            if (allItems.length === 0)
+                return { ok: false, message: `Drug safety lookup failed: ${result.message}` };
+            continue;
+        }
+        const items = (result.data["items"] ?? result.data["list"] ?? [result.data]);
+        allItems.push(...items);
+    }
+    return {
+        source: "drug-safety",
+        query: itemNames,
+        total: allItems.length,
+        items: allItems,
+    };
+}
+export function renderDrugSafety(result) {
+    const lines = [
+        "⚠️ **이 정보는 참고용입니다. 최종 판단은 약사·의료진에게 확인하세요. 응급 증상(호흡곤란·의식저하·심한 발진)은 즉시 119.**",
+        "",
+        `# 의약품 안전 정보 — ${result.query.join(", ")}`,
+        `총 ${result.total}건`,
+        "",
+    ];
+    for (const item of result.items) {
+        lines.push(`## ${item.item_name ?? "?"}`);
+        if (item.entp_name)
+            lines.push(`- 제조사: ${item.entp_name}`);
+        if (item.efcy_qesitm)
+            lines.push(`\n**효능·효과**: ${item.efcy_qesitm}`);
+        if (item.use_method_qesitm)
+            lines.push(`\n**용법·용량**: ${item.use_method_qesitm}`);
+        if (item.atpn_qesitm)
+            lines.push(`\n**주의사항**: ${item.atpn_qesitm}`);
+        if (item.intrc_qesitm)
+            lines.push(`\n**상호작용**: ${item.intrc_qesitm}`);
+        if (item.se_qesitm)
+            lines.push(`\n**이상반응**: ${item.se_qesitm}`);
+        if (item.deposit_method_qesitm)
+            lines.push(`\n**보관법**: ${item.deposit_method_qesitm}`);
+        lines.push("");
+    }
+    lines.push("_식약처 e약은요 공식 데이터 기준_");
+    return lines.join("\n");
+}
+//# sourceMappingURL=drug-safety.js.map

package/dist/korea/drug-safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drug-safety.js","sourceRoot":"","sources":["../../src/korea/drug-safety.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAsB5C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAGnC;IACC,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,OAAO,CAAA;IAChD,IAAI,CAAC,SAAS,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAA;IAExE,MAAM,QAAQ,GAAe,EAAE,CAAA;IAC/B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAA0B,6BAA6B,EAAE,EAAE,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAA;QAC9G,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,8BAA8B,MAAM,CAAC,OAAO,EAAE,EAAE,CAAA;YACxG,SAAQ;QACV,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAe,CAAA;QAC1F,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAA;IACzB,CAAC;IAED,OAAO;QACL,MAAM,EAAE,aAAa;QACrB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,KAAK,EAAE,QAAQ;KAChB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,MAAM,KAAK,GAAG;QACZ,6EAA6E;QAC7E,EAAE;QACF,iBAAiB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC1C,KAAK,MAAM,CAAC,KAAK,GAAG;QACpB,EAAE;KACH,CAAA;IACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC,CAAA;QACzC,IAAI,IAAI,CAAC,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;QAC1D,IAAI,IAAI,CAAC,WAAW;YAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;QACpE,IAAI,IAAI,CAAC,iBAAiB;YAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAA;QAChF,IAAI,IAAI,CAAC,WAAW;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;QACnE,IAAI,IAAI,CAAC,YAAY;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,YAAY,EAAE,CAAC,CAAA;QACrE,IAAI,IAAI,CAAC,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;QAC/D,IAAI,IAAI,CAAC,qBAAqB;YAAE,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,qBAAqB,EAAE,CAAC,CAAA;QACtF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAChB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;IAClC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/korea/fine-dust.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Fine dust / air quality (에어코리아) via k-skill-proxy
+ * Proxy endpoint: GET /v1/fine-dust/report?regionHint=서울 강남구
+ */
+export type FineDustResult = {
+    source: "fine-dust";
+    station: string;
+    region_hint: string;
+    queried_at: string;
+    pm10: string;
+    pm10_grade: string;
+    pm25: string;
+    pm25_grade: string;
+    overall_grade: string;
+    retrieval_method: string;
+    candidate_stations?: string[];
+    ambiguous?: boolean;
+};
+export declare function runFineDust(options: {
+    regionHint?: string;
+    stationName?: string;
+    timeoutMs?: number;
+}): Promise<FineDustResult | {
+    ok: false;
+    message: string;
+}>;
+export declare function renderFineDust(result: FineDustResult): string;

package/dist/korea/fine-dust.js

@@ -0,0 +1,88 @@
+/**
+ * Fine dust / air quality (에어코리아) via k-skill-proxy
+ * Proxy endpoint: GET /v1/fine-dust/report?regionHint=서울 강남구
+ */
+import { proxyGet } from "./proxy-client.js";
+const GRADE_MAP = {
+    "1": "좋음",
+    "2": "보통",
+    "3": "나쁨",
+    "4": "매우나쁨",
+    good: "좋음",
+    normal: "보통",
+    bad: "나쁨",
+    very_bad: "매우나쁨",
+};
+function gradeLabel(raw) {
+    const s = String(raw ?? "");
+    return GRADE_MAP[s] ?? s;
+}
+export async function runFineDust(options) {
+    const { regionHint, stationName, timeoutMs = 15000 } = options;
+    const params = {};
+    if (stationName) {
+        params["stationName"] = stationName;
+    }
+    else if (regionHint) {
+        params["regionHint"] = regionHint;
+    }
+    else {
+        return { ok: false, message: "regionHint 또는 stationName이 필요합니다." };
+    }
+    const result = await proxyGet("/v1/fine-dust/report", params, timeoutMs);
+    if (!result.ok) {
+        return { ok: false, message: `Fine dust lookup failed: ${result.message}` };
+    }
+    const d = result.data;
+    // Ambiguous location — multiple candidates returned
+    if (d["ambiguous_location"] === true || d["candidate_stations"]) {
+        const candidates = d["candidate_stations"] ?? [];
+        return {
+            source: "fine-dust",
+            station: "",
+            region_hint: regionHint ?? stationName ?? "",
+            queried_at: new Date().toISOString(),
+            pm10: "",
+            pm10_grade: "",
+            pm25: "",
+            pm25_grade: "",
+            overall_grade: "",
+            retrieval_method: String(d["retrieval_method"] ?? ""),
+            candidate_stations: candidates,
+            ambiguous: true,
+        };
+    }
+    return {
+        source: "fine-dust",
+        station: String(d["stationName"] ?? d["station"] ?? ""),
+        region_hint: regionHint ?? stationName ?? "",
+        queried_at: String(d["dataTime"] ?? d["queried_at"] ?? new Date().toISOString()),
+        pm10: String(d["pm10Value"] ?? d["pm10"] ?? ""),
+        pm10_grade: gradeLabel(d["pm10Grade"] ?? d["pm10_grade"]),
+        pm25: String(d["pm25Value"] ?? d["pm25"] ?? ""),
+        pm25_grade: gradeLabel(d["pm25Grade"] ?? d["pm25_grade"]),
+        overall_grade: gradeLabel(d["khaiGrade"] ?? d["overall_grade"] ?? d["grade"]),
+        retrieval_method: String(d["retrieval_method"] ?? d["fallback"] ?? "proxy"),
+    };
+}
+export function renderFineDust(result) {
+    if (result.ambiguous) {
+        const lines = [`# 미세먼지 — 위치 확인 필요`, `"${result.region_hint}"에 해당하는 측정소가 여러 개입니다.`, ""];
+        lines.push("측정소 후보:");
+        for (const s of result.candidate_stations ?? [])
+            lines.push(`- ${s}`);
+        lines.push("\n`stationName` 파라미터로 위 중 하나를 지정해서 재조회하세요.");
+        return lines.join("\n");
+    }
+    const lines = [
+        `# 미세먼지 — ${result.station || result.region_hint}`,
+        `조회 시점: ${result.queried_at}`,
+        "",
+        `- PM10: ${result.pm10} μg/m³ (${result.pm10_grade})`,
+        `- PM2.5: ${result.pm25} μg/m³ (${result.pm25_grade})`,
+        `- 통합대기: **${result.overall_grade}**`,
+        `- 조회방식: ${result.retrieval_method}`,
+    ];
+    return lines.join("\n");
+}
+//# sourceMappingURL=fine-dust.js.map

package/dist/korea/fine-dust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fine-dust.js","sourceRoot":"","sources":["../../src/korea/fine-dust.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAiB5C,MAAM,SAAS,GAA2B;IACxC,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,IAAI;IACT,QAAQ,EAAE,MAAM;CACjB,CAAA;AAED,SAAS,UAAU,CAAC,GAAY;IAC9B,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAA;IAC3B,OAAO,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAIjC;IACC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,OAAO,CAAA;IAE9D,MAAM,MAAM,GAA2B,EAAE,CAAA;IACzC,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,CAAC,aAAa,CAAC,GAAG,WAAW,CAAA;IACrC,CAAC;SAAM,IAAI,UAAU,EAAE,CAAC;QACtB,MAAM,CAAC,YAAY,CAAC,GAAG,UAAU,CAAA;IACnC,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAA;IACpE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAA0B,sBAAsB,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;IACjG,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,4BAA4B,MAAM,CAAC,OAAO,EAAE,EAAE,CAAA;IAC7E,CAAC;IAED,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAA;IAErB,oDAAoD;IACpD,IAAI,CAAC,CAAC,oBAAoB,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAChE,MAAM,UAAU,GAAI,CAAC,CAAC,oBAAoB,CAA0B,IAAI,EAAE,CAAA;QAC1E,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,UAAU,IAAI,WAAW,IAAI,EAAE;YAC5C,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,IAAI,EAAE,EAAE;YACR,UAAU,EAAE,EAAE;YACd,IAAI,EAAE,EAAE;YACR,UAAU,EAAE,EAAE;YACd,aAAa,EAAE,EAAE;YACjB,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC;YACrD,kBAAkB,EAAE,UAAU;YAC9B,SAAS,EAAE,IAAI;SAChB,CAAA;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACvD,WAAW,EAAE,UAAU,IAAI,WAAW,IAAI,EAAE;QAC5C,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAChF,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC/C,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC;QACzD,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC/C,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC;QACzD,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;QAC7E,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC;KAC5E,CAAA;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,CAAC,mBAAmB,EAAE,IAAI,MAAM,CAAC,WAAW,uBAAuB,EAAE,EAAE,CAAC,CAAA;QACtF,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACrB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,kBAAkB,IAAI,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACrE,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAA;QACxD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IACD,MAAM,KAAK,GAAG;QACZ,YAAY,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,WAAW,EAAE;QAClD,UAAU,MAAM,CAAC,UAAU,EAAE;QAC7B,EAAE;QACF,WAAW,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,UAAU,GAAG;QACrD,YAAY,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,UAAU,GAAG;QACtD,aAAa,MAAM,CAAC,aAAa,IAAI;QACrC,WAAW,MAAM,CAAC,gBAAgB,EAAE;KACrC,CAAA;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}