korean-stats-mcp 1.4.0

package/dist/tools/chains.d.ts

@@ -0,0 +1,197 @@
+/**
+ * 체인 도구 — 여러 도구를 묶어 공무원 업무용 종합 브리핑 생성
+ *
+ * 설계 원칙 (korean-law-mcp의 chains 패턴 차용):
+ *   - 단일 자연어 호출로 여러 quickStats / quickTrend 병렬 실행
+ *   - 결과를 카드/매트릭스 형태로 정리하여 LLM이 그대로 보고서화 가능
+ *   - 부분 실패 허용 (한 지표 못 가져와도 다른 지표는 표시)
+ */
+import { z } from 'zod';
+export declare const chainRegionBriefSchema: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        region: z.ZodString;
+        includeNational: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["detail", "speech"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        format: "detail" | "speech";
+        region: string;
+        includeNational: boolean;
+    }, {
+        region: string;
+        format?: "detail" | "speech" | undefined;
+        includeNational?: boolean | undefined;
+    }>;
+};
+export type ChainRegionBriefInput = z.infer<typeof chainRegionBriefSchema.inputSchema>;
+export declare function chainRegionBrief(input: ChainRegionBriefInput): Promise<{
+    success: boolean;
+    region: string;
+    format: string;
+    coverage: string;
+    speechLine: string;
+    indicators: {
+        keyword: "인구" | "고령인구" | "출산율" | "실업률" | "고용률" | "월급" | "아파트가격" | "전세가격" | "미세먼지" | "교통사고" | "범죄율" | "GRDP" | "의사수";
+        label: "합계출산율" | "실업률" | "고용률" | "아파트매매가격지수" | "지역내총생산(명목)" | "주택전세가격지수" | "65세 이상 고령인구" | "주민등록 인구" | "월평균 임금" | "인구 천명당 의사수" | "자동차 천대당 교통사고" | "인구 천명당 범죄발생" | "PM2.5 농도";
+        tier: "housing" | "social" | "core" | "econ" | "env";
+        success: any;
+        value: any;
+        unit: any;
+        period: any;
+        source: any;
+        note: any;
+        message: any;
+    }[];
+    fallbackNote: any;
+    national?: undefined;
+    summary?: undefined;
+} | {
+    success: boolean;
+    region: string;
+    format: string;
+    coverage: string;
+    indicators: {
+        keyword: "인구" | "고령인구" | "출산율" | "실업률" | "고용률" | "월급" | "아파트가격" | "전세가격" | "미세먼지" | "교통사고" | "범죄율" | "GRDP" | "의사수";
+        label: "합계출산율" | "실업률" | "고용률" | "아파트매매가격지수" | "지역내총생산(명목)" | "주택전세가격지수" | "65세 이상 고령인구" | "주민등록 인구" | "월평균 임금" | "인구 천명당 의사수" | "자동차 천대당 교통사고" | "인구 천명당 범죄발생" | "PM2.5 농도";
+        tier: "housing" | "social" | "core" | "econ" | "env";
+        success: any;
+        value: any;
+        unit: any;
+        period: any;
+        source: any;
+        note: any;
+        message: any;
+    }[];
+    national: any[] | undefined;
+    summary: string;
+    fallbackNote: any;
+    speechLine?: undefined;
+}>;
+export declare const chainCompareRegionsSchema: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        regions: z.ZodArray<z.ZodString, "many">;
+        keywords: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        regions: string[];
+        keywords: string[];
+    }, {
+        regions: string[];
+        keywords: string[];
+    }>;
+};
+export type ChainCompareRegionsInput = z.infer<typeof chainCompareRegionsSchema.inputSchema>;
+export declare function chainCompareRegions(input: ChainCompareRegionsInput): Promise<{
+    fallbackNotes?: {
+        region: string;
+        note: string;
+    }[] | undefined;
+    success: boolean;
+    regions: string[];
+    keywords: string[];
+    matrix: {
+        region: string;
+        cells: {
+            region: string;
+            keyword: string;
+            value: any;
+            numericValue: number | null;
+            unit: string | null;
+            period: string | null;
+            success: boolean;
+            note?: string | null;
+        }[];
+    }[];
+    insights: ({
+        keyword: string;
+        ranking: never[];
+        note: string;
+        highest?: undefined;
+        lowest?: undefined;
+    } | {
+        keyword: string;
+        highest: {
+            rank: number;
+            region: string;
+            value: any;
+            unit: string | null;
+            period: string | null;
+        };
+        lowest: {
+            rank: number;
+            region: string;
+            value: any;
+            unit: string | null;
+            period: string | null;
+        };
+        ranking: {
+            rank: number;
+            region: string;
+            value: any;
+            unit: string | null;
+            period: string | null;
+        }[];
+        note?: undefined;
+    })[];
+    summary: string;
+}>;
+export declare const chainPolicyIndicatorSchema: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        domain: z.ZodEnum<["lowFertility", "aging", "housing", "jobs", "safety", "health", "economy"]>;
+        region: z.ZodOptional<z.ZodString>;
+        yearCount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        yearCount: number;
+        domain: "economy" | "housing" | "health" | "aging" | "lowFertility" | "jobs" | "safety";
+        region?: string | undefined;
+    }, {
+        domain: "economy" | "housing" | "health" | "aging" | "lowFertility" | "jobs" | "safety";
+        region?: string | undefined;
+        yearCount?: number | undefined;
+    }>;
+};
+export type ChainPolicyIndicatorInput = z.infer<typeof chainPolicyIndicatorSchema.inputSchema>;
+export declare function chainPolicyIndicator(input: ChainPolicyIndicatorInput): Promise<{
+    success: boolean;
+    domain: "고령화" | "저출산" | "경제" | "주거" | "일자리" | "치안·안전" | "보건·의료";
+    domainDescription: "합계출산율·출생아수·혼인건수·평균초혼연령" | "고령인구·노령화지수·기대수명" | "아파트/주택 매매·전세 가격지수" | "실업률·고용률·취업자수·월평균임금" | "범죄율·교통사고·사망률" | "의사수·기대수명·사망률" | "GDP·경제성장률·물가·수출";
+    region: string;
+    yearCount: number;
+    indicators: ({
+        keyword: "출생아수" | "사망률" | "기대수명" | "고령인구" | "혼인건수" | "출산율" | "GDP" | "물가" | "경제성장률" | "수출" | "실업률" | "고용률" | "취업자수" | "월급" | "주택가격" | "아파트가격" | "전세가격" | "교통사고" | "범죄율" | "의사수" | "평균초혼연령" | "노령화지수";
+        region: string;
+        success: boolean;
+        trend: "stable" | "increasing" | "decreasing" | "fluctuating";
+        trendDescription: string;
+        startYear: string;
+        endYear: string;
+        startValue: string;
+        endValue: string;
+        totalChangeRate: string | null;
+        dataPoints: import("./quickTrend.js").TrendDataPoint[];
+        source: string | null;
+        note: string | null;
+        error?: undefined;
+    } | {
+        keyword: "출생아수" | "사망률" | "기대수명" | "고령인구" | "혼인건수" | "출산율" | "GDP" | "물가" | "경제성장률" | "수출" | "실업률" | "고용률" | "취업자수" | "월급" | "주택가격" | "아파트가격" | "전세가격" | "교통사고" | "범죄율" | "의사수" | "평균초혼연령" | "노령화지수";
+        success: boolean;
+        error: string;
+        region?: undefined;
+        trend?: undefined;
+        trendDescription?: undefined;
+        startYear?: undefined;
+        endYear?: undefined;
+        startValue?: undefined;
+        endValue?: undefined;
+        totalChangeRate?: undefined;
+        dataPoints?: undefined;
+        source?: undefined;
+        note?: undefined;
+    })[];
+    summary: string;
+}>;
+//# sourceMappingURL=chains.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../../src/tools/chains.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwBxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;CA4BlC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,WAAW,CAAC,CAAC;AAEvF,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+FlE;AAMD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;CAwBrC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,WAAW,CAAC,CAAC;AAE7F,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB;;;;;;;;;gBAc/C,MAAM;eAAS;oBAV7B,MAAM;qBACL,MAAM;mBACR,GAAG;0BACI,MAAM,GAAG,IAAI;kBACrB,MAAM,GAAG,IAAI;oBACX,MAAM,GAAG,IAAI;qBACZ,OAAO;mBACT,MAAM,GAAG,IAAI;WAGuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6F9C;AA4CD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;CA2BtC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,WAAW,CAAC,CAAC;AAE/F,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0D1E"}

package/dist/tools/chains.js

@@ -0,0 +1,369 @@
+/**
+ * 체인 도구 — 여러 도구를 묶어 공무원 업무용 종합 브리핑 생성
+ *
+ * 설계 원칙 (korean-law-mcp의 chains 패턴 차용):
+ *   - 단일 자연어 호출로 여러 quickStats / quickTrend 병렬 실행
+ *   - 결과를 카드/매트릭스 형태로 정리하여 LLM이 그대로 보고서화 가능
+ *   - 부분 실패 허용 (한 지표 못 가져와도 다른 지표는 표시)
+ */
+import { z } from 'zod';
+import { quickStats } from './quickStats.js';
+import { quickTrend } from './quickTrend.js';
+// ═══════════════════════════════════════════════════════════
+// chain_region_brief — 지역 한장 종합 브리핑
+// ═══════════════════════════════════════════════════════════
+const REGION_BRIEF_INDICATORS = [
+    { key: '인구', label: '주민등록 인구', tier: 'core' },
+    { key: '출산율', label: '합계출산율', tier: 'core' },
+    { key: '고령인구', label: '65세 이상 고령인구', tier: 'core' },
+    { key: '실업률', label: '실업률', tier: 'core' },
+    { key: '고용률', label: '고용률', tier: 'core' },
+    { key: 'GRDP', label: '지역내총생산(명목)', tier: 'econ' },
+    { key: '월급', label: '월평균 임금', tier: 'econ' },
+    { key: '아파트가격', label: '아파트매매가격지수', tier: 'housing' },
+    { key: '전세가격', label: '주택전세가격지수', tier: 'housing' },
+    { key: '의사수', label: '인구 천명당 의사수', tier: 'social' },
+    { key: '교통사고', label: '자동차 천대당 교통사고', tier: 'social' },
+    { key: '범죄율', label: '인구 천명당 범죄발생', tier: 'social' },
+    { key: '미세먼지', label: 'PM2.5 농도', tier: 'env' },
+];
+export const chainRegionBriefSchema = {
+    name: 'chain_region_brief',
+    description: `[⛓체인] 지역 한장 종합 브리핑 — 인구·고용·경제·주거·사회·환경 핵심 13지표 병렬 조회.
+
+🎯 사용 시점: "OO시 통계 보고서", "지역 종합 브리핑", "시정연설/지방의회 답변 준비", "도시 현황 한눈에", "취임사·신년사 한 줄 통계"
+🔄 도구 비교:
+• 단일 지표만 필요 → quick_stats
+• 다지역 비교 매트릭스 → chain_compare_regions
+• 정책 영역 추세 묶음 → chain_policy_indicator
+
+■ 반환: 13개 지표(인구/출산율/고령/실업률/고용률/GRDP/임금/주택/전세/의사수/교통사고/범죄율/미세먼지) + 자치구→광역시도 fallback 자동
+■ format='speech'면 연설용 1줄 요약만 (취임사·신년사·연설문 통계 인용용)
+■ 부분 실패 허용 (지표별 데이터 가용성 상이)`,
+    inputSchema: z.object({
+        region: z
+            .string()
+            .describe('지역명 (예: "서울", "부산", "성남시", "광진구"). 자치구·시군은 광역시도로 자동 fallback.'),
+        includeNational: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe('전국 평균 동시 조회 여부 (지역과 비교용)'),
+        format: z
+            .enum(['detail', 'speech'])
+            .optional()
+            .default('detail')
+            .describe('출력 형식. detail=13지표 전체, speech=상위 5개 한 줄 요약(취임사·신년사용)'),
+    }),
+};
+export async function chainRegionBrief(input) {
+    const { region, includeNational, format } = input;
+    const fetchOne = async (kw, regionArg) => {
+        try {
+            return await quickStats({ query: kw, region: regionArg });
+        }
+        catch (e) {
+            return {
+                success: false,
+                answer: `조회 실패: ${e instanceof Error ? e.message : String(e)}`,
+            };
+        }
+    };
+    const regional = await Promise.all(REGION_BRIEF_INDICATORS.map(async (ind) => {
+        const r = await fetchOne(ind.key, region);
+        return {
+            keyword: ind.key,
+            label: ind.label,
+            tier: ind.tier,
+            success: r.success,
+            value: r.value ?? null,
+            unit: r.unit ?? null,
+            period: r.period ?? null,
+            source: r.source?.tableName ?? null,
+            note: r.note ?? null,
+            message: r.success ? r.answer?.split('\n')[0] : r.answer,
+        };
+    }));
+    let national;
+    if (includeNational) {
+        national = await Promise.all(REGION_BRIEF_INDICATORS.map(async (ind) => {
+            const r = await fetchOne(ind.key);
+            return {
+                keyword: ind.key,
+                label: ind.label,
+                value: r.value ?? null,
+                unit: r.unit ?? null,
+                period: r.period ?? null,
+                success: r.success,
+            };
+        }));
+    }
+    const successCount = regional.filter((r) => r.success).length;
+    const successItems = regional.filter((r) => r.success);
+    const failedItems = regional.filter((r) => !r.success);
+    // 자치구→광역시도 fallback 노트가 있으면 우선 노출 (모든 indicator에 동일 노트가 들어가므로 첫 1개)
+    const districtFallbackNote = regional.find((r) => r.note && r.note.includes('자치구'))?.note ?? null;
+    const otherNote = regional.find((r) => r.note && !r.note.includes('자치구'))?.note ?? null;
+    // speech 형식: 상위 5개 핵심 지표만 한 줄 요약
+    if (format === 'speech') {
+        const speechIndicators = ['인구', '출산율', '고령인구', '실업률', 'GRDP'];
+        const speechLines = successItems
+            .filter((r) => speechIndicators.includes(r.keyword))
+            .map((r) => `${r.label} ${r.value}${r.unit ?? ''}`);
+        return {
+            success: true,
+            region,
+            format: 'speech',
+            coverage: `${successCount}/${REGION_BRIEF_INDICATORS.length} 지표 가용`,
+            speechLine: `${region}의 ${speechLines.join(', ')} (${successItems[0]?.period ?? '-'} 기준).`,
+            indicators: successItems.filter((r) => speechIndicators.includes(r.keyword)),
+            fallbackNote: districtFallbackNote ?? otherNote ?? null,
+        };
+    }
+    return {
+        success: true,
+        region,
+        format: 'detail',
+        coverage: `${successCount}/${REGION_BRIEF_INDICATORS.length} 지표 조회 성공`,
+        indicators: regional,
+        national,
+        summary: `📍 **${region} 종합 브리핑** (${successCount}/${REGION_BRIEF_INDICATORS.length} 지표 가용)\n` +
+            successItems
+                .map((r) => `• ${r.label}: ${r.value}${r.unit ?? ''} (${r.period ?? '-'})`)
+                .join('\n') +
+            (failedItems.length > 0
+                ? `\n\n⚠️ 미가용 지표(${failedItems.length}): ${failedItems.map((r) => r.keyword).join(', ')}`
+                : ''),
+        fallbackNote: districtFallbackNote ??
+            otherNote ??
+            '광역시도 단위 데이터. 자치구별 정밀 데이터는 fetch_kosis_excel 사용.',
+    };
+}
+// ═══════════════════════════════════════════════════════════
+// chain_compare_regions — N지역 × M지표 매트릭스 비교
+// ═══════════════════════════════════════════════════════════
+export const chainCompareRegionsSchema = {
+    name: 'chain_compare_regions',
+    description: `[⛓체인] N개 지역 × M개 지표 매트릭스 비교 — 자연어로 다지역 비교 한 번에.
+
+🎯 사용 시점: "서울/부산/인천 인구·실업률 비교", "수도권 vs 광역시 GRDP", "지자체 정책 벤치마크"
+🔄 도구 비교:
+• 동일 통계표 내 시점·항목 비교 → compare_statistics
+• 단일 지역 종합 브리핑 → chain_region_brief
+• 정책 영역 추세 → chain_policy_indicator
+
+■ 매트릭스 + 지표별 최고/최저 자동 산출 + 순위
+■ regions·keywords 모두 자연어 가능 (성남시 → 경기 자동 fallback)`,
+    inputSchema: z.object({
+        regions: z
+            .array(z.string())
+            .min(2)
+            .max(17)
+            .describe('비교 지역 배열 (2~17개, 전국 광역시도 17개 동시 비교 가능). 예: ["서울", "부산", "인천"]'),
+        keywords: z
+            .array(z.string())
+            .min(1)
+            .max(8)
+            .describe('비교 지표 키워드 배열 (1~8개). 예: ["인구", "출산율", "실업률"]'),
+    }),
+};
+export async function chainCompareRegions(input) {
+    const { regions, keywords } = input;
+    const matrix = await Promise.all(regions.map(async (region) => {
+        const cells = await Promise.all(keywords.map(async (kw) => {
+            try {
+                const r = await quickStats({ query: kw, region });
+                const raw = r.value;
+                const numeric = raw == null
+                    ? null
+                    : parseFloat(String(raw).replace(/,/g, '')) || null;
+                return {
+                    region,
+                    keyword: kw,
+                    value: raw ?? null,
+                    numericValue: numeric,
+                    unit: r.unit ?? null,
+                    period: r.period ?? null,
+                    success: r.success,
+                    note: r.note ?? null,
+                };
+            }
+            catch (e) {
+                return {
+                    region,
+                    keyword: kw,
+                    value: null,
+                    numericValue: null,
+                    unit: null,
+                    period: null,
+                    success: false,
+                    note: e instanceof Error ? e.message : String(e),
+                };
+            }
+        }));
+        return { region, cells };
+    }));
+    // 지표별 최고/최저 및 순위
+    const insights = keywords.map((kw) => {
+        const cells = matrix
+            .flatMap((m) => m.cells.filter((c) => c.keyword === kw && c.success && c.numericValue != null))
+            .sort((a, b) => (b.numericValue ?? 0) - (a.numericValue ?? 0));
+        if (cells.length === 0) {
+            return { keyword: kw, ranking: [], note: '모든 지역 데이터 조회 실패' };
+        }
+        const ranking = cells.map((c, i) => ({
+            rank: i + 1,
+            region: c.region,
+            value: c.value,
+            unit: c.unit,
+            period: c.period,
+        }));
+        return {
+            keyword: kw,
+            highest: ranking[0],
+            lowest: ranking[ranking.length - 1],
+            ranking,
+        };
+    });
+    // 자치구→광역시도 fallback 노트 중복 제거하여 region별 1건만 노출
+    const fallbackNotesByRegion = new Map();
+    for (const m of matrix) {
+        for (const c of m.cells) {
+            if (c.note && c.note.includes('자치구') && !fallbackNotesByRegion.has(m.region)) {
+                fallbackNotesByRegion.set(m.region, c.note);
+                break;
+            }
+        }
+    }
+    const fallbackNotes = Array.from(fallbackNotesByRegion.entries()).map(([region, note]) => ({ region, note }));
+    return {
+        success: true,
+        regions,
+        keywords,
+        matrix,
+        insights,
+        summary: `📊 **${regions.length}개 지역 × ${keywords.length}개 지표 비교**\n` +
+            insights
+                .filter((i) => i.highest)
+                .map((i) => `• ${i.keyword}: 최고 ${i.highest.region}(${i.highest.value}${i.highest.unit ?? ''}), 최저 ${i.lowest.region}(${i.lowest.value}${i.lowest.unit ?? ''})`)
+                .join('\n'),
+        ...(fallbackNotes.length > 0 ? { fallbackNotes } : {}),
+    };
+}
+// ═══════════════════════════════════════════════════════════
+// chain_policy_indicator — 정책 영역 묶음 시계열
+// ═══════════════════════════════════════════════════════════
+const POLICY_DOMAINS = {
+    lowFertility: {
+        label: '저출산',
+        indicators: ['출산율', '출생아수', '혼인건수', '평균초혼연령'],
+        description: '합계출산율·출생아수·혼인건수·평균초혼연령',
+    },
+    aging: {
+        label: '고령화',
+        indicators: ['고령인구', '노령화지수', '기대수명'],
+        description: '고령인구·노령화지수·기대수명',
+    },
+    housing: {
+        label: '주거',
+        indicators: ['아파트가격', '전세가격', '주택가격'],
+        description: '아파트/주택 매매·전세 가격지수',
+    },
+    jobs: {
+        label: '일자리',
+        indicators: ['실업률', '고용률', '취업자수', '월급'],
+        description: '실업률·고용률·취업자수·월평균임금',
+    },
+    safety: {
+        label: '치안·안전',
+        indicators: ['범죄율', '교통사고', '사망률'],
+        description: '범죄율·교통사고·사망률',
+    },
+    health: {
+        label: '보건·의료',
+        indicators: ['의사수', '기대수명', '사망률'],
+        description: '의사수·기대수명·사망률',
+    },
+    economy: {
+        label: '경제',
+        indicators: ['GDP', '경제성장률', '물가', '수출'],
+        description: 'GDP·경제성장률·물가·수출',
+    },
+};
+export const chainPolicyIndicatorSchema = {
+    name: 'chain_policy_indicator',
+    description: `[⛓체인] 정책 영역 묶음 10년 시계열 — 저출산·고령화·주거·일자리·치안·보건·경제.
+
+🎯 사용 시점: "저출산 정책 브리프", "고령화 추세 보고", "주거 시장 동향", "일자리 5년 변화"
+🔄 도구 비교:
+• 단일 키워드 추세 → quick_trend
+• 지역 종합 브리핑 → chain_region_brief
+• 정밀 분석(차원 명시) → analyze_time_series
+
+■ 도메인별 3~4개 지표 시계열 + 추세 요약. 정책설명서/연구보고서 첨부용.
+■ region 선택. 미지정 시 전국. 자치구 → 광역시도 fallback.`,
+    inputSchema: z.object({
+        domain: z
+            .enum(['lowFertility', 'aging', 'housing', 'jobs', 'safety', 'health', 'economy'])
+            .describe('정책 영역: lowFertility(저출산), aging(고령화), housing(주거), jobs(일자리), safety(치안·안전), health(보건·의료), economy(경제)'),
+        region: z.string().optional().describe('지역명 (선택). 자치구/시군은 광역시도로 자동 fallback.'),
+        yearCount: z
+            .number()
+            .min(2)
+            .max(20)
+            .optional()
+            .default(10)
+            .describe('분석 기간 (년, 기본 10)'),
+    }),
+};
+export async function chainPolicyIndicator(input) {
+    const { domain, region, yearCount } = input;
+    const def = POLICY_DOMAINS[domain];
+    const results = await Promise.all(def.indicators.map(async (kw) => {
+        try {
+            const r = await quickTrend({ keyword: kw, region, yearCount });
+            const points = r.dataPoints ?? [];
+            const first = points[0];
+            const last = points[points.length - 1];
+            const change = first && last && first.value !== 0
+                ? (((last.value - first.value) / Math.abs(first.value)) * 100).toFixed(1)
+                : null;
+            return {
+                keyword: kw,
+                region: r.region,
+                success: r.success,
+                trend: r.trend,
+                trendDescription: r.trendDescription,
+                startYear: first?.year ?? null,
+                endYear: last?.year ?? null,
+                startValue: first?.formatted ?? null,
+                endValue: last?.formatted ?? null,
+                totalChangeRate: change == null ? null : `${parseFloat(change) >= 0 ? '+' : ''}${change}%`,
+                dataPoints: points,
+                source: r.source?.tableName ?? null,
+                note: r.note ?? null,
+            };
+        }
+        catch (e) {
+            return {
+                keyword: kw,
+                success: false,
+                error: e instanceof Error ? e.message : String(e),
+            };
+        }
+    }));
+    const successItems = results.filter((r) => r.success);
+    return {
+        success: true,
+        domain: def.label,
+        domainDescription: def.description,
+        region: region || '전국',
+        yearCount,
+        indicators: results,
+        summary: `📑 **${def.label} 영역 ${yearCount}년 추세** (${region || '전국'}, ${successItems.length}/${def.indicators.length} 지표 가용)\n` +
+            successItems
+                .map((r) => `• ${r.keyword}: ${r.trendDescription} (${r.startYear}→${r.endYear}년, ${r.totalChangeRate ?? '-'})`)
+                .join('\n'),
+    };
+}
+//# sourceMappingURL=chains.js.map

package/dist/tools/chains.js.map

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

package/dist/tools/compareStatistics.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 통계 비교 도구
+ * 여러 지역 또는 시점의 통계를 비교
+ */
+import { z } from 'zod';
+export declare const compareStatisticsSchema: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        orgId: z.ZodString;
+        tableId: z.ZodString;
+        compareType: z.ZodEnum<["period", "item"]>;
+        periodType: z.ZodEnum<["Y", "M", "Q"]>;
+        periods: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        objL1: z.ZodOptional<z.ZodString>;
+        objL2: z.ZodOptional<z.ZodString>;
+        itemId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        orgId: string;
+        tableId: string;
+        periodType: "Y" | "Q" | "M";
+        compareType: "period" | "item";
+        objL1?: string | undefined;
+        objL2?: string | undefined;
+        itemId?: string | undefined;
+        periods?: string[] | undefined;
+    }, {
+        orgId: string;
+        tableId: string;
+        periodType: "Y" | "Q" | "M";
+        compareType: "period" | "item";
+        objL1?: string | undefined;
+        objL2?: string | undefined;
+        itemId?: string | undefined;
+        periods?: string[] | undefined;
+    }>;
+};
+export type CompareStatisticsInput = z.infer<typeof compareStatisticsSchema.inputSchema>;
+interface ComparisonItem {
+    name: string;
+    region?: string;
+    itemName?: string;
+    period?: string;
+    value: number;
+    formattedValue: string;
+    unit?: string;
+    rank?: number;
+    change?: {
+        rate: number;
+        direction: 'up' | 'down' | 'stable';
+        formatted: string;
+    };
+}
+export declare function compareStatistics(input: CompareStatisticsInput): Promise<{
+    success: boolean;
+    compareType: string;
+    items: ComparisonItem[];
+    summary: string;
+    insights: string[];
+}>;
+export {};
+//# sourceMappingURL=compareStatistics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compareStatistics.d.ts","sourceRoot":"","sources":["../../src/tools/compareStatistics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmBnC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,WAAW,CAAC,CAAC;AAEzF,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;QACpC,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC,CAkLD"}