korean-stats-mcp 1.4.0

package/dist/tools/getStatisticsData.js

@@ -0,0 +1,305 @@
+/**
+ * 통계 데이터 조회 도구
+ * 특정 통계표의 실제 데이터를 조회
+ */
+import { z } from 'zod';
+import { getKosisClient } from '../api/client.js';
+import { getCacheManager } from '../cache/index.js';
+import { simplifyStatisticsData, recommendVisualization } from '../utils/dataFormatter.js';
+import { resolveDimensions, summarizeTableMeta } from '../utils/metaLookup.js';
+export const getStatisticsDataSchema = {
+    name: 'get_statistics_data',
+    description: `[직접조회] 특정 통계표의 실제 데이터를 조회. orgId+tableId 필수.
+
+🔄 도구 라우팅:
+• 자연어/키워드(예: "서울 인구") → quick_stats가 우선
+• 시계열(추세/추이) → quick_trend
+• 통계표 ID를 모르면 → search_statistics
+• 차원·항목 코드 확인 → get_table_info
+
+자동 메타 lookup 지원:
+• regionName="광진구" 처럼 자치구·시·군 이름을 주면 objL1·objL2가 자동으로 채워집니다 (시군구별/자치구별/구군별/행정구역별 OBJ에서 매칭).
+• itemName으로 항목명 매칭도 가능 (예: "여자", "65세이상").
+• objL1·itemId를 직접 넣으면 lookup 없이 그 값 사용.
+
+자치구·시·군 통계 조회 경로 (광역시도별로 패턴이 다름):
+
+【Path A — 광역시도 기본통계 시리즈】 가장 일반적
+• 서울: orgId=201, tblId=DT_201004_* (예: DT_201004_O110054 보육시설)
+• 부산: orgId=202, tblId=DT_xxx (예: DT_202 구·군별 세대 및 등록인구)
+• 대구: orgId=203, tblId=DT_Bxxxxx (예: DT_B40001 구군별 세대 및 등록인구)
+• 인천 이하: 자치구별 [구군별]/[행정구역별] 분류에 ITM_NM으로 자치구가 들어있음
+• 광역시도별 LIST_ID 패턴이 다르므로, search_statistics 로 표 ID 먼저 확인
+
+【Path B — 자치구 단독 OpenAPI 시리즈】 챕터별 세분화 통계
+• orgId=5xx (자치구 코드), tblId=DT_<자치구코드>0?_<챕터><번호>
+• 예: 해운대구 orgId=539, tblId=DT_53902_B001003 (인구추이)
+• 예: 수성구 orgId=556, tblId=DT_55601_B001003 (인구추이)
+• regionName 없이 그대로 조회 (이미 자치구 한정 표)
+
+【Path C — 통계청 e-지방지표 (orgId=101)】 256개 행정구역 통합
+• DT_1YLxxxxx 시리즈 (예: DT_1YL15001 학급당 학생수)
+• regionName="수성구" / "해운대구" 등 모든 시군구가 [행정구역별] 분류에 들어있음
+• 광역시도 기본통계가 미비할 때 가장 광범위한 폴백
+
+ITM_ID는 통계표마다 다른 코드 체계를 쓰므로(예: "001005", "1520213102303231A.09", "22060"), 직접 입력 대신 regionName/itemName 사용을 권장합니다.
+
+「OO광역시도 OO구 기본통계」 컨테이너 LIST_ID(예: 201_201A_505_50501)는 직접 조회하지 말 것 — TBL_ID가 아님.`,
+    inputSchema: z.object({
+        orgId: z.string().describe('기관 ID (예: 201 = 서울특별시)'),
+        tableId: z.string().describe('통계표 ID (예: DT_201004_O110054)'),
+        regionName: z
+            .string()
+            .optional()
+            .describe('자치구·시·군 이름 (예: "광진구", "수성구"). 주어지면 objL1/objL2 자동 lookup. 전국·합계는 비워둠.'),
+        itemName: z
+            .string()
+            .optional()
+            .describe('항목 이름 (예: "여자", "총인구"). 주어지면 itemId 자동 lookup. 보통 통계표 항목이 하나면 생략.'),
+        objL1: z
+            .string()
+            .optional()
+            .describe('분류1 코드 직접 지정 (선택). regionName이 있으면 무시.'),
+        objL2: z.string().optional().describe('분류2 코드 (선택)'),
+        objL3: z.string().optional().describe('분류3 코드 (선택)'),
+        objL4: z.string().optional().describe('분류4 코드 (선택)'),
+        itemId: z
+            .string()
+            .optional()
+            .describe('항목 ID 직접 지정 (선택). itemName이 있으면 무시.'),
+        periodType: z
+            .enum(['Y', 'M', 'Q', 'S', 'D', 'F', 'IR'])
+            .describe('주기: Y(년), M(월), Q(분기), S(반기), D(일), F(다년), IR(부정기)'),
+        startPeriod: z
+            .string()
+            .optional()
+            .describe('시작 시점 (예: 2020, 202001)'),
+        endPeriod: z
+            .string()
+            .optional()
+            .describe('종료 시점 (예: 2024, 202412)'),
+        recentCount: z
+            .number()
+            .min(1)
+            .max(100)
+            .optional()
+            .describe('최근 N개 시점 (startPeriod/endPeriod 대신 사용)'),
+    }),
+};
+export async function getStatisticsData(input) {
+    const client = getKosisClient();
+    const cache = getCacheManager();
+    try {
+        // 자동 메타 lookup — regionName/itemName이 있거나 objL1/itemId가 비어있으면 실행
+        let resolvedObjL1 = input.objL1;
+        let resolvedObjL2 = input.objL2;
+        let resolvedObjL3 = input.objL3;
+        let resolvedObjL4 = input.objL4;
+        let resolvedItmId = input.itemId;
+        let resolveLog = [];
+        const needsLookup = input.regionName ||
+            input.itemName ||
+            (!input.objL1 && !input.itemId);
+        if (needsLookup) {
+            const r = await resolveDimensions(input.orgId, input.tableId, {
+                regionName: input.regionName,
+                itemName: input.itemName,
+            });
+            // 명시적 regionName/itemName 매칭 실패 → 잘못된 폴백 데이터 방지 위해 즉시 에러
+            if (r.unmatched) {
+                const candidateLines = r.candidates
+                    ? Object.entries(r.candidates)
+                        .map(([objNm, names]) => `  - ${objNm}: ${names.slice(0, 8).join(', ')}${names.length > 8 ? ' ...' : ''}`)
+                        .join('\n')
+                    : '';
+                const missMsg = [
+                    r.unmatched.regionName ? `regionName="${r.unmatched.regionName}"` : '',
+                    r.unmatched.itemName ? `itemName="${r.unmatched.itemName}"` : '',
+                ].filter(Boolean).join(', ');
+                return {
+                    success: false,
+                    data: [],
+                    totalCount: 0,
+                    metadata: {
+                        orgId: input.orgId,
+                        tableId: input.tableId,
+                        periodType: input.periodType,
+                    },
+                    resolved: r.resolved,
+                    usageHint: `
+## 메타 lookup 실패
+
+요청한 ${missMsg} 이(가) 이 통계표의 어느 분류에서도 매칭되지 않았습니다.
+
+### 사용 가능한 후보
+${candidateLines || '(메타 정보 없음)'}
+
+### 해결
+1. 광역시도가 다른 자치구일 수 있습니다. 광역시도별 표 ID 패턴은 다음과 같습니다:
+   - 서울(201): DT_201004_* — 자치구 분류 포함
+   - 부산(202): DT_202, DT_BA102 등 — [구군별] 분류
+   - 대구(203): DT_B40001, DT_B70001 등 — [행정구역(구군)별] 분류
+   - 통계청(101): DT_1IN1503 시군구 주민등록인구, DT_1YL* e-지방지표 — 모든 시군구
+2. \`search_statistics\` 로 "${input.regionName ?? ''} <원하는 통계>" 검색해서 표 ID 확인.
+3. \`get_table_info\` 로 메타에서 정확한 분류명을 확인.`,
+                };
+            }
+            // 사용자가 직접 지정한 값은 덮어쓰지 않음
+            resolvedObjL1 = input.objL1 ?? r.objL1;
+            resolvedObjL2 = input.objL2 ?? r.objL2;
+            resolvedObjL3 = input.objL3 ?? r.objL3;
+            resolvedObjL4 = input.objL4 ?? r.objL4;
+            resolvedItmId = input.itemId ?? r.itmId;
+            resolveLog = r.resolved;
+        }
+        // 캐시된 데이터 조회
+        const results = await cache.getStatisticsData({
+            orgId: input.orgId,
+            tableId: input.tableId,
+            objL1: resolvedObjL1,
+            objL2: resolvedObjL2,
+            objL3: resolvedObjL3,
+            objL4: resolvedObjL4,
+            itemId: resolvedItmId,
+            periodType: input.periodType,
+            startPeriod: input.startPeriod,
+            endPeriod: input.endPeriod,
+            recentCount: input.recentCount,
+        }, async () => {
+            return client.getStatisticsData({
+                orgId: input.orgId,
+                tblId: input.tableId,
+                objL1: resolvedObjL1,
+                objL2: resolvedObjL2,
+                objL3: resolvedObjL3,
+                objL4: resolvedObjL4,
+                itmId: resolvedItmId,
+                prdSe: input.periodType,
+                startPrdDe: input.startPeriod,
+                endPrdDe: input.endPeriod,
+                newEstPrdCnt: input.recentCount,
+            });
+        });
+        if (results.length === 0) {
+            // 매칭 실패 디버깅용: 메타 요약 반환
+            let candidates;
+            try {
+                const summary = await summarizeTableMeta(input.orgId, input.tableId, {
+                    sampleSize: 8,
+                    filter: input.regionName,
+                });
+                candidates = summary.groups
+                    .map((g) => `### [${g.objIdSn === '0' ? '항목' : 'objL' + g.objIdSn}] ${g.objNm} (총 ${g.totalItems}개)\n` +
+                    g.sample.map((it) => `  - \`${it.ITM_ID}\` ${it.ITM_NM}`).join('\n'))
+                    .join('\n\n');
+            }
+            catch { }
+            return {
+                success: true,
+                data: [],
+                totalCount: 0,
+                metadata: {
+                    orgId: input.orgId,
+                    tableId: input.tableId,
+                    periodType: input.periodType,
+                },
+                resolved: resolveLog,
+                usageHint: `
+## 데이터를 찾을 수 없습니다
+
+### 사용된 파라미터
+- orgId: "${input.orgId}"
+- tableId: "${input.tableId}"
+- objL1: "${resolvedObjL1}"
+- objL2: "${resolvedObjL2 ?? ''}"
+- itemId: "${resolvedItmId}"
+- periodType: "${input.periodType}"
+
+### 사용 가능한 분류값
+${candidates ?? '(메타 조회 실패)'}
+
+### 해결 방법
+1. **get_table_info 호출**하여 유효한 코드를 확인하세요:
+   \`\`\`json
+   { "orgId": "${input.orgId}", "tableId": "${input.tableId}" }
+   \`\`\`
+
+2. **파라미터 확인**:
+   - objL1: 분류값 코드 (예: "00"=전국, "11"=서울)
+   - itemId: 항목 코드 (예: "T10", "T1")
+   - ⚠️ OBJ_ID(예: "ITEM", "B")가 아닌 실제 분류값 코드를 사용하세요
+
+### 예시 호출
+{
+  "orgId": "${input.orgId}",
+  "tableId": "${input.tableId}",
+  "objL1": "00",
+  "itemId": "T1",
+  "periodType": "${input.periodType}",
+  "recentCount": 5
+}
+`,
+            };
+        }
+        // 데이터 간소화
+        const simplifiedData = simplifyStatisticsData(results);
+        // 메타데이터 추출
+        const firstItem = results[0];
+        const periods = results.map((r) => r.PRD_DE);
+        const periodRange = periods.length > 1
+            ? `${periods[periods.length - 1]} ~ ${periods[0]}`
+            : periods[0];
+        // 시각화 추천
+        const hasMultipleCategories = new Set(simplifiedData.map((d) => d.classification)).size > 1;
+        const visualization = recommendVisualization(simplifiedData.length, hasMultipleCategories, ['Y', 'M', 'Q'].includes(input.periodType));
+        return {
+            success: true,
+            tableName: firstItem.TBL_NM,
+            unit: firstItem.UNIT_NM,
+            data: simplifiedData,
+            totalCount: simplifiedData.length,
+            visualization: {
+                recommendedType: visualization.type,
+                reason: visualization.reason,
+            },
+            metadata: {
+                orgId: input.orgId,
+                tableId: input.tableId,
+                periodType: input.periodType,
+                periodRange,
+            },
+        };
+    }
+    catch (error) {
+        console.error('Data error:', error);
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            data: [],
+            totalCount: 0,
+            metadata: {
+                orgId: input.orgId,
+                tableId: input.tableId,
+                periodType: input.periodType,
+            },
+            usageHint: `
+## 데이터 조회 중 오류 발생
+
+### 오류 내용
+${errorMessage}
+
+### 확인 사항
+1. orgId, tableId가 올바른지 확인하세요
+2. get_table_info로 유효한 objL1, itemId 코드를 확인하세요
+3. periodType이 해당 통계표에서 지원되는지 확인하세요
+
+### get_table_info 호출 예시
+{
+  "orgId": "${input.orgId}",
+  "tableId": "${input.tableId}"
+}
+`,
+        };
+    }
+}
+//# sourceMappingURL=getStatisticsData.js.map

package/dist/tools/getStatisticsData.js.map

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

package/dist/tools/getStatisticsList.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 통계 목록 조회 도구
+ * 주제별/기관별 트리 탐색 + 9개 분야 추천 카드 통합 (recommendedTopic 옵션)
+ */
+import { z } from 'zod';
+import type { ListItem, SimplifiedStatisticsItem } from '../api/types.js';
+export declare const getStatisticsListSchema: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        viewCode: z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodEnum<["MT_ZTITLE", "MT_OTITLE", "MT_GTITLE01", "MT_GTITLE02", "MT_RTITLE", "MT_BUKHAN", "MT_TM1_TITLE", "MT_TM2_TITLE"]>>;
+        parentId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        recommendedTopic: z.ZodOptional<z.ZodEnum<["population", "economy", "employment", "housing", "education", "health", "environment", "transport", "social"]>>;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        viewCode: "MT_OTITLE" | "MT_ZTITLE" | "MT_GTITLE01" | "MT_GTITLE02" | "MT_RTITLE" | "MT_BUKHAN" | "MT_TM1_TITLE" | "MT_TM2_TITLE";
+        parentId: string;
+        recommendedTopic?: "population" | "economy" | "employment" | "housing" | "education" | "health" | "environment" | "transport" | "social" | undefined;
+    }, {
+        viewCode: string;
+        limit?: number | undefined;
+        parentId?: string | undefined;
+        recommendedTopic?: "population" | "economy" | "employment" | "housing" | "education" | "health" | "environment" | "transport" | "social" | undefined;
+    }>;
+};
+export type GetStatisticsListInput = z.infer<typeof getStatisticsListSchema.inputSchema>;
+type ListResult = {
+    success: boolean;
+    viewName: string;
+    parentId: string;
+    items: ListItem[];
+    hasMore: boolean;
+    navigation?: {
+        canGoUp: boolean;
+        instruction: string;
+    };
+};
+type RecommendedResult = {
+    success: boolean;
+    mode: 'recommended';
+    topic: {
+        code: string;
+        name: string;
+        description: string;
+    };
+    recommendations: SimplifiedStatisticsItem[];
+    relatedTopics: string[];
+    searchSuggestions: string[];
+};
+export declare function getStatisticsList(input: GetStatisticsListInput): Promise<ListResult | RecommendedResult>;
+/**
+ * 사용 가능한 서비스뷰 목록 반환
+ */
+export declare function getAvailableViewCodes(): Array<{
+    code: string;
+    name: string;
+    description: string;
+}>;
+/**
+ * 추천 토픽 목록 (이전 getAvailableTopics와 동일)
+ */
+export declare function getAvailableRecommendedTopics(): Array<{
+    code: string;
+    name: string;
+    description: string;
+}>;
+export {};
+//# sourceMappingURL=getStatisticsList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getStatisticsList.d.ts","sourceRoot":"","sources":["../../src/tools/getStatisticsList.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,QAAQ,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAkH1E,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;CAuDnC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,WAAW,CAAC,CAAC;AAEzF,KAAK,UAAU,GAAG;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,eAAe,EAAE,wBAAwB,EAAE,CAAC;IAC5C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,UAAU,GAAG,iBAAiB,CAAC,CAkKzC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,KAAK,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAWD;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,KAAK,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAMD"}