korean-stats-mcp 1.4.0

package/dist/api/types.d.ts

@@ -0,0 +1,157 @@
+/**
+ * KOSIS OpenAPI 타입 정의
+ */
+export interface KosisApiResponse<T> {
+    err?: string;
+    errMsg?: string;
+    result?: T[];
+}
+export interface StatisticsListItem {
+    VW_CD: string;
+    VW_NM: string;
+    LIST_ID?: string;
+    LIST_NM?: string;
+    ORG_ID?: string;
+    TBL_ID?: string;
+    TBL_NM?: string;
+    STAT_ID?: string;
+    SEND_DE?: string;
+    REC_TBL_SE?: string;
+    UP_ID?: string;
+}
+export interface StatisticsDataItem {
+    ORG_ID: string;
+    TBL_ID: string;
+    TBL_NM: string;
+    C1?: string;
+    C1_OBJ_NM?: string;
+    C1_NM?: string;
+    C2?: string;
+    C2_OBJ_NM?: string;
+    C2_NM?: string;
+    C3?: string;
+    C3_OBJ_NM?: string;
+    C3_NM?: string;
+    C4?: string;
+    C4_OBJ_NM?: string;
+    C4_NM?: string;
+    C5?: string;
+    C5_OBJ_NM?: string;
+    C5_NM?: string;
+    C6?: string;
+    C6_OBJ_NM?: string;
+    C6_NM?: string;
+    C7?: string;
+    C7_OBJ_NM?: string;
+    C7_NM?: string;
+    C8?: string;
+    C8_OBJ_NM?: string;
+    C8_NM?: string;
+    ITM_ID: string;
+    ITM_NM: string;
+    ITM_NM_ENG?: string;
+    UNIT_ID?: string;
+    UNIT_NM: string;
+    UNIT_NM_ENG?: string;
+    PRD_SE: string;
+    PRD_DE: string;
+    DT: string;
+    LST_CHN_DE?: string;
+}
+export interface SearchResultItem {
+    ORG_ID: string;
+    ORG_NM: string;
+    TBL_ID: string;
+    TBL_NM: string;
+    STAT_ID: string;
+    STAT_NM: string;
+    VW_CD: string;
+    MT_ATITLE?: string;
+    FULL_PATH_ID?: string;
+    CONTENTS?: string;
+    STRT_PRD_DE?: string;
+    END_PRD_DE?: string;
+    ITEM03?: string;
+    REC_TBL_SE?: string;
+    TBL_VIEW_URL?: string;
+    LINK_URL?: string;
+    STAT_DB_CNT?: string;
+    QUERY?: string;
+}
+export interface StatisticsExplainItem {
+    STAT_ID: string;
+    STAT_NM: string;
+    STAT_KIND: string;
+    WRIT_PURPS: string;
+    EXAMIN_PD: string;
+    STAT_PERIOD: string;
+    MAIN_TERM_EXPL: string;
+    JOSA_NM: string;
+    CONTACT_DEPT_NM: string;
+}
+export interface StatisticsListParams {
+    method: 'getList';
+    apiKey: string;
+    vwCd: string;
+    parentListId?: string;
+    format: 'json';
+    jsonVD?: 'Y';
+}
+export interface StatisticsDataParams {
+    method: 'getList';
+    apiKey: string;
+    orgId: string;
+    tblId: string;
+    objL1?: string;
+    objL2?: string;
+    objL3?: string;
+    objL4?: string;
+    objL5?: string;
+    objL6?: string;
+    objL7?: string;
+    objL8?: string;
+    itmId?: string;
+    prdSe: string;
+    startPrdDe?: string;
+    endPrdDe?: string;
+    newEstPrdCnt?: number;
+    format: 'json';
+    jsonVD?: 'Y';
+}
+export interface SearchStatisticsParams {
+    method: 'getList';
+    apiKey: string;
+    searchNm: string;
+    orgId?: string;
+    sort?: 'RANK' | 'DATE';
+    startCount?: number;
+    resultCount?: number;
+    format: 'json';
+    content?: 'html' | 'json';
+}
+export interface SimplifiedStatisticsItem {
+    orgId: string;
+    orgName: string;
+    tableId: string;
+    tableName: string;
+    statisticsName?: string;
+    period: string;
+    periodType: string;
+    lastUpdated?: string;
+}
+export interface SimplifiedDataItem {
+    period: string;
+    value: string;
+    classification: string;
+    item: string;
+    unit: string;
+}
+export interface ListItem {
+    id: string;
+    name: string;
+    isTable: boolean;
+    orgId?: string;
+    tableId?: string;
+    tableName?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

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

package/dist/api/types.js

@@ -0,0 +1,5 @@
+/**
+ * KOSIS OpenAPI 타입 정의
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/cache/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 캐시 매니저
+ * 메모리 캐시를 사용하여 KOSIS API 호출을 최적화
+ */
+import NodeCache from 'node-cache';
+declare const TTL: {
+    readonly STATISTICS_LIST: number;
+    readonly STATISTICS_DATA: number;
+    readonly SEARCH_RESULTS: number;
+    readonly EXPLANATION: number;
+    readonly TABLE_META: number;
+};
+declare class CacheManager {
+    private cache;
+    constructor();
+    /**
+     * 캐시 키 생성
+     */
+    private generateKey;
+    /**
+     * 캐시에서 데이터 조회 또는 fetcher 실행
+     */
+    getOrFetch<T>(prefix: string, params: Record<string, unknown>, fetcher: () => Promise<T>, ttl?: number): Promise<T>;
+    /**
+     * 통계 목록 캐시
+     */
+    getStatisticsList<T>(params: Record<string, unknown>, fetcher: () => Promise<T>): Promise<T>;
+    /**
+     * 통계 데이터 캐시
+     */
+    getStatisticsData<T>(params: Record<string, unknown>, fetcher: () => Promise<T>): Promise<T>;
+    /**
+     * 검색 결과 캐시
+     */
+    getSearchResults<T>(params: Record<string, unknown>, fetcher: () => Promise<T>): Promise<T>;
+    /**
+     * 통계 설명 캐시
+     */
+    getExplanation<T>(params: Record<string, unknown>, fetcher: () => Promise<T>): Promise<T>;
+    /**
+     * 테이블 메타데이터 캐시
+     */
+    getTableMeta<T>(params: Record<string, unknown>, fetcher: () => Promise<T>): Promise<T>;
+    /**
+     * 캐시 통계
+     */
+    getStats(): NodeCache.Stats;
+    /**
+     * 캐시 초기화
+     */
+    flush(): void;
+}
+export declare function getCacheManager(): CacheManager;
+export { CacheManager, TTL };
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,SAAS,MAAM,YAAY,CAAC;AAInC,QAAA,MAAM,GAAG;;;;;;CAMC,CAAC;AAEX,cAAM,YAAY;IAChB,OAAO,CAAC,KAAK,CAAY;;IAWzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACG,UAAU,CAAC,CAAC,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,CAAC,CAAC;IAgBb;;OAEG;IACG,iBAAiB,CAAC,CAAC,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,CAAC,CAAC;IAIb;;OAEG;IACG,iBAAiB,CAAC,CAAC,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,CAAC,CAAC;IAIb;;OAEG;IACG,gBAAgB,CAAC,CAAC,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,CAAC,CAAC;IAIb;;OAEG;IACG,cAAc,CAAC,CAAC,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,CAAC,CAAC;IAIb;;OAEG;IACG,YAAY,CAAC,CAAC,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,CAAC,CAAC;IAIb;;OAEG;IACH,QAAQ;IAIR;;OAEG;IACH,KAAK;CAGN;AAKD,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC"}

package/dist/cache/index.js

@@ -0,0 +1,102 @@
+/**
+ * 캐시 매니저
+ * 메모리 캐시를 사용하여 KOSIS API 호출을 최적화
+ */
+import NodeCache from 'node-cache';
+import { config } from '../config/index.js';
+// 캐시 TTL 설정 (초 단위)
+const TTL = {
+    STATISTICS_LIST: 24 * 60 * 60, // 목록: 24시간
+    STATISTICS_DATA: 6 * 60 * 60, // 데이터: 6시간
+    SEARCH_RESULTS: 1 * 60 * 60, // 검색: 1시간
+    EXPLANATION: 7 * 24 * 60 * 60, // 설명: 7일
+    TABLE_META: 24 * 60 * 60, // 테이블 메타: 24시간
+};
+class CacheManager {
+    cache;
+    constructor() {
+        this.cache = new NodeCache({
+            stdTTL: config.cache.ttlHours * 60 * 60,
+            checkperiod: 600, // 10분마다 만료 체크
+            maxKeys: config.cache.maxKeys,
+            useClones: false, // 성능을 위해 복제 비활성화
+        });
+    }
+    /**
+     * 캐시 키 생성
+     */
+    generateKey(prefix, params) {
+        const sortedParams = Object.keys(params)
+            .sort()
+            .map((k) => `${k}=${JSON.stringify(params[k])}`)
+            .join('&');
+        return `${prefix}:${sortedParams}`;
+    }
+    /**
+     * 캐시에서 데이터 조회 또는 fetcher 실행
+     */
+    async getOrFetch(prefix, params, fetcher, ttl) {
+        const key = this.generateKey(prefix, params);
+        // 캐시에서 조회
+        const cached = this.cache.get(key);
+        if (cached !== undefined) {
+            return cached;
+        }
+        // API 호출 및 캐시 저장
+        const data = await fetcher();
+        this.cache.set(key, data, ttl ?? config.cache.ttlHours * 60 * 60);
+        return data;
+    }
+    /**
+     * 통계 목록 캐시
+     */
+    async getStatisticsList(params, fetcher) {
+        return this.getOrFetch('list', params, fetcher, TTL.STATISTICS_LIST);
+    }
+    /**
+     * 통계 데이터 캐시
+     */
+    async getStatisticsData(params, fetcher) {
+        return this.getOrFetch('data', params, fetcher, TTL.STATISTICS_DATA);
+    }
+    /**
+     * 검색 결과 캐시
+     */
+    async getSearchResults(params, fetcher) {
+        return this.getOrFetch('search', params, fetcher, TTL.SEARCH_RESULTS);
+    }
+    /**
+     * 통계 설명 캐시
+     */
+    async getExplanation(params, fetcher) {
+        return this.getOrFetch('explain', params, fetcher, TTL.EXPLANATION);
+    }
+    /**
+     * 테이블 메타데이터 캐시
+     */
+    async getTableMeta(params, fetcher) {
+        return this.getOrFetch('meta', params, fetcher, TTL.TABLE_META);
+    }
+    /**
+     * 캐시 통계
+     */
+    getStats() {
+        return this.cache.getStats();
+    }
+    /**
+     * 캐시 초기화
+     */
+    flush() {
+        this.cache.flushAll();
+    }
+}
+// 싱글톤 인스턴스
+let cacheInstance = null;
+export function getCacheManager() {
+    if (!cacheInstance) {
+        cacheInstance = new CacheManager();
+    }
+    return cacheInstance;
+}
+export { CacheManager, TTL };
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,46 @@
+import 'dotenv/config';
+export declare const config: {
+    readonly kosis: {
+        readonly apiKey: string;
+        readonly baseUrl: "https://kosis.kr/openapi";
+        readonly endpoints: {
+            readonly statisticsList: "/statisticsList.do";
+            readonly statisticsData: "/statisticsData.do";
+            readonly parameterData: "/Param/statisticsParameterData.do";
+            readonly searchStatistics: "/statisticsSearch.do";
+            readonly statsExplain: "/statsExplain.do";
+        };
+    };
+    readonly cache: {
+        readonly ttlHours: number;
+        readonly maxKeys: 1000;
+    };
+    readonly logLevel: string;
+    readonly viewCodes: {
+        readonly MT_ZTITLE: "국내통계 주제별";
+        readonly MT_OTITLE: "국내통계 기관별";
+        readonly MT_GTITLE01: "e-지방지표(주제별)";
+        readonly MT_GTITLE02: "e-지방지표(지역별)";
+        readonly MT_CHOSUN_TITLE: "광복이전통계(1908~1943)";
+        readonly MT_HANKUK_TITLE: "대한민국통계연감";
+        readonly MT_STOP_TITLE: "작성중지통계";
+        readonly MT_RTITLE: "국제통계";
+        readonly MT_BUKHAN: "북한통계";
+        readonly MT_TM1_TITLE: "대상별통계";
+        readonly MT_TM2_TITLE: "이슈별통계";
+        readonly MT_ETITLE: "영문 KOSIS";
+    };
+    readonly periodCodes: {
+        readonly D: "일";
+        readonly M: "월";
+        readonly Q: "분기";
+        readonly S: "반기";
+        readonly Y: "년";
+        readonly F: "다년(2년~10년)";
+        readonly IR: "부정기";
+    };
+};
+export declare function validateConfig(): void;
+export type ViewCode = keyof typeof config.viewCodes;
+export type PeriodCode = keyof typeof config.periodCodes;
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAKvB,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDT,CAAC;AAGX,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,MAAM,CAAC,SAAS,CAAC;AACrD,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,MAAM,CAAC,WAAW,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,54 @@
+import 'dotenv/config';
+// 우선순위: 환경변수 KOSIS_API_KEY > 내장 키 (배포 환경 친화)
+const DEFAULT_KOSIS_KEY = 'YThiNDdhYjYyMWZlMDA5NWI5NGI0Y2E0OWRiNjZiYTY=';
+export const config = {
+    // KOSIS API 설정
+    kosis: {
+        apiKey: process.env.KOSIS_API_KEY || DEFAULT_KOSIS_KEY,
+        baseUrl: 'https://kosis.kr/openapi',
+        endpoints: {
+            statisticsList: '/statisticsList.do',
+            statisticsData: '/statisticsData.do',
+            parameterData: '/Param/statisticsParameterData.do',
+            searchStatistics: '/statisticsSearch.do',
+            statsExplain: '/statsExplain.do',
+        },
+    },
+    // 캐시 설정
+    cache: {
+        ttlHours: parseInt(process.env.CACHE_TTL_HOURS || '6', 10),
+        maxKeys: 1000,
+    },
+    // 로그 레벨
+    logLevel: process.env.LOG_LEVEL || 'info',
+    // 서비스뷰 코드 (통계 분류 체계)
+    viewCodes: {
+        MT_ZTITLE: '국내통계 주제별',
+        MT_OTITLE: '국내통계 기관별',
+        MT_GTITLE01: 'e-지방지표(주제별)',
+        MT_GTITLE02: 'e-지방지표(지역별)',
+        MT_CHOSUN_TITLE: '광복이전통계(1908~1943)',
+        MT_HANKUK_TITLE: '대한민국통계연감',
+        MT_STOP_TITLE: '작성중지통계',
+        MT_RTITLE: '국제통계',
+        MT_BUKHAN: '북한통계',
+        MT_TM1_TITLE: '대상별통계',
+        MT_TM2_TITLE: '이슈별통계',
+        MT_ETITLE: '영문 KOSIS',
+    },
+    // 주기 코드
+    periodCodes: {
+        D: '일',
+        M: '월',
+        Q: '분기',
+        S: '반기',
+        Y: '년',
+        F: '다년(2년~10년)',
+        IR: '부정기',
+    },
+};
+// 설정 유효성 검사
+export function validateConfig() {
+    // 기본 API 키가 내장되어 있어 별도 검사 불필요
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAEvB,6CAA6C;AAC7C,MAAM,iBAAiB,GAAG,8CAA8C,CAAC;AAEzE,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,eAAe;IACf,KAAK,EAAE;QACL,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,iBAAiB;QACtD,OAAO,EAAE,0BAA0B;QACnC,SAAS,EAAE;YACT,cAAc,EAAE,oBAAoB;YACpC,cAAc,EAAE,oBAAoB;YACpC,aAAa,EAAE,mCAAmC;YAClD,gBAAgB,EAAE,sBAAsB;YACxC,YAAY,EAAE,kBAAkB;SACjC;KACF;IAED,QAAQ;IACR,KAAK,EAAE;QACL,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,GAAG,EAAE,EAAE,CAAC;QAC1D,OAAO,EAAE,IAAI;KACd;IAED,QAAQ;IACR,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;IAEzC,qBAAqB;IACrB,SAAS,EAAE;QACT,SAAS,EAAE,UAAU;QACrB,SAAS,EAAE,UAAU;QACrB,WAAW,EAAE,aAAa;QAC1B,WAAW,EAAE,aAAa;QAC1B,eAAe,EAAE,mBAAmB;QACpC,eAAe,EAAE,UAAU;QAC3B,aAAa,EAAE,QAAQ;QACvB,SAAS,EAAE,MAAM;QACjB,SAAS,EAAE,MAAM;QACjB,YAAY,EAAE,OAAO;QACrB,YAAY,EAAE,OAAO;QACrB,SAAS,EAAE,UAAU;KACb;IAEV,QAAQ;IACR,WAAW,EAAE;QACX,CAAC,EAAE,GAAG;QACN,CAAC,EAAE,GAAG;QACN,CAAC,EAAE,IAAI;QACP,CAAC,EAAE,IAAI;QACP,CAAC,EAAE,GAAG;QACN,CAAC,EAAE,YAAY;QACf,EAAE,EAAE,KAAK;KACD;CACF,CAAC;AAEX,YAAY;AACZ,MAAM,UAAU,cAAc;IAC5B,8BAA8B;AAChC,CAAC"}

package/dist/data/quickStatsParams.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Quick Stats 정적 파라미터 매핑
+ * - curl로 다운받은 메타데이터를 분석하여 생성
+ * - 동적 조회 대신 미리 검증된 파라미터 사용
+ */
+export interface QuickStatsParam {
+    orgId: string;
+    tableId: string;
+    tableName: string;
+    description: string;
+    objL1: string;
+    objL2?: string;
+    itemId: string;
+    unit: string;
+    regionCodes?: Record<string, string>;
+    supportedPeriods?: ('Y' | 'Q' | 'M')[];
+    isProjection?: boolean;
+}
+/** 인구동향/출산율/혼인율 등에서 사용하는 지역 코드 */
+export declare const REGION_CODES_DEMOGRAPHIC: Record<string, string>;
+/** 인구(주민등록)에서 사용하는 지역 코드 */
+export declare const REGION_CODES_POPULATION: Record<string, string>;
+/** 물가지수에서 사용하는 지역 코드 */
+export declare const REGION_CODES_CPI: Record<string, string>;
+/** 주택/아파트 가격지수에서 사용하는 지역 코드 */
+export declare const REGION_CODES_HOUSING: Record<string, string>;
+/** PM2.5 미세먼지 지역 코드 (환경부 테이블) */
+export declare const REGION_CODES_PM25: Record<string, string>;
+/** PM10 미세먼지 지역 코드 (환경부 테이블) */
+export declare const REGION_CODES_PM10: Record<string, string>;
+/**
+ * 검증된 Quick Stats 파라미터
+ * - 2024년 기준 KOSIS API 메타데이터에서 추출
+ */
+export declare const QUICK_STATS_PARAMS: Record<string, QuickStatsParam>;
+/**
+ * 자연어 별칭 → 정식 키워드 매핑
+ *
+ * 설계 (korean-law-mcp의 LAW_ALIAS_ENTRIES 패턴 차용):
+ *   - 공무원 보고서·민원 응답·연설문에서 흔히 등장하는 구어체/줄임말 포괄
+ *   - 영문(소문자)도 동일 dict (영문은 lowercase로 정규화)
+ *   - 률↔율 오타 보정은 BASIC_TYPO_MAP이 별도 담당
+ */
+export declare const KEYWORD_ALIASES: Record<string, string>;
+/**
+ * 자주 발생하는 오타·표기 변형 → 정식 키워드 매핑
+ * (korean-law-mcp의 BASIC_CHAR_MAP 패턴 차용 — 키워드 단위로 확장)
+ *
+ * 주요 케이스:
+ *   - 률/율 받침 규칙 위반 (출산률, 고용율, 이혼률 등)
+ *   - 공백·중점 변형 (이미 normalizeKeywordKey가 제거하나 명시 매핑도 둠)
+ */
+declare const BASIC_TYPO_MAP: Record<string, string>;
+/**
+ * 키워드 정규화 키 (공백 제거 + 소문자 + 일부 특수문자 제거)
+ *
+ * 정규화 후 동등 비교에 사용. 비교용으로만 사용 — 사용자 입력 자체를 바꾸지 않음.
+ */
+declare function normalizeKeywordKey(value: string): string;
+/** 정규화 키 → 정식 키워드 lookup (사전 빌드) */
+declare const KEYWORD_LOOKUP: Map<string, string>;
+export { normalizeKeywordKey, KEYWORD_LOOKUP, BASIC_TYPO_MAP };
+/**
+ * 키워드 조회 — 정확/별칭/정규화/오타 모두 시도
+ *
+ * 우선순위:
+ *   1. 정확 매칭 (사용자 입력 그대로)
+ *   2. 별칭 매핑 (대소문자 변형 포함)
+ *   3. 정규화 매칭 (공백·소문자·특수문자 무시 + 오타 교정)
+ */
+export declare function getQuickStatsParam(keyword: string): QuickStatsParam | undefined;
+/**
+ * 지역 코드 조회
+ */
+export declare function getRegionCode(param: QuickStatsParam, regionName: string): string;
+//# sourceMappingURL=quickStatsParams.d.ts.map

package/dist/data/quickStatsParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickStatsParams.d.ts","sourceRoot":"","sources":["../../src/data/quickStatsParams.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IAEpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,gBAAgB,CAAC,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC;IAEvC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAKD,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmB3D,CAAC;AAEF,4BAA4B;AAC5B,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmB1D,CAAC;AAEF,wBAAwB;AACxB,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBnD,CAAC;AAEF,+BAA+B;AAC/B,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBvD,CAAC;AAEF,iCAAiC;AACjC,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBpD,CAAC;AAEF,gCAAgC;AAChC,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBpD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CA2/B9D,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0GlD,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgB1C,CAAC;AAEF;;;;GAIG;AACH,iBAAS,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED,oCAAoC;AACpC,QAAA,MAAM,cAAc,qBAA4B,CAAC;AAajD,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AAE/D;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAuB/E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAKhF"}