korean-stats-mcp 1.4.0

package/dist/tools/searchStatistics.js

@@ -0,0 +1,318 @@
+/**
+ * 통계 검색 도구
+ * 키워드로 KOSIS 통계표를 검색
+ */
+import { z } from 'zod';
+import { getKosisClient } from '../api/client.js';
+import { getCacheManager } from '../cache/index.js';
+import { parseQuery, generateSearchTerms, REGION_NAMES } from '../utils/queryParser.js';
+import { detectRegion, isProvinceBaseStat } from '../utils/regions.js';
+/**
+ * 키워드별 우선 표시 테이블 ID
+ * - 검색 결과에서 이 테이블들이 있으면 상위로 배치
+ * - 일반 사용자가 가장 기대하는 결과를 먼저 보여주기 위함
+ */
+const PRIORITY_TABLES = {
+    // 인구 관련
+    '인구': ['DT_1B04005', 'DT_1IN1503', 'DT_1YL20001', 'DT_1B8000F'],
+    '인구수': ['DT_1B04005', 'DT_1IN1503'],
+    '총인구': ['DT_1B04005', 'DT_1IN1503', 'DT_1YL20001'],
+    '주민등록인구': ['DT_1B04005', 'DT_1IN1503'],
+    '인구현황': ['DT_1B04005', 'DT_1IN1503'],
+    // 주거/부동산 관련
+    '집값': ['DT_1YL21101', 'DT_1YL20111E'],
+    '주택가격': ['DT_1YL21101', 'DT_1YL20111E'],
+    '아파트': ['DT_1YL21101', 'DT_1YL20111E'],
+    '아파트가격': ['DT_1YL21101'],
+    '전세': ['DT_1YL21101', 'DT_1YL20111E'],
+    '매매': ['DT_1YL21101', 'DT_1YL20111E'],
+    '부동산': ['DT_1YL21101', 'DT_1YL20111E'],
+    // 고용 관련
+    '실업률': ['DT_1DA7102S', 'DT_1DA7001'],
+    '실업': ['DT_1DA7102S', 'DT_1DA7001'],
+    '취업': ['DT_1DA7001', 'DT_1DA7012'],
+    '고용률': ['DT_1DA7001', 'DT_1DA7012'],
+    // 경제 관련
+    'GDP': ['DT_2AS004', 'DT_2AS003'],
+    '국내총생산': ['DT_2AS004', 'DT_2AS003'],
+    '경제성장': ['DT_2AS004', 'DT_2AS003'],
+    '물가': ['DT_1J22001', 'DT_1J20001'],
+    '소비자물가': ['DT_1J22001', 'DT_1J20001'],
+    // 출산/사망 관련
+    '출산율': ['DT_1B81A17', 'DT_1B8000H'],
+    '합계출산율': ['DT_1B81A17'],
+    '출생': ['DT_1B8000H', 'DT_1B8000F'],
+    '사망': ['DT_1B8000H', 'DT_1B8000F'],
+};
+/**
+ * 검색어 동의어 사전
+ * - 다양한 표현을 표준 검색어로 통일
+ */
+const SYNONYMS = {
+    '인구': ['인구수', '총인구', '주민등록인구', '인구현황', '인구통계'],
+    '집값': ['주택가격', '아파트값', '부동산가격', '집가격', '아파트가격'],
+    '월급': ['임금', '급여', '소득', '평균임금', '월소득'],
+    '실업률': ['실업', '실업자', '실업자수'],
+    '물가': ['소비자물가', '물가지수', 'CPI'],
+};
+/**
+ * 검색 결과에 우선 테이블이 없을 때 직접 삽입할 폴백 테이블
+ * - KOSIS API 검색이 핵심 통계를 반환하지 않을 때 사용
+ */
+const FALLBACK_TABLES = {
+    '인구': [
+        { ORG_ID: '101', ORG_NM: '통계청', TBL_ID: 'DT_1B04005', TBL_NM: '시도/성/연령별 주민등록인구', STAT_ID: 'DT_1B04005', STAT_NM: '주민등록인구현황', VW_CD: 'MT_ZTITLE' },
+        { ORG_ID: '101', ORG_NM: '통계청', TBL_ID: 'DT_1IN1503', TBL_NM: '주민등록인구현황(시군구)', STAT_ID: 'DT_1IN1503', STAT_NM: '주민등록인구현황', VW_CD: 'MT_ZTITLE' },
+    ],
+    '집값': [
+        { ORG_ID: '116', ORG_NM: '한국부동산원', TBL_ID: 'DT_1YL21101', TBL_NM: '아파트 매매/전세 가격지수', STAT_ID: 'DT_1YL21101', STAT_NM: '부동산통계', VW_CD: 'MT_ZTITLE' },
+        { ORG_ID: '116', ORG_NM: '한국부동산원', TBL_ID: 'DT_1YL20111E', TBL_NM: '주택매매가격지수', STAT_ID: 'DT_1YL20111E', STAT_NM: '부동산통계', VW_CD: 'MT_ZTITLE' },
+    ],
+    '실업률': [
+        { ORG_ID: '101', ORG_NM: '통계청', TBL_ID: 'DT_1DA7102S', TBL_NM: '성/연령별 실업률', STAT_ID: 'DT_1DA7102S', STAT_NM: '경제활동인구조사', VW_CD: 'MT_ZTITLE' },
+        { ORG_ID: '101', ORG_NM: '통계청', TBL_ID: 'DT_1DA7001', TBL_NM: '경제활동인구총괄', STAT_ID: 'DT_1DA7001', STAT_NM: '경제활동인구조사', VW_CD: 'MT_ZTITLE' },
+    ],
+    'GDP': [
+        { ORG_ID: '301', ORG_NM: '한국은행', TBL_ID: 'DT_200Y001', TBL_NM: '국내총생산(GDP)', STAT_ID: 'DT_200Y001', STAT_NM: '국민계정', VW_CD: 'MT_OTITLE' },
+        { ORG_ID: '301', ORG_NM: '한국은행', TBL_ID: 'DT_2AS004', TBL_NM: '경제성장률', STAT_ID: 'DT_2AS004', STAT_NM: '국민계정', VW_CD: 'MT_OTITLE' },
+    ],
+    '물가': [
+        { ORG_ID: '101', ORG_NM: '통계청', TBL_ID: 'DT_1J22001', TBL_NM: '소비자물가 등락률', STAT_ID: 'DT_1J22001', STAT_NM: '소비자물가조사', VW_CD: 'MT_ZTITLE' },
+        { ORG_ID: '101', ORG_NM: '통계청', TBL_ID: 'DT_1J20001', TBL_NM: '소비자물가지수', STAT_ID: 'DT_1J20001', STAT_NM: '소비자물가조사', VW_CD: 'MT_ZTITLE' },
+    ],
+    '출산율': [
+        { ORG_ID: '101', ORG_NM: '통계청', TBL_ID: 'DT_1B81A17', TBL_NM: '합계출산율', STAT_ID: 'DT_1B81A17', STAT_NM: '인구동향조사', VW_CD: 'MT_ZTITLE' },
+        { ORG_ID: '101', ORG_NM: '통계청', TBL_ID: 'DT_1B8000H', TBL_NM: '인구동태건수(출생/사망)', STAT_ID: 'DT_1B8000H', STAT_NM: '인구동향조사', VW_CD: 'MT_ZTITLE' },
+    ],
+};
+export const searchStatisticsSchema = {
+    name: 'search_statistics',
+    description: '[검색] 키워드로 KOSIS 통계표 검색 → orgId/tableId 메타 획득 (직접 데이터 조회 전 단계). 자치구·시군은 광역시도 기본통계 시리즈로 자동 라우팅(Path A/B/C). 단일 수치/추세는 quick_stats / quick_trend가 더 빠름. 분야는 알지만 통계표를 모르면 get_statistics_list(recommendedTopic).',
+    inputSchema: z.object({
+        query: z
+            .string()
+            .describe('검색어 (예: 인구, 경제성장률, 출생률, 서울 실업률)'),
+        orgId: z
+            .string()
+            .optional()
+            .describe('기관코드 (선택, 예: 101=통계청)'),
+        sort: z
+            .enum(['RANK', 'DATE'])
+            .optional()
+            .default('RANK')
+            .describe('정렬: RANK(정확도순), DATE(최신순)'),
+        limit: z
+            .number()
+            .min(1)
+            .max(50)
+            .optional()
+            .default(10)
+            .describe('결과 개수 (기본: 10, 최대: 50)'),
+    }),
+};
+export async function searchStatistics(input) {
+    const client = getKosisClient();
+    const cache = getCacheManager();
+    // 쿼리 분석
+    const parsed = parseQuery(input.query);
+    const searchTerms = generateSearchTerms(parsed, input.query);
+    // 지역명 추출 (결과 필터링용)
+    const regionNames = parsed.regions.map(code => REGION_NAMES[code]).filter(Boolean);
+    const hasRegion = regionNames.length > 0;
+    // 자치구·시·군 감지 → 「OO광역시도 기본통계」시리즈 라우팅
+    const detected = detectRegion(input.query);
+    const districtName = detected.district;
+    const provinceOrgId = detected.province?.orgId;
+    // 명시적 orgId 우선, 없으면 자치구 감지 결과 활용
+    const effectiveOrgId = input.orgId ?? provinceOrgId;
+    // 검색어 결정 - 지역이 있으면 조합 검색어 우선, 없으면 원본 쿼리
+    const searchWord = searchTerms.length > 0 ? searchTerms[0] : input.query;
+    try {
+        // 캐시된 검색 결과 조회
+        let results = await cache.getSearchResults({ query: searchWord, orgId: effectiveOrgId, sort: input.sort }, async () => {
+            return client.searchStatistics(searchWord, {
+                orgId: effectiveOrgId,
+                sort: input.sort,
+                startCount: 1,
+                resultCount: input.limit ? input.limit * 2 : 20, // 지역 필터링을 위해 더 많이 조회
+            });
+        });
+        // 검색 결과 후처리 - 우선 테이블 상위 배치
+        // 1. 검색어에서 우선 테이블 ID 추출
+        const priorityTableIds = getPriorityTableIds(input.query);
+        // 2. 검색 결과에 우선 테이블이 없으면 폴백 테이블 삽입
+        const existingTableIds = new Set(results.map(r => r.TBL_ID));
+        const hasPriorityTable = priorityTableIds.some(id => existingTableIds.has(id));
+        if (!hasPriorityTable) {
+            // 폴백 테이블 가져오기
+            const fallbackTables = getFallbackTables(input.query);
+            if (fallbackTables.length > 0) {
+                // 폴백 테이블을 맨 앞에 추가 (중복 제거)
+                const newTables = fallbackTables.filter(t => !existingTableIds.has(t.TBL_ID));
+                results = [...newTables, ...results];
+            }
+        }
+        if (results.length > 0) {
+            // 3. 결과 정렬 - 우선 테이블과 지역명 고려
+            results = results.sort((a, b) => {
+                // 자치구 감지 시: 해당 광역시도 「기본통계」 시리즈 (DT_2xx004_*) 최우선
+                if (districtName && provinceOrgId) {
+                    const aIsBase = isProvinceBaseStat(a.ORG_ID, a.TBL_ID) != null;
+                    const bIsBase = isProvinceBaseStat(b.ORG_ID, b.TBL_ID) != null;
+                    if (aIsBase && !bIsBase)
+                        return -1;
+                    if (!aIsBase && bIsBase)
+                        return 1;
+                }
+                // 우선 테이블 점수 계산 (낮을수록 우선)
+                const aPriority = getPriorityScore(a.TBL_ID, priorityTableIds);
+                const bPriority = getPriorityScore(b.TBL_ID, priorityTableIds);
+                // 우선 테이블 점수가 다르면 그걸로 정렬
+                if (aPriority !== bPriority) {
+                    return aPriority - bPriority;
+                }
+                // 지역이 있는 경우 지역명 포함 여부로 2차 정렬
+                if (hasRegion) {
+                    const aHasRegion = regionNames.some(region => (a.TBL_NM || '').includes(region) ||
+                        (a.STAT_NM || '').includes(region));
+                    const bHasRegion = regionNames.some(region => (b.TBL_NM || '').includes(region) ||
+                        (b.STAT_NM || '').includes(region));
+                    if (aHasRegion && !bHasRegion)
+                        return -1;
+                    if (!aHasRegion && bHasRegion)
+                        return 1;
+                }
+                // 테이블명에 검색 키워드가 직접 포함된 경우 우선
+                const queryKeywords = input.query.split(/\s+/).filter(k => k.length > 1);
+                const aHasKeyword = queryKeywords.some(k => (a.TBL_NM || '').includes(k));
+                const bHasKeyword = queryKeywords.some(k => (b.TBL_NM || '').includes(k));
+                if (aHasKeyword && !bHasKeyword)
+                    return -1;
+                if (!aHasKeyword && bHasKeyword)
+                    return 1;
+                return 0;
+            });
+        }
+        // 결과 개수 제한 (정렬 후 상위 N개만)
+        const limitedResults = results.slice(0, input.limit || 10);
+        // 결과 간소화
+        // API 응답 필드: ORG_ID, ORG_NM, TBL_ID, TBL_NM, STAT_NM, STRT_PRD_DE, END_PRD_DE, VW_CD 등
+        const simplifiedResults = limitedResults.map((item) => ({
+            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,
+        }));
+        // 후속 질문 제안
+        const suggestions = [];
+        if (simplifiedResults.length > 0) {
+            const firstResult = simplifiedResults[0];
+            if (districtName) {
+                suggestions.push(`"${firstResult.tableName}"에서 ${districtName} 데이터 조회 (regionName="${districtName}")`);
+            }
+            else {
+                suggestions.push(`"${firstResult.tableName}"의 최근 데이터 조회`, `${firstResult.orgName}의 다른 통계 검색`);
+            }
+            if (parsed.regions.length === 0 && !districtName) {
+                suggestions.push('서울, 부산 등 지역별 데이터 비교');
+            }
+            if (!parsed.timeRange) {
+                suggestions.push('최근 5년 추세 분석');
+            }
+        }
+        return {
+            success: true,
+            totalCount: simplifiedResults.length,
+            results: simplifiedResults,
+            queryAnalysis: {
+                topics: parsed.topics,
+                regions: parsed.regions,
+                intent: parsed.intent,
+                district: districtName,
+                province: detected.province?.fullName,
+            },
+            suggestions,
+        };
+    }
+    catch (error) {
+        console.error('Search error:', error);
+        return {
+            success: false,
+            totalCount: 0,
+            results: [],
+            queryAnalysis: {
+                topics: parsed.topics,
+                regions: parsed.regions,
+                intent: parsed.intent,
+            },
+        };
+    }
+}
+/**
+ * 검색어에서 우선 배치해야 할 테이블 ID 목록 추출
+ */
+function getPriorityTableIds(query) {
+    const tableIds = [];
+    // 1. 직접 매칭되는 키워드 확인
+    for (const [keyword, ids] of Object.entries(PRIORITY_TABLES)) {
+        if (query.includes(keyword)) {
+            tableIds.push(...ids);
+        }
+    }
+    // 2. 동의어 확인
+    for (const [standard, synonyms] of Object.entries(SYNONYMS)) {
+        if (synonyms.some(syn => query.includes(syn))) {
+            // 동의어가 매칭되면 표준 키워드의 우선 테이블 추가
+            if (PRIORITY_TABLES[standard]) {
+                tableIds.push(...PRIORITY_TABLES[standard]);
+            }
+        }
+    }
+    // 중복 제거
+    return [...new Set(tableIds)];
+}
+/**
+ * 테이블 ID의 우선순위 점수 계산
+ * - 우선 목록에 있으면 순서대로 낮은 점수 (0, 1, 2...)
+ * - 없으면 높은 점수 (1000)
+ */
+function getPriorityScore(tableId, priorityTableIds) {
+    const index = priorityTableIds.indexOf(tableId);
+    return index >= 0 ? index : 1000;
+}
+/**
+ * 검색어에 해당하는 폴백 테이블 가져오기
+ * - 직접 매칭 및 동의어 매칭 지원
+ */
+function getFallbackTables(query) {
+    const tables = [];
+    // 1. 직접 매칭
+    for (const [keyword, fallbacks] of Object.entries(FALLBACK_TABLES)) {
+        if (query.includes(keyword)) {
+            tables.push(...fallbacks);
+        }
+    }
+    // 2. 동의어 매칭
+    for (const [standard, synonyms] of Object.entries(SYNONYMS)) {
+        if (synonyms.some(syn => query.includes(syn))) {
+            if (FALLBACK_TABLES[standard]) {
+                tables.push(...FALLBACK_TABLES[standard]);
+            }
+        }
+    }
+    // 중복 제거
+    const seen = new Set();
+    return tables.filter(t => {
+        if (seen.has(t.TBL_ID))
+            return false;
+        seen.add(t.TBL_ID);
+        return true;
+    });
+}
+//# sourceMappingURL=searchStatistics.js.map

package/dist/tools/searchStatistics.js.map

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

package/dist/utils/dataFormatter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 데이터 포매팅 유틸리티
+ */
+import type { StatisticsDataItem, SimplifiedDataItem } from '../api/types.js';
+/**
+ * 통계 데이터 간소화
+ */
+export declare function simplifyStatisticsData(items: StatisticsDataItem[]): SimplifiedDataItem[];
+/**
+ * 시점 포매팅
+ */
+export declare function formatPeriod(period: string, periodType: string): string;
+/**
+ * 숫자 포매팅
+ */
+export declare function formatNumber(value: string): string;
+/**
+ * 변화율 계산
+ */
+export declare function calculateChangeRate(current: number, previous: number): {
+    rate: number;
+    direction: 'up' | 'down' | 'stable';
+    formatted: string;
+};
+/**
+ * 추세 분석
+ */
+export declare function analyzeTrend(values: number[]): {
+    trend: 'increasing' | 'decreasing' | 'stable' | 'fluctuating';
+    avgGrowthRate: number;
+    volatility: number;
+};
+/**
+ * 시각화 타입 추천
+ */
+export declare function recommendVisualization(dataLength: number, hasMultipleCategories: boolean, isTimeSeries: boolean): {
+    type: 'bar' | 'line' | 'pie' | 'table';
+    reason: string;
+};
+//# sourceMappingURL=dataFormatter.d.ts.map

package/dist/utils/dataFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataFormatter.d.ts","sourceRoot":"","sources":["../../src/utils/dataFormatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE9E;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,kBAAkB,EAAE,GAC1B,kBAAkB,EAAE,CAQtB;AAkBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAevE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWlD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf;IACD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB,CAWA;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EAAE,GACf;IACD,KAAK,EAAE,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAuCA;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,qBAAqB,EAAE,OAAO,EAC9B,YAAY,EAAE,OAAO,GACpB;IACD,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB,CA0BA"}

package/dist/utils/dataFormatter.js

@@ -0,0 +1,142 @@
+/**
+ * 데이터 포매팅 유틸리티
+ */
+/**
+ * 통계 데이터 간소화
+ */
+export function simplifyStatisticsData(items) {
+    return items.map((item) => ({
+        period: formatPeriod(item.PRD_DE, item.PRD_SE),
+        value: formatNumber(item.DT),
+        classification: getClassificationName(item),
+        item: item.ITM_NM,
+        unit: item.UNIT_NM,
+    }));
+}
+/**
+ * 분류명 추출
+ */
+function getClassificationName(item) {
+    const names = [];
+    for (let i = 1; i <= 8; i++) {
+        const name = item[`C${i}_NM`];
+        if (name) {
+            names.push(name);
+        }
+    }
+    return names.join(' > ') || '-';
+}
+/**
+ * 시점 포매팅
+ */
+export function formatPeriod(period, periodType) {
+    if (!period)
+        return '-';
+    switch (periodType) {
+        case 'Y':
+            return `${period}년`;
+        case 'Q':
+            return `${period.slice(0, 4)}년 ${period.slice(4)}분기`;
+        case 'M':
+            return `${period.slice(0, 4)}년 ${parseInt(period.slice(4), 10)}월`;
+        case 'D':
+            return `${period.slice(0, 4)}.${period.slice(4, 6)}.${period.slice(6)}`;
+        default:
+            return period;
+    }
+}
+/**
+ * 숫자 포매팅
+ */
+export function formatNumber(value) {
+    if (!value || value === '-' || value === '...')
+        return value;
+    // 숫자가 아닌 경우 그대로 반환
+    const num = parseFloat(value.replace(/,/g, ''));
+    if (isNaN(num))
+        return value;
+    // 천 단위 구분자 추가
+    return num.toLocaleString('ko-KR', {
+        maximumFractionDigits: 2,
+    });
+}
+/**
+ * 변화율 계산
+ */
+export function calculateChangeRate(current, previous) {
+    if (previous === 0) {
+        return { rate: 0, direction: 'stable', formatted: '-' };
+    }
+    const rate = ((current - previous) / Math.abs(previous)) * 100;
+    const direction = rate > 0.1 ? 'up' : rate < -0.1 ? 'down' : 'stable';
+    const sign = rate > 0 ? '+' : '';
+    const formatted = `${sign}${rate.toFixed(1)}%`;
+    return { rate, direction, formatted };
+}
+/**
+ * 추세 분석
+ */
+export function analyzeTrend(values) {
+    if (values.length < 2) {
+        return { trend: 'stable', avgGrowthRate: 0, volatility: 0 };
+    }
+    // 변화율 계산
+    const changes = [];
+    for (let i = 1; i < values.length; i++) {
+        if (values[i - 1] !== 0) {
+            changes.push((values[i] - values[i - 1]) / Math.abs(values[i - 1]) * 100);
+        }
+    }
+    if (changes.length === 0) {
+        return { trend: 'stable', avgGrowthRate: 0, volatility: 0 };
+    }
+    // 평균 변화율
+    const avgGrowthRate = changes.reduce((a, b) => a + b, 0) / changes.length;
+    // 변동성 (표준편차)
+    const variance = changes.reduce((sum, val) => sum + Math.pow(val - avgGrowthRate, 2), 0) /
+        changes.length;
+    const volatility = Math.sqrt(variance);
+    // 추세 판단
+    let trend;
+    if (volatility > 20) {
+        trend = 'fluctuating';
+    }
+    else if (avgGrowthRate > 2) {
+        trend = 'increasing';
+    }
+    else if (avgGrowthRate < -2) {
+        trend = 'decreasing';
+    }
+    else {
+        trend = 'stable';
+    }
+    return { trend, avgGrowthRate, volatility };
+}
+/**
+ * 시각화 타입 추천
+ */
+export function recommendVisualization(dataLength, hasMultipleCategories, isTimeSeries) {
+    if (isTimeSeries && dataLength > 2) {
+        return {
+            type: 'line',
+            reason: '시계열 데이터는 선 그래프로 추세를 파악하기 좋습니다.',
+        };
+    }
+    if (hasMultipleCategories && dataLength <= 6) {
+        return {
+            type: 'pie',
+            reason: '비율 비교는 파이 차트가 적합합니다.',
+        };
+    }
+    if (dataLength <= 10) {
+        return {
+            type: 'bar',
+            reason: '항목 비교는 막대 그래프가 효과적입니다.',
+        };
+    }
+    return {
+        type: 'table',
+        reason: '데이터가 많아 표 형식이 가장 적합합니다.',
+    };
+}
+//# sourceMappingURL=dataFormatter.js.map

package/dist/utils/dataFormatter.js.map

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

package/dist/utils/errorHandler.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 에러 처리 유틸리티
+ */
+export declare enum ErrorCode {
+    INVALID_API_KEY = "INVALID_API_KEY",
+    RATE_LIMIT_EXCEEDED = "RATE_LIMIT_EXCEEDED",
+    INVALID_PARAMETER = "INVALID_PARAMETER",
+    NO_DATA_FOUND = "NO_DATA_FOUND",
+    API_UNAVAILABLE = "API_UNAVAILABLE",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+/**
+ * 사용자 친화적 에러 메시지 반환
+ */
+export declare function getErrorMessage(code: ErrorCode | string): string;
+/**
+ * 에러를 안전하게 처리하고 결과 반환
+ */
+export declare function handleToolError(error: unknown): {
+    success: false;
+    error: string;
+    code: string;
+};
+/**
+ * 재시도 래퍼 함수
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: {
+    maxRetries?: number;
+    baseDelay?: number;
+    maxDelay?: number;
+}): Promise<T>;
+//# sourceMappingURL=errorHandler.d.ts.map

package/dist/utils/errorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/utils/errorHandler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,SAAS;IACnB,eAAe,oBAAoB;IACnC,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;IACvC,aAAa,kBAAkB;IAC/B,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;CAChC;AAmBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG;IAC/C,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CA0BA;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,GACL,OAAO,CAAC,CAAC,CAAC,CAyBZ"}