korean-stats-mcp 1.4.0

package/dist/tools/quickTrend.js

@@ -0,0 +1,328 @@
+/**
+ * 빠른 추세 분석 도구
+ * 자연어 키워드로 시계열 추세를 간편하게 분석
+ */
+import { z } from 'zod';
+import { getKosisClient } from '../api/client.js';
+import { getCacheManager } from '../cache/index.js';
+import { QUICK_STATS_PARAMS, getQuickStatsParam, getRegionCode, } from '../data/quickStatsParams.js';
+import { findProvinceByDistrict, PROVINCES, AMBIGUOUS_DISTRICTS } from '../utils/regions.js';
+import { analyzeTrend } from '../utils/dataFormatter.js';
+import { extractKeyword, extractDistrictName, extractProvinceName, } from './quickStats.js';
+const DISTRICT_PATTERN = /^[가-힣]{1,4}(구|군|시)$/;
+/**
+ * 자연어 키워드에서 yearCount 추정
+ *
+ * 인식 패턴:
+ *   - "지난/최근 N년", "N년 추세/추이" → N
+ *   - "작년 대비", "전년 대비" → 2
+ *   - "민선 N기" → N*4 (지방선거 임기 4년)
+ *   - "임기 N년" → N
+ *   - "취임 N년", "취임 N년차" → N+1 (취임 시점 포함)
+ *   - "역대", "장기" → 20
+ */
+export function extractYearCount(query) {
+    // "민선 N기" → N*4
+    const minseon = query.match(/민선\s*(\d+)\s*기/);
+    if (minseon) {
+        const term = parseInt(minseon[1], 10);
+        if (term >= 1 && term <= 20)
+            return Math.min(term * 4, 20);
+    }
+    // "지난/최근/근래/요즘 N년" or "N년 추세/추이/변화/대비"
+    const nYears = query.match(/(?:지난|최근|근래|요즘)\s*(\d+)\s*년/) ||
+        query.match(/(\d+)\s*년\s*(?:추세|추이|변화|대비|간)/);
+    if (nYears) {
+        const n = parseInt(nYears[1], 10);
+        if (n >= 2 && n <= 20)
+            return n;
+    }
+    // "임기 N년", "취임 N년차"
+    const imgi = query.match(/(?:임기|취임)\s*(\d+)\s*년/);
+    if (imgi) {
+        const n = parseInt(imgi[1], 10);
+        if (n >= 1 && n <= 20)
+            return Math.min(n + 1, 20); // 비교 위해 +1 시점 포함
+    }
+    // "작년 대비", "전년 대비", "전년동기"
+    if (/(?:작년|전년)\s*(?:대비|동기)/.test(query))
+        return 2;
+    // "역대", "장기"
+    if (/역대|장기/.test(query))
+        return 20;
+    return null;
+}
+export const quickTrendSchema = {
+    name: 'quick_trend',
+    description: `[빠른추세] 자연어 → 시계열 + 증감률 + 최고/최저 + 추세 한 번에 (기본 10년).
+
+🔄 도구 라우팅:
+• "~추세/추이/변화/증감/감소/증가/경향" → 이 도구
+• 단일 시점 수치 → quick_stats
+• 정책 영역(저출산/고령화/주거/일자리) 묶음 추세 → chain_policy_indicator
+• 차원·항목 코드 알면 정밀 분석 → analyze_time_series
+
+■ 자연어 자동 추출: keyword에 "광진구 인구 추이"처럼 통째 넣어도 추출됨
+■ 자치구·시군 → 광역시도 fallback + 안내(자치구별은 fetch_kosis_excel 권장)
+■ 별칭 자동 변환: 저출산→출산율, 고령화→고령인구, population 등
+■ 자연어 기간 자동 추출: "지난 5년", "민선 8기"(=32년→상한 20), "임기 4년차", "작년 대비"(=2), "역대"(=20)
+■ 장래추계 데이터(예: 노령화지수)는 isProjection=true + "추계" 안내 자동 부착`,
+    inputSchema: z.object({
+        keyword: z
+            .string()
+            .describe('통계 키워드만 입력 (추세/감소/증가/변화 등 수식어 제외). 예: "인구", "출산율", "실업률", "GDP", "고령인구"'),
+        region: z
+            .string()
+            .optional()
+            .describe('지역명 (선택, 미지정시 전국). 예: "서울", "부산"'),
+        yearCount: z
+            .number()
+            .min(2)
+            .max(20)
+            .optional()
+            .describe('분석 기간 (년 수). 미지정 시 keyword에서 "지난 N년"·"민선 N기"·"임기 N년차"·"작년 대비" 자연어 자동 추출. 모두 없으면 10.'),
+    }),
+};
+/**
+ * 지역명 목록 (쿼리에서 지역 추출용)
+ */
+const REGION_NAMES = [
+    '서울', '부산', '대구', '인천', '광주', '대전', '울산', '세종', '경기',
+    '강원', '충북', '충남', '전북', '전남', '경북', '경남', '제주'
+];
+export async function quickTrend(input) {
+    const client = getKosisClient();
+    const cache = getCacheManager();
+    try {
+        // 0. 빈 키워드 가드
+        const trimmedKeyword = (input.keyword ?? '').trim();
+        if (!trimmedKeyword) {
+            return {
+                success: false,
+                keyword: input.keyword ?? '',
+                region: '전국',
+                trend: 'stable',
+                trendDescription: '',
+                summary: '추세 분석할 통계 키워드를 입력해주세요.',
+                dataPoints: [],
+                insights: [],
+                note: '예: "인구", "출산율", "실업률", "GDP"',
+            };
+        }
+        // 1. 키워드 추출 (자연어 → 정식 키워드) + 파라미터 조회
+        const extractedKw = extractKeyword(trimmedKeyword);
+        const param = getQuickStatsParam(extractedKw);
+        if (!param) {
+            const supportedKeywords = Object.keys(QUICK_STATS_PARAMS).slice(0, 30).join(', ') + ' 등';
+            return {
+                success: false,
+                keyword: trimmedKeyword,
+                region: '전국',
+                trend: 'stable',
+                trendDescription: '',
+                summary: `"${trimmedKeyword}"에 대한 추세 분석이 지원되지 않습니다.`,
+                dataPoints: [],
+                insights: [],
+                note: `지원 키워드: ${supportedKeywords}`,
+            };
+        }
+        // 2. 지역 결정
+        //   우선순위: input.region > keyword에서 추출한 자치구/광역시도
+        //   자치구는 광역시도로 fallback + 안내
+        let regionName = '전국';
+        let objL1 = param.objL1;
+        let districtNote = null;
+        let requestedRegion = input.region?.trim() || undefined;
+        let detectedDistrict = null;
+        // input.region이 자치구 형식이면 자치구로 격하
+        if (requestedRegion && DISTRICT_PATTERN.test(requestedRegion)) {
+            detectedDistrict = requestedRegion;
+            requestedRegion = undefined;
+        }
+        // input.region 없을 때 keyword에서 자치구/광역시도 자동 추출
+        // 광역시도명도 함께 추출 — 모호한 자치구 disambiguate에 활용
+        let provFromKw = null;
+        if (!requestedRegion && !detectedDistrict) {
+            detectedDistrict = extractDistrictName(trimmedKeyword);
+            provFromKw = extractProvinceName(trimmedKeyword, false);
+            if (!detectedDistrict && provFromKw) {
+                requestedRegion = provFromKw;
+            }
+        }
+        // 자치구 → 광역시도 fallback + 안내 (모호하면 광역시도 컨텍스트로 disambiguate)
+        if (detectedDistrict) {
+            let prov = findProvinceByDistrict(detectedDistrict);
+            if (provFromKw && AMBIGUOUS_DISTRICTS[detectedDistrict]?.includes(provFromKw)) {
+                const candidate = PROVINCES.find((p) => p.shortName === provFromKw);
+                if (candidate)
+                    prov = candidate;
+            }
+            if (prov) {
+                requestedRegion = prov.shortName;
+                districtNote = `💡 "${detectedDistrict}" 자치구 시계열은 quick_trend가 지원하지 않아 ${prov.shortName} 광역시도 추세로 표시했습니다. 자치구별은 fetch_kosis_excel("${detectedDistrict}", "${extractedKw}")로 조회.`;
+            }
+            else if (provFromKw) {
+                requestedRegion = provFromKw;
+                districtNote = `💡 "${detectedDistrict}"은(는) 자치구 매핑이 모호합니다. ${provFromKw} 광역시도 추세로 표시합니다.`;
+            }
+            else {
+                districtNote = `💡 "${detectedDistrict}"은(는) 자치구 매핑이 모호합니다 (여러 광역시도에 동명 자치구 존재 가능). 전국 추세로 표시합니다.`;
+            }
+        }
+        if (requestedRegion && param.regionCodes) {
+            const regionCode = getRegionCode(param, requestedRegion);
+            if (regionCode !== param.objL1) {
+                objL1 = regionCode;
+                regionName = requestedRegion;
+            }
+        }
+        else if (requestedRegion && !param.regionCodes) {
+            return {
+                success: false,
+                keyword: extractedKw,
+                region: requestedRegion,
+                trend: 'stable',
+                trendDescription: '',
+                summary: `"${extractedKw}" 통계는 지역별 추세를 지원하지 않습니다. 전국 데이터만 제공됩니다.`,
+                dataPoints: [],
+                insights: [],
+            };
+        }
+        // 3. 시계열 데이터 조회
+        // 우선순위: input.yearCount 명시 > 키워드 자연어 추출 > default 10
+        const naturalYearCount = extractYearCount(trimmedKeyword);
+        const yearCount = input.yearCount ?? naturalYearCount ?? 10;
+        const results = await cache.getStatisticsData({
+            orgId: param.orgId,
+            tableId: param.tableId,
+            objL1,
+            objL2: param.objL2,
+            itemId: param.itemId,
+            periodType: 'Y',
+            yearCount,
+        }, async () => {
+            return client.getStatisticsData({
+                orgId: param.orgId,
+                tblId: param.tableId,
+                objL1,
+                objL2: param.objL2,
+                itmId: param.itemId,
+                prdSe: 'Y',
+                newEstPrdCnt: yearCount,
+            });
+        });
+        if (results.length < 2) {
+            return {
+                success: false,
+                keyword: extractedKw,
+                region: regionName,
+                trend: 'stable',
+                trendDescription: '',
+                summary: '추세 분석에 필요한 충분한 데이터가 없습니다.',
+                dataPoints: [],
+                insights: [],
+                source: {
+                    orgId: param.orgId,
+                    tableId: param.tableId,
+                    tableName: param.tableName,
+                },
+            };
+        }
+        // 4. 데이터 정렬 및 분석
+        const sortedData = results
+            .map((r) => ({
+            year: r.PRD_DE,
+            value: parseFloat(r.DT.replace(/,/g, '')) || 0,
+            formatted: r.DT,
+        }))
+            .sort((a, b) => a.year.localeCompare(b.year));
+        const values = sortedData.map((d) => d.value);
+        const { trend, avgGrowthRate, volatility } = analyzeTrend(values);
+        // 5. 변화율 계산
+        const dataPoints = sortedData.map((d, i) => {
+            if (i === 0) {
+                return { ...d };
+            }
+            const prevValue = sortedData[i - 1].value;
+            const changeRate = prevValue !== 0
+                ? ((d.value - prevValue) / Math.abs(prevValue) * 100).toFixed(1)
+                : '0';
+            return {
+                ...d,
+                changeRate: `${parseFloat(changeRate) >= 0 ? '+' : ''}${changeRate}%`,
+            };
+        });
+        // 6. 추세 설명 생성
+        const trendDescriptions = {
+            increasing: '지속적인 상승 추세',
+            decreasing: '지속적인 하락 추세',
+            stable: '안정적인 흐름',
+            fluctuating: '변동이 큰 불안정한 흐름',
+        };
+        // 7. 최고/최저점 찾기
+        const maxIdx = values.indexOf(Math.max(...values));
+        const minIdx = values.indexOf(Math.min(...values));
+        const firstValue = values[0];
+        const lastValue = values[values.length - 1];
+        const totalChange = firstValue !== 0
+            ? ((lastValue - firstValue) / Math.abs(firstValue) * 100).toFixed(1)
+            : '0';
+        // 8. 인사이트 생성
+        const insights = [];
+        const trendEmoji = trend === 'increasing' ? '📈' : trend === 'decreasing' ? '📉' : '📊';
+        insights.push(`${trendEmoji} **추세**: ${trendDescriptions[trend]}`);
+        insights.push(`📊 **평균 변화율**: ${avgGrowthRate >= 0 ? '+' : ''}${avgGrowthRate.toFixed(1)}%/년`);
+        insights.push(`🔝 **최고점**: ${sortedData[maxIdx].year}년 (${sortedData[maxIdx].formatted}${param.unit})`);
+        insights.push(`🔻 **최저점**: ${sortedData[minIdx].year}년 (${sortedData[minIdx].formatted}${param.unit})`);
+        insights.push(`📅 **전체 변화**: ${sortedData[0].year}→${sortedData[sortedData.length - 1].year}년, ${parseFloat(totalChange) >= 0 ? '+' : ''}${totalChange}%`);
+        if (volatility > 20) {
+            insights.push(`⚠️ **주의**: 변동성이 높습니다 (${volatility.toFixed(1)}%)`);
+        }
+        // 9. 추계 데이터 안내 (장래추계 테이블이면 모든 데이터포인트가 미래연도)
+        const projectionNote = param.isProjection
+            ? `⚠️ 본 시계열은 통계청 장래추계 데이터입니다 (실측 아닌 미래 추계). 정책·보고 인용 시 "추계" 명시 권장.`
+            : null;
+        // 10. 요약 생성
+        const summary = `${regionName}의 ${param.description} ${sortedData.length}년 추세: ${trendDescriptions[trend]}입니다. ` +
+            `${sortedData[0].year}년 ${sortedData[0].formatted}${param.unit}에서 ` +
+            `${sortedData[sortedData.length - 1].year}년 ${sortedData[sortedData.length - 1].formatted}${param.unit}로 ` +
+            `${parseFloat(totalChange) >= 0 ? '증가' : '감소'}했습니다 (${parseFloat(totalChange) >= 0 ? '+' : ''}${totalChange}%).\n\n` +
+            `📊 출처: ${param.tableName} (KOSIS)` +
+            (districtNote ? `\n\n${districtNote}` : '') +
+            (projectionNote ? `\n\n${projectionNote}` : '');
+        const combinedNote = [districtNote, projectionNote].filter(Boolean).join(' / ');
+        return {
+            success: true,
+            keyword: extractedKw,
+            region: regionName,
+            trend,
+            trendDescription: trendDescriptions[trend],
+            summary,
+            dataPoints,
+            insights,
+            source: {
+                orgId: param.orgId,
+                tableId: param.tableId,
+                tableName: param.tableName,
+            },
+            ...(param.isProjection ? { isProjection: true } : {}),
+            ...(combinedNote ? { note: combinedNote } : {}),
+        };
+    }
+    catch (error) {
+        console.error('Quick trend error:', error);
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            keyword: input.keyword,
+            region: input.region || '전국',
+            trend: 'stable',
+            trendDescription: '',
+            summary: `추세 분석 중 오류가 발생했습니다: ${errorMessage}`,
+            dataPoints: [],
+            insights: [],
+            note: `analyze_time_series를 직접 사용해보세요.`,
+        };
+    }
+}
+//# sourceMappingURL=quickTrend.js.map

package/dist/tools/quickTrend.js.map

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

package/dist/tools/searchStatistics.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 통계 검색 도구
+ * 키워드로 KOSIS 통계표를 검색
+ */
+import { z } from 'zod';
+import type { SimplifiedStatisticsItem } from '../api/types.js';
+export declare const searchStatisticsSchema: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        query: z.ZodString;
+        orgId: z.ZodOptional<z.ZodString>;
+        sort: z.ZodDefault<z.ZodOptional<z.ZodEnum<["RANK", "DATE"]>>>;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        sort: "RANK" | "DATE";
+        query: string;
+        limit: number;
+        orgId?: string | undefined;
+    }, {
+        query: string;
+        orgId?: string | undefined;
+        sort?: "RANK" | "DATE" | undefined;
+        limit?: number | undefined;
+    }>;
+};
+export type SearchStatisticsInput = z.infer<typeof searchStatisticsSchema.inputSchema>;
+export declare function searchStatistics(input: SearchStatisticsInput): Promise<{
+    success: boolean;
+    totalCount: number;
+    results: SimplifiedStatisticsItem[];
+    queryAnalysis?: {
+        topics: string[];
+        regions: string[];
+        intent: string;
+        district?: string;
+        province?: string;
+    };
+    suggestions?: string[];
+}>;
+//# sourceMappingURL=searchStatistics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"searchStatistics.d.ts","sourceRoot":"","sources":["../../src/tools/searchStatistics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AA+FhE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;CAyBlC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,WAAW,CAAC,CAAC;AAEvF,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,aAAa,CAAC,EAAE;QACd,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC,CA4KD"}