korean-stats-mcp 1.4.0

package/dist/tools/getRecommendedStats.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 추천 통계 도구
+ * 분야별 관련 통계표를 추천
+ */
+import { z } from 'zod';
+import type { SimplifiedStatisticsItem } from '../api/types.js';
+export declare const getRecommendedStatsSchema: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        topic: z.ZodEnum<["population", "economy", "employment", "housing", "education", "health", "environment", "transport", "social"]>;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        topic: "population" | "economy" | "employment" | "housing" | "education" | "health" | "environment" | "transport" | "social";
+    }, {
+        topic: "population" | "economy" | "employment" | "housing" | "education" | "health" | "environment" | "transport" | "social";
+        limit?: number | undefined;
+    }>;
+};
+export type GetRecommendedStatsInput = z.infer<typeof getRecommendedStatsSchema.inputSchema>;
+export declare function getRecommendedStats(input: GetRecommendedStatsInput): Promise<{
+    success: boolean;
+    topic: {
+        code: string;
+        name: string;
+        description: string;
+    };
+    recommendations: SimplifiedStatisticsItem[];
+    relatedTopics: string[];
+    searchSuggestions: string[];
+}>;
+/**
+ * 사용 가능한 분야 목록 반환
+ */
+export declare function getAvailableTopics(): Array<{
+    code: string;
+    name: string;
+    description: string;
+}>;
+//# sourceMappingURL=getRecommendedStats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getRecommendedStats.d.ts","sourceRoot":"","sources":["../../src/tools/getRecommendedStats.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAwGhE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;CA4BrC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,WAAW,CAAC,CAAC;AAE7F,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,eAAe,EAAE,wBAAwB,EAAE,CAAC;IAC5C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC,CA2GD;AAkBD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,KAAK,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAMD"}

package/dist/tools/getRecommendedStats.js

@@ -0,0 +1,251 @@
+/**
+ * 추천 통계 도구
+ * 분야별 관련 통계표를 추천
+ */
+import { z } from 'zod';
+import { getKosisClient } from '../api/client.js';
+import { getCacheManager } from '../cache/index.js';
+/**
+ * 토픽별 핵심 통계 테이블 ID
+ * - 일반 사용자가 가장 먼저 보고 싶어하는 대표 통계
+ * - 검색 결과보다 우선 표시
+ */
+const PRIORITY_TABLES = {
+    population: [
+        { orgId: '101', tableId: 'DT_1B04005', name: '시도/성/연령별 주민등록인구' },
+        { orgId: '101', tableId: 'DT_1IN1503', name: '주민등록인구현황' },
+        { orgId: '101', tableId: 'DT_1B8000H', name: '인구동태건수 (출생/사망)' },
+        { orgId: '101', tableId: 'DT_1B81A17', name: '합계출산율' },
+        { orgId: '101', tableId: 'DT_1BPA002', name: '주요인구지표' },
+    ],
+    economy: [
+        { orgId: '301', tableId: 'DT_200Y001', name: '국내총생산(GDP)' },
+        { orgId: '101', tableId: 'DT_1J20001', name: '소비자물가지수' },
+        { orgId: '101', tableId: 'DT_1J22001', name: '소비자물가 등락률' },
+        { orgId: '301', tableId: 'DT_2AS004', name: '경제성장률' },
+    ],
+    employment: [
+        { orgId: '101', tableId: 'DT_1DA7102S', name: '성/연령별 실업률' },
+        { orgId: '101', tableId: 'DT_1DA7001', name: '경제활동인구총괄' },
+        { orgId: '101', tableId: 'DT_1DA7012', name: '취업자수' },
+        { orgId: '118', tableId: 'DT_118N_PAYM02', name: '평균임금' },
+    ],
+    housing: [
+        { orgId: '116', tableId: 'DT_1YL21101', name: '아파트 매매/전세 가격지수' },
+        { orgId: '116', tableId: 'DT_1YL20111E', name: '주택매매가격지수' },
+        { orgId: '101', tableId: 'DT_1YL20001', name: '주택수' },
+    ],
+    education: [
+        { orgId: '101', tableId: 'DT_1YL21121', name: '학생수' },
+        { orgId: '101', tableId: 'DT_1YL21131', name: '학교수' },
+    ],
+    health: [
+        { orgId: '101', tableId: 'DT_1B41', name: '기대수명' },
+        { orgId: '101', tableId: 'DT_1B34E01', name: '사망원인' },
+    ],
+    environment: [
+        { orgId: '106', tableId: 'DT_106N_99_2400001', name: '미세먼지 농도' },
+    ],
+    transport: [
+        { orgId: '101', tableId: 'DT_1YL12001', name: '자동차등록현황' },
+    ],
+    social: [
+        { orgId: '101', tableId: 'DT_1YL13001', name: '범죄발생 현황' },
+    ],
+};
+// 분야별 추천 검색어 및 대표 통계
+const TOPIC_RECOMMENDATIONS = {
+    population: {
+        name: '인구',
+        description: '인구수, 출생, 사망, 혼인, 이혼 등',
+        searchTerms: ['주민등록인구', '출생', '사망', '혼인', '합계출산율'],
+    },
+    economy: {
+        name: '경제',
+        description: 'GDP, 물가, 수출입, 경제성장률 등',
+        searchTerms: ['GDP', '경제성장률', '소비자물가', '수출', '무역수지'],
+    },
+    employment: {
+        name: '고용/노동',
+        description: '취업자, 실업률, 임금, 근로시간 등',
+        searchTerms: ['취업자', '실업률', '고용률', '임금', '근로시간'],
+    },
+    housing: {
+        name: '주거/부동산',
+        description: '주택가격, 전월세, 주거환경 등',
+        searchTerms: ['아파트가격', '전세', '주택매매', '월세', '주거'],
+    },
+    education: {
+        name: '교육',
+        description: '학생수, 학교, 진학률, 사교육비 등',
+        searchTerms: ['학생수', '학교', '진학률', '사교육비', '대학'],
+    },
+    health: {
+        name: '보건/의료',
+        description: '기대수명, 의료비, 건강보험 등',
+        searchTerms: ['기대수명', '의료비', '건강보험', '병원', '사망원인'],
+    },
+    environment: {
+        name: '환경',
+        description: '대기질, 미세먼지, 폐기물, 에너지 등',
+        searchTerms: ['미세먼지', '대기오염', '폐기물', '재활용', '탄소배출'],
+    },
+    transport: {
+        name: '교통',
+        description: '자동차, 대중교통, 도로, 사고 등',
+        searchTerms: ['자동차등록', '대중교통', '교통사고', '도로'],
+    },
+    social: {
+        name: '사회/복지',
+        description: '사회보장, 범죄, 안전, 문화 등',
+        searchTerms: ['사회보장', '범죄', '안전', '문화', '여가'],
+    },
+};
+export const getRecommendedStatsSchema = {
+    name: 'get_recommended_statistics',
+    description: '[추천] 9개 분야(인구/경제/고용/주거/교육/보건/환경/교통/사회) 핵심 통계표 추천 카드. "무엇을 봐야 할지 모를 때" 출발점. 특정 키워드 알면 quick_stats 또는 search_statistics가 직접.',
+    inputSchema: z.object({
+        topic: z
+            .enum([
+            'population',
+            'economy',
+            'employment',
+            'housing',
+            'education',
+            'health',
+            'environment',
+            'transport',
+            'social',
+        ])
+            .describe('관심 분야: population(인구), economy(경제), employment(고용), housing(주거), education(교육), health(보건), environment(환경), transport(교통), social(사회/복지)'),
+        limit: z
+            .number()
+            .min(1)
+            .max(20)
+            .optional()
+            .default(5)
+            .describe('추천 개수 (기본: 5)'),
+    }),
+};
+export async function getRecommendedStats(input) {
+    const client = getKosisClient();
+    const cache = getCacheManager();
+    const topicInfo = TOPIC_RECOMMENDATIONS[input.topic];
+    if (!topicInfo) {
+        return {
+            success: false,
+            topic: { code: input.topic, name: '알 수 없음', description: '' },
+            recommendations: [],
+            relatedTopics: [],
+            searchSuggestions: [],
+        };
+    }
+    try {
+        const recommendations = [];
+        // 1. 먼저 PRIORITY_TABLES에서 핵심 통계 추가
+        const priorityTables = PRIORITY_TABLES[input.topic] || [];
+        for (const table of priorityTables) {
+            if (recommendations.length >= input.limit)
+                break;
+            recommendations.push({
+                orgId: table.orgId,
+                orgName: table.orgId === '101' ? '통계청' : (table.orgId === '301' ? '한국은행' : table.orgId === '116' ? '한국부동산원' : '기타기관'),
+                tableId: table.tableId,
+                tableName: table.name,
+                statisticsName: topicInfo.name + ' 통계',
+                period: '',
+                periodType: '',
+                lastUpdated: '',
+                isPriority: true, // 핵심 통계 표시
+            });
+        }
+        // 2. 핵심 통계로 limit을 못 채웠으면 검색 결과로 보충
+        if (recommendations.length < input.limit) {
+            const searchResults = await cache.getSearchResults({ topic: input.topic, limit: input.limit }, async () => {
+                const allResults = [];
+                for (const term of topicInfo.searchTerms.slice(0, 2)) {
+                    const results = await client.searchStatistics(term, {
+                        sort: 'RANK',
+                        startCount: 1,
+                        resultCount: Math.ceil(input.limit / 2),
+                    });
+                    allResults.push(...results);
+                }
+                return allResults;
+            });
+            // 중복 제거 (이미 추가된 테이블 제외)
+            const addedTableIds = new Set(recommendations.map(r => r.tableId));
+            for (const item of searchResults) {
+                if (recommendations.length >= input.limit)
+                    break;
+                if (addedTableIds.has(item.TBL_ID))
+                    continue;
+                recommendations.push({
+                    orgId: item.ORG_ID,
+                    orgName: item.ORG_NM,
+                    tableId: item.TBL_ID,
+                    tableName: item.TBL_NM,
+                    statisticsName: item.STAT_NM,
+                    period: item.STRT_PRD_DE && item.END_PRD_DE
+                        ? `${item.STRT_PRD_DE}~${item.END_PRD_DE}`
+                        : item.STRT_PRD_DE || item.END_PRD_DE || '',
+                    periodType: item.VW_CD || '',
+                    lastUpdated: item.END_PRD_DE,
+                });
+                addedTableIds.add(item.TBL_ID);
+            }
+        }
+        // 관련 분야 추천
+        const relatedTopics = getRelatedTopics(input.topic);
+        return {
+            success: true,
+            topic: {
+                code: input.topic,
+                name: topicInfo.name,
+                description: topicInfo.description,
+            },
+            recommendations,
+            relatedTopics,
+            searchSuggestions: topicInfo.searchTerms,
+        };
+    }
+    catch (error) {
+        console.error('Recommendation error:', error);
+        return {
+            success: false,
+            topic: {
+                code: input.topic,
+                name: topicInfo.name,
+                description: topicInfo.description,
+            },
+            recommendations: [],
+            relatedTopics: [],
+            searchSuggestions: topicInfo.searchTerms,
+        };
+    }
+}
+function getRelatedTopics(topic) {
+    const relations = {
+        population: ['economy', 'housing', 'social'],
+        economy: ['employment', 'housing', 'transport'],
+        employment: ['economy', 'education', 'social'],
+        housing: ['economy', 'population', 'transport'],
+        education: ['employment', 'social', 'population'],
+        health: ['social', 'environment', 'population'],
+        environment: ['health', 'transport', 'economy'],
+        transport: ['environment', 'housing', 'economy'],
+        social: ['health', 'education', 'population'],
+    };
+    return relations[topic] || [];
+}
+/**
+ * 사용 가능한 분야 목록 반환
+ */
+export function getAvailableTopics() {
+    return Object.entries(TOPIC_RECOMMENDATIONS).map(([code, info]) => ({
+        code,
+        name: info.name,
+        description: info.description,
+    }));
+}
+//# sourceMappingURL=getRecommendedStats.js.map

package/dist/tools/getRecommendedStats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRecommendedStats.js","sourceRoot":"","sources":["../../src/tools/getRecommendedStats.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD;;;;GAIG;AACH,MAAM,eAAe,GAA4E;IAC/F,UAAU,EAAE;QACV,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,iBAAiB,EAAE;QAChE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE;QACzD,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,gBAAgB,EAAE;QAC/D,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE;QACtD,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE;KACxD;IACD,OAAO,EAAE;QACP,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE;QAC3D,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE;QACxD,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE;QAC1D,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE;KACtD;IACD,UAAU,EAAE;QACV,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE;QAC3D,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE;QACzD,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE;QACrD,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE;KAC1D;IACD,OAAO,EAAE;QACP,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,gBAAgB,EAAE;QAChE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE;QAC3D,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,EAAE;KACtD;IACD,SAAS,EAAE;QACT,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,EAAE;QACrD,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,EAAE;KACtD;IACD,MAAM,EAAE;QACN,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE;QAClD,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE;KACtD;IACD,WAAW,EAAE;QACX,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,IAAI,EAAE,SAAS,EAAE;KACjE;IACD,SAAS,EAAE;QACT,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;KAC1D;IACD,MAAM,EAAE;QACN,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;KAC1D;CACF,CAAC;AAEF,qBAAqB;AACrB,MAAM,qBAAqB,GAItB;IACH,UAAU,EAAE;QACV,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,uBAAuB;QACpC,WAAW,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC;KACnD;IACD,OAAO,EAAE;QACP,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,uBAAuB;QACpC,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC;KACrD;IACD,UAAU,EAAE;QACV,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,sBAAsB;QACnC,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC;KACjD;IACD,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,mBAAmB;QAChC,WAAW,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC;KACjD;IACD,SAAS,EAAE;QACT,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,sBAAsB;QACnC,WAAW,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC;KAChD;IACD,MAAM,EAAE;QACN,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,mBAAmB;QAChC,WAAW,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC;KACnD;IACD,WAAW,EAAE;QACX,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,uBAAuB;QACpC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC;KACpD;IACD,SAAS,EAAE;QACT,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,qBAAqB;QAClC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;KAC7C;IACD,MAAM,EAAE;QACN,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,oBAAoB;QACjC,WAAW,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;KAC9C;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,4HAA4H;IAC9H,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,KAAK,EAAE,CAAC;aACL,IAAI,CAAC;YACJ,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,SAAS;YACT,WAAW;YACX,QAAQ;YACR,aAAa;YACb,WAAW;YACX,QAAQ;SACT,CAAC;aACD,QAAQ,CACP,2IAA2I,CAC5I;QACH,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,EAAE,CAAC;aACP,QAAQ,EAAE;aACV,OAAO,CAAC,CAAC,CAAC;aACV,QAAQ,CAAC,eAAe,CAAC;KAC7B,CAAC;CACH,CAAC;AAIF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAA+B;IAY/B,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAEhC,MAAM,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAErD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE;YAC7D,eAAe,EAAE,EAAE;YACnB,aAAa,EAAE,EAAE;YACjB,iBAAiB,EAAE,EAAE;SACtB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,eAAe,GAA+B,EAAE,CAAC;QAEvD,mCAAmC;QACnC,MAAM,cAAc,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1D,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;YACnC,IAAI,eAAe,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK;gBAAE,MAAM;YAEjD,eAAe,CAAC,IAAI,CAAC;gBACnB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;gBACrH,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,cAAc,EAAE,SAAS,CAAC,IAAI,GAAG,KAAK;gBACtC,MAAM,EAAE,EAAE;gBACV,UAAU,EAAE,EAAE;gBACd,WAAW,EAAE,EAAE;gBACf,UAAU,EAAE,IAAI,EAAE,WAAW;aACF,CAAC,CAAC;QACjC,CAAC;QAED,oCAAoC;QACpC,IAAI,eAAe,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;YACzC,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAChD,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,EAC1C,KAAK,IAAI,EAAE;gBACT,MAAM,UAAU,GAAG,EAAE,CAAC;gBACtB,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;oBACrD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;wBAClD,IAAI,EAAE,MAAM;wBACZ,UAAU,EAAE,CAAC;wBACb,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;qBACxC,CAAC,CAAC;oBACH,UAAU,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;gBAC9B,CAAC;gBACD,OAAO,UAAU,CAAC;YACpB,CAAC,CACF,CAAC;YAEF,wBAAwB;YACxB,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;YAEnE,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;gBACjC,IAAI,eAAe,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK;oBAAE,MAAM;gBACjD,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;oBAAE,SAAS;gBAE7C,eAAe,CAAC,IAAI,CAAC;oBACnB,KAAK,EAAE,IAAI,CAAC,MAAM;oBAClB,OAAO,EAAE,IAAI,CAAC,MAAM;oBACpB,OAAO,EAAE,IAAI,CAAC,MAAM;oBACpB,SAAS,EAAE,IAAI,CAAC,MAAM;oBACtB,cAAc,EAAE,IAAI,CAAC,OAAO;oBAC5B,MAAM,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,UAAU;wBACzC,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,UAAU,EAAE;wBAC1C,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,UAAU,IAAI,EAAE;oBAC7C,UAAU,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;oBAC5B,WAAW,EAAE,IAAI,CAAC,UAAU;iBAC7B,CAAC,CAAC;gBAEH,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QAED,WAAW;QACX,MAAM,aAAa,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEpD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,KAAK,CAAC,KAAK;gBACjB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,WAAW,EAAE,SAAS,CAAC,WAAW;aACnC;YACD,eAAe;YACf,aAAa;YACb,iBAAiB,EAAE,SAAS,CAAC,WAAW;SACzC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,KAAK,CAAC,KAAK;gBACjB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,WAAW,EAAE,SAAS,CAAC,WAAW;aACnC;YACD,eAAe,EAAE,EAAE;YACnB,aAAa,EAAE,EAAE;YACjB,iBAAiB,EAAE,SAAS,CAAC,WAAW;SACzC,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,MAAM,SAAS,GAA6B;QAC1C,UAAU,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC;QAC5C,OAAO,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,WAAW,CAAC;QAC/C,UAAU,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC;QAC9C,OAAO,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,WAAW,CAAC;QAC/C,SAAS,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,YAAY,CAAC;QACjD,MAAM,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,YAAY,CAAC;QAC/C,WAAW,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC;QAC/C,SAAS,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,SAAS,CAAC;QAChD,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC;KAC9C,CAAC;IAEF,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAKhC,OAAO,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAClE,IAAI;QACJ,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/tools/getStatisticsData.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 통계 데이터 조회 도구
+ * 특정 통계표의 실제 데이터를 조회
+ */
+import { z } from 'zod';
+import { type ResolveResult } from '../utils/metaLookup.js';
+import type { SimplifiedDataItem } from '../api/types.js';
+export declare const getStatisticsDataSchema: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        orgId: z.ZodString;
+        tableId: z.ZodString;
+        regionName: z.ZodOptional<z.ZodString>;
+        itemName: z.ZodOptional<z.ZodString>;
+        objL1: z.ZodOptional<z.ZodString>;
+        objL2: z.ZodOptional<z.ZodString>;
+        objL3: z.ZodOptional<z.ZodString>;
+        objL4: z.ZodOptional<z.ZodString>;
+        itemId: z.ZodOptional<z.ZodString>;
+        periodType: z.ZodEnum<["Y", "M", "Q", "S", "D", "F", "IR"]>;
+        startPeriod: z.ZodOptional<z.ZodString>;
+        endPeriod: z.ZodOptional<z.ZodString>;
+        recentCount: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        orgId: string;
+        tableId: string;
+        periodType: "Y" | "Q" | "M" | "D" | "S" | "F" | "IR";
+        objL1?: string | undefined;
+        objL2?: string | undefined;
+        objL3?: string | undefined;
+        objL4?: string | undefined;
+        regionName?: string | undefined;
+        itemName?: string | undefined;
+        itemId?: string | undefined;
+        startPeriod?: string | undefined;
+        endPeriod?: string | undefined;
+        recentCount?: number | undefined;
+    }, {
+        orgId: string;
+        tableId: string;
+        periodType: "Y" | "Q" | "M" | "D" | "S" | "F" | "IR";
+        objL1?: string | undefined;
+        objL2?: string | undefined;
+        objL3?: string | undefined;
+        objL4?: string | undefined;
+        regionName?: string | undefined;
+        itemName?: string | undefined;
+        itemId?: string | undefined;
+        startPeriod?: string | undefined;
+        endPeriod?: string | undefined;
+        recentCount?: number | undefined;
+    }>;
+};
+export type GetStatisticsDataInput = z.infer<typeof getStatisticsDataSchema.inputSchema>;
+export declare function getStatisticsData(input: GetStatisticsDataInput): Promise<{
+    success: boolean;
+    tableName?: string;
+    unit?: string;
+    data: SimplifiedDataItem[];
+    totalCount: number;
+    visualization?: {
+        recommendedType: string;
+        reason: string;
+    };
+    metadata?: {
+        orgId: string;
+        tableId: string;
+        periodType: string;
+        periodRange?: string;
+    };
+    resolved?: ResolveResult['resolved'];
+    usageHint?: string;
+}>;
+//# sourceMappingURL=getStatisticsData.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getStatisticsData.d.ts","sourceRoot":"","sources":["../../src/tools/getStatisticsData.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAyC,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACnG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgFnC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,WAAW,CAAC,CAAC;AAEzF,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE;QACd,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,CA+OD"}