korean-stats-mcp 1.4.0

package/dist/tools/compareStatistics.js

@@ -0,0 +1,190 @@
+/**
+ * 통계 비교 도구
+ * 여러 지역 또는 시점의 통계를 비교
+ */
+import { z } from 'zod';
+import { getKosisClient } from '../api/client.js';
+import { getCacheManager } from '../cache/index.js';
+import { calculateChangeRate } from '../utils/dataFormatter.js';
+export const compareStatisticsSchema = {
+    name: 'compare_statistics',
+    description: '[비교] 동일 통계표 안에서 N개 시점(period) 또는 항목(item) 비교. orgId+tableId 사전 필요. 자연어 다지역 비교(예: "서울/부산/인천 인구")는 chain_compare_regions가 더 직관적. 시점 1개 단순 조회는 quick_stats.',
+    inputSchema: z.object({
+        orgId: z.string().describe('기관 ID'),
+        tableId: z.string().describe('통계표 ID'),
+        compareType: z
+            .enum(['period', 'item'])
+            .describe('비교 유형: period(시점 비교), item(항목 비교)'),
+        periodType: z.enum(['Y', 'M', 'Q']).describe('주기: Y(년), M(월), Q(분기)'),
+        periods: z
+            .array(z.string())
+            .optional()
+            .describe('비교할 시점들 (예: ["2022", "2023", "2024"])'),
+        objL1: z.string().optional().describe('분류1 코드'),
+        objL2: z.string().optional().describe('분류2 코드 (일부 테이블에서 필요)'),
+        itemId: z.string().optional().describe('항목 ID'),
+    }),
+};
+export async function compareStatistics(input) {
+    const client = getKosisClient();
+    const cache = getCacheManager();
+    try {
+        // 데이터 조회
+        const results = await cache.getStatisticsData({
+            orgId: input.orgId,
+            tableId: input.tableId,
+            compareType: input.compareType,
+            periods: input.periods,
+        }, async () => {
+            if (input.compareType === 'period' && input.periods) {
+                // 여러 시점 데이터 조회
+                const allResults = [];
+                for (const period of input.periods) {
+                    const data = await client.getStatisticsData({
+                        orgId: input.orgId,
+                        tblId: input.tableId,
+                        objL1: input.objL1 || 'ALL',
+                        objL2: input.objL2,
+                        itmId: input.itemId || 'ALL',
+                        prdSe: input.periodType,
+                        startPrdDe: period,
+                        endPrdDe: period,
+                    });
+                    allResults.push(...data);
+                }
+                return allResults;
+            }
+            else {
+                // 단일 시점, 여러 항목 조회
+                return client.getStatisticsData({
+                    orgId: input.orgId,
+                    tblId: input.tableId,
+                    objL1: input.objL1 || 'ALL',
+                    objL2: input.objL2,
+                    itmId: 'ALL',
+                    prdSe: input.periodType,
+                    newEstPrdCnt: 1,
+                });
+            }
+        });
+        if (results.length === 0) {
+            return {
+                success: true,
+                compareType: input.compareType,
+                items: [],
+                summary: '비교할 데이터가 없습니다.',
+                insights: [],
+            };
+        }
+        // 비교 항목 생성 (모든 관련 정보 포함)
+        const items = results.map((r) => {
+            const value = parseFloat(r.DT.replace(/,/g, '')) || 0;
+            const region = r.C1_NM || undefined;
+            const itemName = r.ITM_NM || undefined;
+            const period = r.PRD_DE || undefined;
+            const unit = r.UNIT_NM || undefined;
+            // name은 비교 타입에 따라 주요 식별자로 설정
+            // 하지만 모든 정보를 별도 필드로 제공
+            let name;
+            if (input.compareType === 'period') {
+                name = period || 'N/A';
+            }
+            else {
+                // item 비교 시: 지역명과 항목명 조합
+                name = [region, itemName].filter(Boolean).join(' - ') || 'N/A';
+            }
+            return {
+                name,
+                region,
+                itemName,
+                period,
+                value,
+                formattedValue: r.DT,
+                unit,
+            };
+        });
+        // 순위 부여
+        const sortedItems = [...items].sort((a, b) => b.value - a.value);
+        sortedItems.forEach((item, index) => {
+            const original = items.find((i) => i.name === item.name);
+            if (original) {
+                original.rank = index + 1;
+            }
+        });
+        // 변화율 계산 (시점 비교인 경우)
+        if (input.compareType === 'period' && items.length > 1) {
+            for (let i = 1; i < items.length; i++) {
+                items[i].change = calculateChangeRate(items[i].value, items[i - 1].value);
+            }
+        }
+        // 요약 생성
+        const maxItem = sortedItems[0];
+        const minItem = sortedItems[sortedItems.length - 1];
+        const summary = input.compareType === 'period'
+            ? `${items[0].name}부터 ${items[items.length - 1].name}까지의 변화를 비교했습니다.`
+            : `총 ${items.length}개 항목 중 "${maxItem.name}"이(가) 가장 높고, "${minItem.name}"이(가) 가장 낮습니다.`;
+        // 인사이트 생성
+        const insights = [];
+        if (input.compareType === 'period') {
+            const firstValue = items[0].value;
+            const lastValue = items[items.length - 1].value;
+            const totalChange = calculateChangeRate(lastValue, firstValue);
+            insights.push(`전체 기간 동안 ${totalChange.direction === 'up' ? '증가' : totalChange.direction === 'down' ? '감소' : '변동 없음'} (${totalChange.formatted})`);
+            const maxChange = items
+                .filter((i) => i.change)
+                .sort((a, b) => Math.abs(b.change.rate) - Math.abs(a.change.rate))[0];
+            if (maxChange?.change) {
+                insights.push(`가장 큰 변화: ${maxChange.name} (${maxChange.change.formatted})`);
+            }
+        }
+        else {
+            const diff = ((maxItem.value - minItem.value) / minItem.value * 100).toFixed(1);
+            insights.push(`최대-최소 차이: ${diff}%`);
+        }
+        return {
+            success: true,
+            compareType: input.compareType,
+            items,
+            summary,
+            insights,
+        };
+    }
+    catch (error) {
+        console.error('Compare error:', error);
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            compareType: input.compareType,
+            items: [],
+            summary: '비교 중 오류가 발생했습니다.',
+            insights: [
+                '## 오류 상세 정보',
+                '',
+                `### 오류 내용: ${errorMessage}`,
+                '',
+                '### 사용된 파라미터',
+                `- orgId: "${input.orgId}"`,
+                `- tableId: "${input.tableId}"`,
+                `- compareType: "${input.compareType}"`,
+                `- objL1: "${input.objL1 || '미지정'}"`,
+                `- itemId: "${input.itemId || '미지정'}"`,
+                input.periods ? `- periods: ${JSON.stringify(input.periods)}` : '',
+                '',
+                '### 해결 방법',
+                '1. **get_table_info 먼저 호출**하여 유효한 코드 확인:',
+                '   ```json',
+                `   { "orgId": "${input.orgId}", "tableId": "${input.tableId}" }`,
+                '   ```',
+                '',
+                '2. **다중 지역 비교 시 형식**:',
+                '   - 개별 호출 후 결과 비교 (권장)',
+                '   - 예: 서울과 부산을 각각 조회하여 비교',
+                '',
+                '3. **시점 비교 시 형식**:',
+                '   - compareType: "period"',
+                '   - periods: ["2020", "2021", "2022", "2023"]',
+            ].filter(Boolean),
+        };
+    }
+}
+//# sourceMappingURL=compareStatistics.js.map

package/dist/tools/compareStatistics.js.map

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

package/dist/tools/fetchKosisExcel.d.ts

@@ -0,0 +1,62 @@
+/**
+ * KOSIS 파일 통계표(엑셀) 다운로드 + 파싱 도구
+ *
+ * OpenAPI 미지원 통계 (자치구 기본통계 등)는 KOSIS 사이트에 엑셀 파일로만 제공된다.
+ * 광진구 기본통계 케이스:
+ *   orgId=505, tblId=DT_505001_FILE2024, file_sn=1~14 (Ⅱ.토지·기후 ~ XV.공공행정·사법)
+ *
+ * 다운로드 3단계 (KOSIS nsibsHtmlSvc 내부 흐름):
+ *   1) GET  fileStblView.do?in_org_id=...&in_tbl_id=...   → JSESSIONID 쿠키 + 파일 목록 HTML
+ *   2) POST fileItmDownload.do (org_id, tbl_id, file_sn)  → {dwldFilePath, dwldFileNm} JSON
+ *   3) POST dwldServerFile.do  (file_path, file_name echo)→ xlsx 바이너리
+ *
+ * 파싱: kordoc.parse() 가 XLSX → 마크다운 변환 (시트별 표)
+ */
+import { z } from 'zod';
+export declare const fetchKosisExcelSchema: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        districtName: z.ZodOptional<z.ZodString>;
+        year: z.ZodOptional<z.ZodNumber>;
+        orgId: z.ZodOptional<z.ZodString>;
+        tblId: z.ZodOptional<z.ZodString>;
+        fileSn: z.ZodOptional<z.ZodNumber>;
+        listOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        listOnly: boolean;
+        orgId?: string | undefined;
+        tblId?: string | undefined;
+        year?: number | undefined;
+        districtName?: string | undefined;
+        fileSn?: number | undefined;
+    }, {
+        orgId?: string | undefined;
+        tblId?: string | undefined;
+        year?: number | undefined;
+        districtName?: string | undefined;
+        fileSn?: number | undefined;
+        listOnly?: boolean | undefined;
+    }>;
+};
+export type FetchKosisExcelInput = z.infer<typeof fetchKosisExcelSchema.inputSchema>;
+interface FileItem {
+    file_sn: number;
+    file_nm: string;
+}
+interface ExcelFetchResult {
+    success: boolean;
+    orgId: string;
+    tblId: string;
+    files?: FileItem[];
+    fileSn?: number;
+    fileName?: string;
+    markdown?: string;
+    fileType?: string;
+    byteSize?: number;
+    warnings?: string[];
+    error?: string;
+}
+export declare function fetchKosisExcel(input: FetchKosisExcelInput): Promise<ExcelFetchResult>;
+export {};
+//# sourceMappingURL=fetchKosisExcel.d.ts.map

package/dist/tools/fetchKosisExcel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchKosisExcel.d.ts","sourceRoot":"","sources":["../../src/tools/fetchKosisExcel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;CA+CjC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,WAAW,CAAC,CAAC;AAErF,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAkKD,wBAAsB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyJ5F"}

package/dist/tools/fetchKosisExcel.js

@@ -0,0 +1,366 @@
+/**
+ * KOSIS 파일 통계표(엑셀) 다운로드 + 파싱 도구
+ *
+ * OpenAPI 미지원 통계 (자치구 기본통계 등)는 KOSIS 사이트에 엑셀 파일로만 제공된다.
+ * 광진구 기본통계 케이스:
+ *   orgId=505, tblId=DT_505001_FILE2024, file_sn=1~14 (Ⅱ.토지·기후 ~ XV.공공행정·사법)
+ *
+ * 다운로드 3단계 (KOSIS nsibsHtmlSvc 내부 흐름):
+ *   1) GET  fileStblView.do?in_org_id=...&in_tbl_id=...   → JSESSIONID 쿠키 + 파일 목록 HTML
+ *   2) POST fileItmDownload.do (org_id, tbl_id, file_sn)  → {dwldFilePath, dwldFileNm} JSON
+ *   3) POST dwldServerFile.do  (file_path, file_name echo)→ xlsx 바이너리
+ *
+ * 파싱: kordoc.parse() 가 XLSX → 마크다운 변환 (시트별 표)
+ */
+import { z } from 'zod';
+// kordoc은 optionalDependencies — 원격 배포(Vercel)에서는 함수 사이즈 한도(250MB)
+// 때문에 제외됩니다. 로컬 설치에서만 동적으로 로드합니다.
+async function loadKordoc() {
+    try {
+        const mod = await import('kordoc');
+        return mod.parse;
+    }
+    catch {
+        return null;
+    }
+}
+import { resolveDistrictFileTable } from '../utils/regions.js';
+const KOSIS_HOST = 'https://stat.kosis.kr';
+const KOSIS_BASE = `${KOSIS_HOST}/nsibsHtmlSvc/fileView/FileStbl`;
+export const fetchKosisExcelSchema = {
+    name: 'fetch_kosis_excel',
+    description: `[엑셀파싱] KOSIS 사이트의 파일 통계표(엑셀로만 제공)를 다운로드 + 파싱한 마크다운 반환. quick_stats / quick_trend가 광역시도까지만 지원하므로 자치구별 정밀 데이터는 이 도구로.
+
+⚠️ 자치구 file 통계표 제공은 광역시도마다 차이:
+• **확인된 제공**: 서울 자치구 일부 (광진구 orgId=505, 강남구 orgId=523 등) — DT_{orgId}001_FILE{year} 형식
+• **미제공 확인**: 부산 해운대구(539), 대구 수성구(556) 등 비-서울 다수 자치구 — 404 발생
+• 비-서울 자치구는 file 통계표 대신 \`get_statistics_data\` 로 OpenAPI 경로 사용 권장:
+  - Path A: 광역시도 기본통계 (orgId=202/203, regionName="해운대구"/"수성구")
+  - Path B: 자치구 단독 OpenAPI (orgId=539, tblId=DT_53902_B001003 등)
+  - Path C: 통계청 e-지방지표 (orgId=101, DT_1YL*)
+
+언제 사용:
+• OpenAPI(get_statistics_data) 가 "통계표 없음" 에러를 내고, 해당 자치구가 서울 자치구일 때
+• 「작성중지통계」 카테고리 등 파일 형태로만 제공되는 통계
+
+사용 흐름:
+1. listOnly=true 로 파일 목록 먼저 조회 → file_sn(1~N) + 파일명(Ⅲ.인구 등) 확인
+2. file_sn 지정해서 다시 호출 → 해당 파일을 마크다운으로 반환
+
+광진구 기본통계 예시:
+{ orgId: "505", tblId: "DT_505001_FILE2024", listOnly: true }       // 14개 파일 목록
+{ orgId: "505", tblId: "DT_505001_FILE2024", fileSn: 3 }             // Ⅲ.인구 파일 파싱
+
+자치구 이름으로 자동 도출 (서울 자치구만 안정적):
+{ districtName: "광진구", listOnly: true }                           // orgId/tblId 자동 도출
+{ districtName: "강남구", fileSn: 3, year: 2024 }`,
+    inputSchema: z.object({
+        districtName: z
+            .string()
+            .optional()
+            .describe('자치구·시·군 이름 (예: "광진구", "강남구"). 주어지면 orgId/tblId 자동 도출. 단독 사용 시 orgId/tblId 생략 가능.'),
+        year: z.number().int().optional().describe('기준 연도 (예: 2024). districtName 사용시 적용. 기본은 현재 연도-1.'),
+        orgId: z.string().optional().describe('파일 통계표 기관 ID (예: "505" = 서울특별시 광진구). districtName 있으면 무시.'),
+        tblId: z.string().optional().describe('파일 통계표 ID (예: "DT_505001_FILE2024"). districtName 있으면 무시.'),
+        fileSn: z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .describe('파일 일련번호 (1부터). listOnly=true 면 무시.'),
+        listOnly: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe('true면 파일 목록만 조회. 어느 file_sn을 받을지 결정할 때 먼저 호출.'),
+    }),
+};
+/**
+ * Set-Cookie 헤더에서 "JSESSIONID=...; WMONID=...; ..." 형태로 추출
+ * Node 20+ fetch는 getSetCookie() 지원. 폴백으로 set-cookie 헤더 단일 split.
+ */
+function extractCookies(res) {
+    const sc = res.headers.getSetCookie?.()
+        ?? (res.headers.get('set-cookie')?.split(/,(?=\s*[A-Za-z0-9_-]+=)/) ?? []);
+    return sc
+        .map((c) => c.split(';')[0].trim())
+        .filter(Boolean)
+        .join('; ');
+}
+/** 1단계: 파일 통계표 페이지 GET → 쿠키 + HTML */
+async function fetchTableView(orgId, tblId) {
+    const url = `${KOSIS_BASE}/fileStblView.do?in_org_id=${encodeURIComponent(orgId)}&in_tbl_id=${encodeURIComponent(tblId)}`;
+    const res = await fetch(url, {
+        headers: {
+            'User-Agent': 'Mozilla/5.0 korea-stats-mcp',
+            'Accept': 'text/html',
+        },
+    });
+    if (!res.ok)
+        throw new Error(`fileStblView.do HTTP ${res.status}`);
+    return { cookie: extractCookies(res), html: await res.text() };
+}
+/**
+ * HTML에서 파일 목록 추출
+ * KOSIS는 `fn_fileitm_download('N')` 호출과 그 근처(보통 <li>의 텍스트)에 파일명을 둔다.
+ *
+ * 예시 구조:
+ *   <li>
+ *     <span class="...">Ⅲ.인구</span>
+ *     <a href="javascript:file_prev_obj.fn_fileitm_download('3');">...</a>
+ *   </li>
+ */
+function parseFileList(html) {
+    const out = [];
+    const seen = new Set();
+    // 패턴 A: <li> 단위로 파일명 + sn 한 번에 묶기
+    const liRx = /<li\b[^>]*>([\s\S]*?)<\/li>/g;
+    let m;
+    while ((m = liRx.exec(html)) !== null) {
+        const block = m[1];
+        const snMatch = block.match(/fn_fileitm_download\s*\(\s*['"]?(\d+)['"]?\s*\)/);
+        if (!snMatch)
+            continue;
+        const sn = parseInt(snMatch[1], 10);
+        if (seen.has(sn))
+            continue;
+        // 파일명 = li 안의 텍스트에서 태그·script 제거 후 가장 긴 의미있는 줄
+        const text = block
+            .replace(/<script[\s\S]*?<\/script>/g, '')
+            .replace(/<[^>]+>/g, ' ')
+            .replace(/&nbsp;/g, ' ')
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&quot;/g, '"')
+            .replace(/&#39;/g, "'")
+            .replace(/&amp;/g, '&')
+            .replace(/\s+/g, ' ')
+            .trim();
+        if (!text)
+            continue;
+        seen.add(sn);
+        out.push({ file_sn: sn, file_nm: text.length > 80 ? text.slice(0, 80) + '…' : text });
+    }
+    // 패턴 B: <li>로 못 잡았으면 함수 호출만이라도 추출
+    if (out.length === 0) {
+        const rx = /fn_fileitm_download\s*\(\s*['"]?(\d+)['"]?\s*\)/g;
+        while ((m = rx.exec(html)) !== null) {
+            const sn = parseInt(m[1], 10);
+            if (seen.has(sn))
+                continue;
+            seen.add(sn);
+            out.push({ file_sn: sn, file_nm: `file_sn=${sn}` });
+        }
+    }
+    out.sort((a, b) => a.file_sn - b.file_sn);
+    return out;
+}
+/** 2단계: fileItmDownload.do POST → {dwldFilePath, dwldFileNm} */
+async function fetchDownloadInfo(orgId, tblId, fileSn, cookie) {
+    const url = `${KOSIS_BASE}/fileItmDownload.do`;
+    const body = new URLSearchParams({
+        vw_cd: 'NULL',
+        list_id: 'NULL',
+        org_id: orgId,
+        tbl_id: tblId,
+        file_svc: '',
+        file_sn: String(fileSn),
+        conn_path: '',
+    });
+    const res = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'User-Agent': 'Mozilla/5.0 korea-stats-mcp',
+            'Cookie': cookie,
+            'Content-Type': 'application/x-www-form-urlencoded',
+            'Accept': 'application/json',
+            'X-Requested-With': 'XMLHttpRequest',
+        },
+        body: body.toString(),
+    });
+    if (!res.ok)
+        throw new Error(`fileItmDownload.do HTTP ${res.status}`);
+    const json = (await res.json());
+    // 응답 형식: { resultMap: { dwldFilePath, dwldFileNm, dwldFileSize }, baseinfo, success }
+    // 일부 응답은 최상위에 직접 둘 수 있으므로 양쪽 모두 확인
+    const path = json.resultMap?.dwldFilePath ?? json.dwldFilePath;
+    const name = json.resultMap?.dwldFileNm ?? json.dwldFileNm;
+    const size = json.resultMap?.dwldFileSize ?? json.dwldFileSize;
+    if (!path || !name) {
+        throw new Error(`fileItmDownload.do 응답 누락: ${JSON.stringify(json).slice(0, 300)}`);
+    }
+    return { dwldFilePath: path, dwldFileNm: name, dwldFileSize: size };
+}
+/** 3단계: dwldServerFile.do POST → 실제 xlsx 바이너리 */
+async function downloadFile(orgId, tblId, fileSn, info, cookie) {
+    const url = `${KOSIS_BASE}/dwldServerFile.do`;
+    const body = new URLSearchParams({
+        org_id: orgId,
+        tbl_id: tblId,
+        file_sn: String(fileSn),
+        img_yn: '',
+        fileSvc: '',
+        file_path: info.dwldFilePath,
+        file_name: info.dwldFileNm,
+    });
+    const res = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'User-Agent': 'Mozilla/5.0 korea-stats-mcp',
+            'Cookie': cookie,
+            'Content-Type': 'application/x-www-form-urlencoded',
+            'Accept': 'application/octet-stream,*/*',
+        },
+        body: body.toString(),
+    });
+    if (!res.ok)
+        throw new Error(`dwldServerFile.do HTTP ${res.status}`);
+    return res.arrayBuffer();
+}
+export async function fetchKosisExcel(input) {
+    try {
+        // districtName 우선 — 자동 도출
+        let orgId = input.orgId;
+        let tblId = input.tblId;
+        let tblIdCandidates = tblId ? [tblId] : [];
+        if (input.districtName) {
+            const resolved = await resolveDistrictFileTable(input.districtName, input.year);
+            if (!resolved) {
+                return {
+                    success: false,
+                    orgId: orgId ?? '',
+                    tblId: tblId ?? '',
+                    error: `자치구 "${input.districtName}" 의 파일통계표를 도출할 수 없습니다. 광역시도 매핑(DISTRICT_TO_PROVINCE)에 있는지 확인하세요.`,
+                };
+            }
+            orgId = resolved.orgId;
+            tblId = resolved.tblId;
+            tblIdCandidates = resolved.tblIdCandidates;
+        }
+        if (!orgId || !tblId) {
+            return {
+                success: false,
+                orgId: orgId ?? '',
+                tblId: tblId ?? '',
+                error: 'orgId·tblId 또는 districtName 중 하나는 반드시 지정해야 합니다.',
+            };
+        }
+        // 1단계 — 페이지 GET (쿠키 + 파일 목록). year 후보 순회 (currentYear-1 → -2 → -3).
+        let cookie;
+        let html;
+        let pickedTblId = tblId;
+        const tried = [];
+        for (const candidate of tblIdCandidates) {
+            tried.push(candidate);
+            try {
+                const res = await fetchTableView(orgId, candidate);
+                cookie = res.cookie;
+                html = res.html;
+                pickedTblId = candidate;
+                break;
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                if (msg.includes('HTTP 404'))
+                    continue;
+                throw e;
+            }
+        }
+        tblId = pickedTblId;
+        if (!cookie || !html) {
+            // 모든 후보 404 — 해당 자치구는 KOSIS file 통계표 미제공
+            const dn = input.districtName ?? '';
+            return {
+                success: false,
+                orgId,
+                tblId,
+                error: `KOSIS 파일 통계표 미제공: ${dn ? `자치구 "${dn}"` : `orgId=${orgId}`} 에 해당하는 파일 통계표가 KOSIS 사이트에 없습니다.
+
+시도한 tblId: ${tried.join(', ')}
+
+대안 (OpenAPI 경로) — get_statistics_data 사용:
+• Path A — 광역시도 기본통계: 해당 광역시도(예: 부산=202, 대구=203)의 구·군별 표 (DT_202, DT_B40001 등)에 regionName 지정
+• Path B — 자치구 단독 OpenAPI: orgId=${orgId} tblId 시리즈 (DT_${orgId}xx_<chapter><nnnnnn> 형식)를 search_statistics 로 검색
+• Path C — 통계청 e-지방지표 (orgId=101, DT_1YL*) 에 regionName 지정
+
+자치구별 file 통계표 제공 확정 자치구: 서울 25개 자치구 일부 (광진구 505, 강남구 523 등)`,
+            };
+        }
+        const files = parseFileList(html);
+        if (input.listOnly || !input.fileSn) {
+            return {
+                success: true,
+                orgId,
+                tblId,
+                files,
+                warnings: files.length === 0 ? ['파일 목록 파싱 실패 — file_sn=1부터 직접 시도해보세요.'] : undefined,
+            };
+        }
+        const fileMeta = files.find((f) => f.file_sn === input.fileSn);
+        // 2단계 — 다운로드 정보
+        const info = await fetchDownloadInfo(orgId, tblId, input.fileSn, cookie);
+        // 3단계 — 실제 파일
+        const ab = await downloadFile(orgId, tblId, input.fileSn, info, cookie);
+        // 매직바이트 확인 (xlsx = PK\x03\x04)
+        const head = new Uint8Array(ab.slice(0, 4));
+        if (!(head[0] === 0x50 && head[1] === 0x4b)) {
+            const decoder = new TextDecoder('utf-8', { fatal: false });
+            const snippet = decoder.decode(ab.slice(0, 500));
+            return {
+                success: false,
+                orgId,
+                tblId,
+                fileSn: input.fileSn,
+                fileName: fileMeta?.file_nm ?? info.dwldFileNm,
+                byteSize: ab.byteLength,
+                error: `XLSX가 아닌 응답 (${ab.byteLength}B): ${snippet.slice(0, 300)}`,
+            };
+        }
+        // kordoc 파싱 (XLSX → 마크다운). 원격 배포에선 미설치라 안내 후 종료.
+        const parse = await loadKordoc();
+        if (!parse) {
+            return {
+                success: false,
+                orgId,
+                tblId,
+                fileSn: input.fileSn,
+                fileName: fileMeta?.file_nm ?? info.dwldFileNm,
+                byteSize: ab.byteLength,
+                error: 'kordoc 모듈이 설치돼 있지 않습니다. 자치구 .xlsx 파일 파싱은 로컬 설치(pnpm install)에서만 지원됩니다. 원격 MCP에서는 search_statistics / get_statistics_data 사용.',
+            };
+        }
+        const result = await parse(ab);
+        if (!result.success) {
+            return {
+                success: false,
+                orgId,
+                tblId,
+                fileSn: input.fileSn,
+                fileName: fileMeta?.file_nm ?? info.dwldFileNm,
+                byteSize: ab.byteLength,
+                error: `kordoc 파싱 실패: ${result.error ?? '알 수 없음'} (code=${result.code ?? '?'})`,
+            };
+        }
+        return {
+            success: true,
+            orgId,
+            tblId,
+            fileSn: input.fileSn,
+            fileName: fileMeta?.file_nm ?? info.dwldFileNm,
+            fileType: result.fileType,
+            byteSize: ab.byteLength,
+            markdown: result.markdown,
+            warnings: result.warnings?.map((w) => w.message),
+        };
+    }
+    catch (e) {
+        return {
+            success: false,
+            orgId: input.orgId ?? '',
+            tblId: input.tblId ?? '',
+            fileSn: input.fileSn,
+            error: e instanceof Error ? e.message : String(e),
+        };
+    }
+}
+//# sourceMappingURL=fetchKosisExcel.js.map

package/dist/tools/fetchKosisExcel.js.map

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