korean-stats-mcp 1.4.1 → 1.6.0

package/README.md

@@ -10,7 +10,7 @@
 
 ---
 
-## v1.4 — 자연어 약어·오타·공백 정규화 + 체인 도구
+## v1.6 — 자치구·시군 230+ 정밀 라우팅 + 자연어 정규화 + 체인 도구
 
 **LLM이 통계청 수치를 학습 시점으로 답하는 문제를 끝낸다.** 매 질문마다 KOSIS 공식 DB를 직접 조회.
 
@@ -56,7 +56,7 @@
 "제주 인구"           → 664,792명
 ```
 
-자치구·시군 230+개도 인식합니다. KOSIS OpenAPI는 광역시도 단위까지만 지원하므로, 자치구 입력 시 **소속 광역시도로 자동 fallback** + 자치구 단위 정밀 조회 경로(`fetch_kosis_excel`) 안내가 함께 나옵니다. 동명 자치구(`중구`, `남구` 등)는 광역시 컨텍스트가 같이 있으면 정확히 disambiguate.
+전국 230+ 자치구·시군도 **정밀 라우팅**합니다. `광진구 인구`, `해운대구 고용률`, `수원시 사망률`처럼 자치구를 입력하면 KOSIS 자치구 단위 통계표(14종)로 직접 조회해 정확한 수치를 돌려줍니다 — 인구·출산·고령인구·의사수·아파트/전세가격·고용률·취업자·실업률·사망자수·사망률·혼인(건수·율)·이혼(건수·율). 자치구 통계연보(`.xlsx`)가 있으면 그쪽을 우선 쓰고, 없으면 KOSIS OpenAPI 자치구 코드로 라우팅합니다. 매핑이 없거나 KOSIS가 자치구 데이터를 미수록한 경우에만 소속 광역시도로 fallback + 안내합니다. 동명 자치구(`중구`, `남구` 등)는 광역시 컨텍스트가 같이 있으면 정확히 disambiguate.
 
 ### 시계열 추세 + 자연어 기간 추출
 
@@ -141,7 +141,7 @@ Claude Desktop / Cursor / Windsurf 설정 파일에 추가.
 
 ### 방법 3: 로컬 설치 (오프라인 가능)
 
-**사전 준비:** [Node.js](https://nodejs.org) 20 이상.
+**사전 준비:** [Node.js](https://nodejs.org) 20 이상 · [KOSIS OpenAPI 키](https://kosis.kr/openapi/) (무료 발급).
 
 ```bash
 git clone https://github.com/chrisryugj/korean-stats-mcp.git
@@ -150,14 +150,15 @@ pnpm install
 pnpm run build
 ```
 
-AI 앱 설정:
+AI 앱 설정 (`KOSIS_API_KEY`에 발급받은 키 입력):
 
 ```json
 {
   "mcpServers": {
     "korean-stats": {
       "command": "node",
-      "args": ["/absolute/path/korean-stats-mcp/dist/index.js"]
+      "args": ["/absolute/path/korean-stats-mcp/dist/index.js"],
+      "env": { "KOSIS_API_KEY": "발급받은_키" }
     }
   }
 }
@@ -221,13 +222,29 @@ GDP, 국내총생산, 경제성장률, GDP성장률, 물가, 소비자물가,
 ## 지역 라우팅
 
 - **17개 광역시도** — 서울, 부산, 대구, 인천, 광주, 대전, 울산, 세종, 경기, 강원, 충북, 충남, 전북, 전남, 경북, 경남, 제주 (풀네임·약칭 모두 인식)
-- **자치구·시군 230+** — 자동으로 소속 광역시도로 fallback + 자치구 단위 정밀 조회 경로 안내
+- **자치구·시군 230+ 정밀 라우팅** — 자치구 통계연보(`.xlsx`) 또는 KOSIS 자치구 단위 통계표(14종)로 직접 조회. 커버 분야: 인구·출산·고령인구·의사수·아파트/전세가격·고용률·취업자·실업률·사망자수·사망률·혼인·이혼
+- **fallback** — 매핑이 없거나 KOSIS가 자치구 데이터를 미수록한 경우에만 소속 광역시도로 대체 + 안내
 - **동명 자치구 disambiguate** — `중구`, `남구`, `동구` 등은 광역시 컨텍스트가 같이 있으면 정확히 매칭
 
 ---
 
 ## 변경 이력
 
+<details>
+<summary>v1.6 — 자치구 고용·인구동태 정밀 라우팅 확장</summary>
+
+**자치구 단위 OpenAPI 라우팅 14개 분야로 확장**
+- 고용 — `DT_1ES3A03_A01S` (고용률·취업자, objL2 연령 코드)
+- 실업 — `DT_1ES3A01S` (실업률·실업자·경제활동인구)
+- 인구동태 — `INH_1B82A01`(사망자수) · `INH_1B80A18`(사망률) · `INH_1B83A35`(혼인건수) · `INH_1B85033`(이혼건수) · `INH_1B8000I_01`(조이혼율) · `INH_1B8000I_02`(조혼인율)
+- `getDistrictKscdCodeFor` — UP_ITM_ID 없는 메타(고용 통계표) 대응: "서울 광진구" 결합형 / "수원시" 단일형 직접 인덱스 + 동명 시군(고성군) ambiguous 처리
+- `DistrictOpenApiRoute` — `objL2`(보조 분류) · `districtObjLevel`/`extraObjL1`(자치구 코드 objLevel swap) 옵션 추가
+- 통계연보(`.xlsx`) value 추출 실패 시 OpenAPI 라우팅으로 fall-through
+- KOSIS 자치구 데이터 미수록(`-`) 시 광역 fallback로 degrade
+- 시뮬레이션 108 케이스 100% 통과 (전국 자치구 정밀값)
+
+</details>
+
 <details>
 <summary>v1.4 — 자연어 정규화 + 체인 도구 + 통폐합</summary>
 
@@ -279,7 +296,7 @@ GDP, 국내총생산, 경제성장률, GDP성장률, 물가, 소비자물가,
 ## 주요 특징
 
 - **91개 키워드 + 100+ 자연어 별칭** — 줄임말·률/율 오타·공백 변형 자동 정규화
-- **17개 시도 + 자치구·시군 230+** — 자치구는 광역시도로 자동 fallback + 정밀 조회 경로 안내
+- **17개 시도 + 자치구·시군 230+ 정밀 라우팅** — 자치구 통계연보(`.xlsx`) 또는 KOSIS 자치구 단위 통계표(14종)로 직접 조회, 미수록 시에만 광역 fallback
 - **체인 도구 3종** — 단일 지역 13지표 한장 브리핑, N지역×M지표 매트릭스(전국 17개 동시), 7개 정책 영역 시계열
 - **자연어 기간 추출** — "민선 4기", "임기 4년차", "작년 대비", "역대" 자동 환산
 - **장래추계 안내** — 노령화지수 등 추계 데이터는 `isProjection: true` + "추계" 명시 안내

package/dist/api/client.d.ts

@@ -15,7 +15,12 @@ export declare class KosisClient {
     private apiKey;
     constructor(apiKey?: string);
     /**
-     * API 요청 실행
+     * API 요청 실행 (timeout 15s + 3회 재시도 + 지수 백오프)
+     *
+     * - Fly Singapore → KOSIS Korea cold path 일시 abort 대응
+     * - KOSIS 응답 에러(err/errMsg 필드)는 영구 실패 → 즉시 throw, retry 안 함
+     * - HTTP 4xx도 영구 실패 → 즉시 throw
+     * - 네트워크 오류·타임아웃·5xx만 retry (800ms / 1600ms 백오프)
      */
     private request;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AAEpB,cAAM,aAAc,SAAQ,KAAK;IAEtB,IAAI,EAAE,MAAM;IAEZ,aAAa,CAAC,EAAE,KAAK;gBAFrB,IAAI,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACR,aAAa,CAAC,EAAE,KAAK,YAAA;CAK/B;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM;IAK3B;;OAEG;YACW,OAAO;IAyErB;;OAEG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,YAAY,GAAE,MAAW,GACxB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAWhC;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE;QAC9B,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAUjC;;;OAGG;IACG,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GACA,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAW9B;;OAEG;IACG,oBAAoB,CACxB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IASpC;;;;;OAKG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAgB,GAClE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CAQrC;AAKD,wBAAgB,cAAc,IAAI,WAAW,CAK5C;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AAEpB,cAAM,aAAc,SAAQ,KAAK;IAEtB,IAAI,EAAE,MAAM;IAEZ,aAAa,CAAC,EAAE,KAAK;gBAFrB,IAAI,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACR,aAAa,CAAC,EAAE,KAAK,YAAA;CAK/B;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM;IAK3B;;;;;;;OAOG;YACW,OAAO;IAsFrB;;OAEG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,YAAY,GAAE,MAAW,GACxB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAWhC;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE;QAC9B,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAUjC;;;OAGG;IACG,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GACA,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAW9B;;OAEG;IACG,oBAAoB,CACxB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IASpC;;;;;OAKG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAgB,GAClE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CAQrC;AAKD,wBAAgB,cAAc,IAAI,WAAW,CAK5C;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/api/client.js

@@ -23,10 +23,14 @@ export class KosisClient {
         this.apiKey = apiKey || config.kosis.apiKey;
     }
     /**
-     * API 요청 실행
+     * API 요청 실행 (timeout 15s + 3회 재시도 + 지수 백오프)
+     *
+     * - Fly Singapore → KOSIS Korea cold path 일시 abort 대응
+     * - KOSIS 응답 에러(err/errMsg 필드)는 영구 실패 → 즉시 throw, retry 안 함
+     * - HTTP 4xx도 영구 실패 → 즉시 throw
+     * - 네트워크 오류·타임아웃·5xx만 retry (800ms / 1600ms 백오프)
      */
     async request(endpoint, params) {
-        // undefined 값 제거 및 문자열 변환
         const cleanParams = {};
         for (const [key, value] of Object.entries(params)) {
             if (value !== undefined) {
@@ -38,42 +42,57 @@ export class KosisClient {
         cleanParams.jsonVD = 'Y';
         const url = new URL(this.baseUrl + endpoint);
         url.search = new URLSearchParams(cleanParams).toString();
-        // 8초 타임아웃 (Vercel maxDuration 15초 내에 여유 확보)
-        const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), 8000);
-        try {
-            const response = await fetch(url.toString(), {
-                signal: controller.signal,
-            });
-            if (!response.ok) {
-                throw new KosisApiError('HTTP_ERROR', `HTTP ${response.status}: ${response.statusText}`);
-            }
-            const data = await response.json();
-            // 에러 응답 처리
-            if (data.err || data.errMsg) {
-                throw new KosisApiError(data.err || 'API_ERROR', data.errMsg || '알 수 없는 API 오류');
-            }
-            // 결과가 배열이 아닌 경우 빈 배열 반환
-            if (!Array.isArray(data)) {
-                if (data.result && Array.isArray(data.result)) {
-                    return data.result;
+        const requestUrl = url.toString();
+        const TIMEOUT_MS = 15000;
+        const MAX_ATTEMPTS = 3;
+        for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);
+            let isRetryable = false;
+            try {
+                const response = await fetch(requestUrl, {
+                    signal: controller.signal,
+                });
+                if (!response.ok) {
+                    // 5xx는 일시적 — retry, 4xx는 영구 실패
+                    isRetryable = response.status >= 500;
+                    throw new KosisApiError('HTTP_ERROR', `HTTP ${response.status}: ${response.statusText}`);
+                }
+                const data = (await response.json());
+                // KOSIS 응답 에러 — 영구 실패
+                if (data.err || data.errMsg) {
+                    throw new KosisApiError(data.err || 'API_ERROR', data.errMsg || '알 수 없는 API 오류');
+                }
+                if (!Array.isArray(data)) {
+                    if (data.result && Array.isArray(data.result)) {
+                        return data.result;
+                    }
+                    return [];
                 }
-                return [];
+                return data;
             }
-            return data;
-        }
-        catch (error) {
-            if (error instanceof KosisApiError) {
-                throw error;
+            catch (error) {
+                // KOSIS 응답 에러는 즉시 throw (retry 무의미)
+                if (error instanceof KosisApiError && !isRetryable) {
+                    throw error;
+                }
+                // 네트워크/timeout/5xx — retry 가능
+                if (attempt === MAX_ATTEMPTS - 1) {
+                    if (error instanceof DOMException && error.name === 'AbortError') {
+                        throw new KosisApiError('TIMEOUT', `KOSIS API 응답 시간 초과 (${TIMEOUT_MS / 1000}초, ${MAX_ATTEMPTS}회 시도). 잠시 후 다시 시도해주세요.`);
+                    }
+                    if (error instanceof KosisApiError)
+                        throw error;
+                    throw new KosisApiError('NETWORK_ERROR', '네트워크 오류가 발생했습니다.', error);
+                }
+                await new Promise((r) => setTimeout(r, 800 * (attempt + 1)));
             }
-            if (error instanceof DOMException && error.name === 'AbortError') {
-                throw new KosisApiError('TIMEOUT', 'KOSIS API 응답 시간 초과 (8초). 잠시 후 다시 시도해주세요.');
+            finally {
+                clearTimeout(timeoutId);
             }
-            throw new KosisApiError('NETWORK_ERROR', '네트워크 오류가 발생했습니다.', error);
-        }
-        finally {
-            clearTimeout(timeoutId);
         }
+        // 도달 불가 (위 loop에서 모두 return 또는 throw)
+        throw new KosisApiError('UNEXPECTED', '요청 처리 중 예기치 못한 종료');
     }
     /**
      * 통계목록 조회

package/dist/api/client.js.map

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

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAEvB,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDT,CAAC;AAGX,wBAAgB,cAAc,IAAI,IAAI,CAMrC;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

@@ -1,10 +1,8 @@
 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,
+        apiKey: process.env.KOSIS_API_KEY || '',
         baseUrl: 'https://kosis.kr/openapi',
         endpoints: {
             statisticsList: '/statisticsList.do',
@@ -49,6 +47,8 @@ export const config = {
 };
 // 설정 유효성 검사
 export function validateConfig() {
-    // 기본 API 키가 내장되어 있어 별도 검사 불필요
+    if (!config.kosis.apiKey) {
+        throw new Error('KOSIS_API_KEY 환경변수가 설정되지 않았습니다. https://kosis.kr/openapi/ 에서 무료 발급 후 .env 또는 환경변수로 지정하세요.');
+    }
 }
 //# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAEvB,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,eAAe;IACf,KAAK,EAAE;QACL,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE;QACvC,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,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/data/districtFileMap.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 자치구 통계연보 파일 매핑 (KOSIS file 통계표)
+ *
+ * 자치구청 발행 통계연보(DT_<orgId>001_FILE<year>)는 14개 분야 .xlsx 파일로 구성.
+ * 정식 키워드(QUICK_STATS_PARAMS의 키 또는 KEYWORD_ALIASES 정규화 결과) →
+ * 해당 분야 file_sn(1~14) 매핑.
+ *
+ * 광진구 기준 14개 파일 구조:
+ *   1: Ⅱ.토지/기후 · 2: Ⅲ.인구 · 3: Ⅳ.노동/사업체 · 4: Ⅴ.농림/제조
+ *   5: Ⅵ.가스/상하수도 · 6: Ⅶ.유통/금융/무역수지 · 7: Ⅷ.주택/건설
+ *   8: Ⅸ.교통/관광 · 9: Ⅹ.보건 · 10: XI.사회보장 · 11: XII.환경
+ *   12: XIII.교육/문화 · 13: XIV.재정 · 14: XV.공공행정/사법
+ *
+ * P0 범위: 인구·노동·주거·보건 4분야만 매핑. 나머지는 P2에서 자치구별 검증 후 확장.
+ */
+/**
+ * 자치구 단위 KOSIS OpenAPI 라우팅 매핑 (키워드 → 테이블·항목 코드)
+ *
+ * fetchKosisExcel(.xlsx 자치구 통계연보)이 미제공/PDF인 자치구에서도 자치구 정밀값을 보장.
+ * objL1은 런타임에 `getDistrictKscdCodeFor(orgId, tblId, districtName)` 으로 동적 lookup.
+ *
+ * 정확도 — KOSIS getMeta로 자치구 OBJ_ID=A 자치구별 ITM_ID 추출 후 호출. 라이브 검증 완료:
+ *   - DT_1B040A3 광진구(11215) → 331,029명 ✓
+ *   - DT_1B81A23 합계출산율 — 자치구별 코드 보유
+ */
+export interface DistrictOpenApiRoute {
+    orgId: string;
+    tblId: string;
+    itmId: string;
+    prdSe: 'Y' | 'Q' | 'M';
+    /** 자연어 응답 description (예: '주민등록 총인구', '합계출산율') */
+    description: string;
+    /** 단위 (예: '명', '%') — 응답에서 자동 부착 */
+    unit: string;
+    /** 자치구 객체 OBJ_ID (KOSIS 테이블마다 다름: 'A'/'SGG'/'region'/'C1'/'S' 등). 'auto'면 후보 순회 */
+    objId?: string;
+    /** 보조 분류 코드 (예: DT_1ES3A03_A01S 연령 YRE — '000'=계, '060'=15-64세) */
+    objL2?: string;
+    /**
+     * 자치구 코드가 들어가는 objLevel. 기본 1 — objL1=districtCode.
+     * 일부 KOSIS 테이블(예: INH_1B80A18 사망률 — OBJ_ID 순서 SBB/S)은 자치구가 objL2.
+     * 2로 지정하면 objL1=extraObjL1(고정값), objL2=districtCode.
+     */
+    districtObjLevel?: 1 | 2;
+    /** districtObjLevel=2일 때 objL1에 들어가는 고정값 (예: SBB=계=='0'). */
+    extraObjL1?: string;
+    /** 통계청 장래추계 데이터 — 미래연도 실측 아닌 추계 안내 */
+    isProjection?: boolean;
+}
+export declare const DISTRICT_OPENAPI_ROUTES: Record<string, DistrictOpenApiRoute>;
+export declare const DISTRICT_KEYWORD_TO_FILESN: Record<string, number>;
+/**
+ * markdown에서 키워드 관련 핵심 행과 추정 value/unit 추출
+ *
+ * - highlightLines: 키워드 매칭 행 + 인접 행 (최대 50줄, 표 헤더·단위 정보 포함)
+ * - value/unit: 첫 매칭 행에서 "숫자+단위" 1차 시도, 실패 시 콤마 큰 수 2차 시도
+ *
+ * 매칭 패턴 없거나 value 추출 실패 시 value=null. answer는 markdown만 노출로 degrade.
+ */
+export declare function extractDistrictHighlight(markdown: string, keyword: string): {
+    value: string | null;
+    unit: string | null;
+    highlightLines: string[];
+};
+//# sourceMappingURL=districtFileMap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"districtFileMap.d.ts","sourceRoot":"","sources":["../../src/data/districtFileMap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACvB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACzB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAoExE,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgE7D,CAAC;AA0VF;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd;IACD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CA8DA"}