korean-stats-mcp 1.4.0

package/dist/tools/quickStats.js

@@ -0,0 +1,490 @@
+/**
+ * 빠른 통계 조회 도구
+ * 자연어 질문으로 한 번에 통계 데이터를 조회하고 자연어 응답을 생성
+ *
+ * 개선: 정적으로 검증된 파라미터 사용 (동적 조회 대신)
+ */
+import { z } from 'zod';
+import { getKosisClient } from '../api/client.js';
+import { getCacheManager } from '../cache/index.js';
+import { QUICK_STATS_PARAMS, KEYWORD_ALIASES, KEYWORD_LOOKUP, getQuickStatsParam, getRegionCode, normalizeKeywordKey, } from '../data/quickStatsParams.js';
+import { findProvinceByDistrict, PROVINCES, AMBIGUOUS_DISTRICTS } from '../utils/regions.js';
+/**
+ * 자치구로 오판하면 안 되는 키워드 집합
+ * (예: "인구"는 "구"로 끝나지만 자치구 아님)
+ */
+const NON_DISTRICT_WORDS = new Set([
+    '인구', '총인구', '수입', '수출', '집값', '월급', '취업', '주가',
+    '노인구', '고령인구', '65세이상인구',
+]);
+export const quickStatsSchema = {
+    name: 'quick_stats',
+    description: `[빠른조회] 자연어 한 줄 → KOSIS 수치 즉답. 91개 키워드 + 17 시도 + 자치구·시군 자동 라우팅.
+
+🔄 도구 라우팅:
+• "~얼마/몇명/현황" → 이 도구
+• "~추세/추이/변화/증감" → quick_trend
+• 지역 한장 종합 브리핑 → chain_region_brief
+• 다지역 비교 → chain_compare_regions
+• 키워드 미지원 → search_statistics
+• 자치구별 정밀 데이터 → fetch_kosis_excel
+
+■ 지원 키워드: 인구, 출산율, 실업률, 고용률, GDP, GRDP, 물가, 아파트가격, 전세가격, 미세먼지, 교통사고, 의사수, 범죄율, 초혼연령, 노령화지수, 고령인구 등 91개
+■ 지역: 17개 광역시도 + 자치구·시군 230+ → 광역시도 fallback + 안내
+■ 별칭: 저출산→출산율, 고령화→고령인구, population/gdp 등 영문 18개
+
+⚠️ 자연어 그대로 query에 넣어도 추출됨. region 명시 가능.`,
+    inputSchema: z.object({
+        query: z
+            .string()
+            .describe('통계 키워드만 입력 (감소/증가/추세/현황 등 수식어 제외). 예: "인구", "실업률", "GDP", "출산율", "고령인구"'),
+        region: z
+            .string()
+            .optional()
+            .describe('지역명. 예: "서울", "부산", "경기". 질문에 지역이 있으면 추출. "서울 인구" → region: "서울"'),
+        year: z
+            .number()
+            .optional()
+            .describe('조회 연도. 질문에 연도가 있으면 반드시 추출. "2020년 GDP" → year: 2020'),
+        period: z
+            .enum(['Y', 'Q', 'M'])
+            .optional()
+            .describe('조회 주기. Y=연간(기본), Q=분기, M=월별. "10월 출생아수" → period: "M"'),
+        month: z
+            .number()
+            .min(1)
+            .max(12)
+            .optional()
+            .describe('월 (period="M"일 때). "10월 출생아수" → month: 10'),
+        quarter: z
+            .number()
+            .min(1)
+            .max(4)
+            .optional()
+            .describe('분기 (period="Q"일 때). "3분기 실업률" → quarter: 3'),
+    }),
+};
+/**
+ * 지역명 목록 (쿼리에서 지역 추출용)
+ * - shortName: 17개 광역시도 약칭
+ * - fullName: 풀네임 (서울특별시, 경기도 등). 풀네임 매칭 우선.
+ */
+const PROVINCE_SHORT_NAMES = PROVINCES.map((p) => p.shortName);
+const PROVINCE_FULL_NAMES = PROVINCES.map((p) => p.fullName);
+/**
+ * 쿼리에서 광역시도 추출
+ *
+ * 부분매칭 버그 방지:
+ *   1. 자치구가 먼저 감지되면 광역시도 매칭은 스킵 (예: "해운대구"에 "대구" 부분매칭 방지)
+ *   2. 풀네임 우선 매칭 (예: "서울특별시" > "서울")
+ *   3. shortName은 단어 단위로 매칭 (앞뒤가 한글이 아니거나 끝)
+ */
+export function extractProvinceName(query, districtDetected) {
+    if (districtDetected)
+        return null;
+    // 풀네임 우선
+    for (const name of PROVINCE_FULL_NAMES) {
+        if (query.includes(name)) {
+            const idx = PROVINCE_FULL_NAMES.indexOf(name);
+            return PROVINCE_SHORT_NAMES[idx];
+        }
+    }
+    // shortName: 단어 단위 매칭 (앞뒤가 한글 자치구/시군 글자가 아닐 때만)
+    for (const name of PROVINCE_SHORT_NAMES) {
+        const idx = query.indexOf(name);
+        if (idx === -1)
+            continue;
+        const before = idx > 0 ? query[idx - 1] : '';
+        const after = idx + name.length < query.length ? query[idx + name.length] : '';
+        // 자치구/시/군 일부일 가능성: 뒤 글자가 '구/시/군'이면 잘못된 부분매칭
+        if (after === '구' || after === '시' || after === '군' || after === '도') {
+            // 단, "경기도", "강원도" 같은 패턴은 위 풀네임 매칭에서 잡혔어야 함.
+            // 여기서는 "해운대구"의 "대구"처럼 잘못 매칭되는 케이스 차단.
+            continue;
+        }
+        // 앞 글자가 한글이면 자치구 일부일 수 있음 (예: "해운대" + "구" 패턴은 위에서 거름)
+        return name;
+    }
+    return null;
+}
+/**
+ * 쿼리에서 자치구 감지
+ * 반환: 자치구명 또는 null
+ *
+ * 보장:
+ *   - "인구"/"수입"/"수출" 등 "구/군/시"로 끝나는 키워드는 자치구 아님
+ *   - 광역시도 풀네임("서울특별시" 등) 자치구 아님
+ *   - 정식 KOSIS 키워드/별칭은 자치구 아님
+ */
+export function extractDistrictName(query) {
+    // 단어 단위로 분리하여 검사 (공백 기준)
+    // "광진구 인구"에서 "광진구"만 자치구 후보로
+    const tokens = query.split(/\s+/);
+    for (const token of tokens) {
+        // 자치구 길이: "남구"(2) ~ "부산진구"(4) — "구/군/시" 포함 총 2~5글자
+        if (!/^[가-힣]{1,4}(구|군|시)$/.test(token))
+            continue;
+        if (PROVINCE_FULL_NAMES.includes(token))
+            continue;
+        if (PROVINCE_SHORT_NAMES.includes(token))
+            continue; // "대구" 같은 광역시 약칭 제외
+        if (NON_DISTRICT_WORDS.has(token))
+            continue;
+        if (QUICK_STATS_PARAMS[token])
+            continue;
+        if (KEYWORD_ALIASES[token])
+            continue;
+        return token;
+    }
+    return null;
+}
+export async function quickStats(input) {
+    const client = getKosisClient();
+    const cache = getCacheManager();
+    try {
+        // 0. 빈 쿼리 가드
+        const trimmedQuery = (input.query ?? '').trim();
+        if (!trimmedQuery) {
+            return {
+                success: false,
+                answer: '조회할 통계 키워드를 입력해주세요.',
+                note: '예: "인구", "실업률", "GDP", "서울 아파트가격". 카테고리별 키워드는 get_statistics_list(recommendedTopic) 참고.',
+            };
+        }
+        // 1. 쿼리에서 키워드 추출
+        const keyword = extractKeyword(trimmedQuery);
+        const param = getQuickStatsParam(keyword);
+        if (!param) {
+            // 매핑이 없으면 카테고리별 지원 키워드 안내
+            const keywordGuide = `
+📊 지원 키워드 (카테고리별 대표 예시):
+• 인구/출산: 인구, 출산율, 출생아수, 사망률, 기대수명
+• 고령화: 고령인구, 노인인구, 노령화지수, 65세이상인구
+• 고용/노동: 실업률, 고용률, 취업자수, 임금
+• 경제: GDP, GRDP, 경제성장률, 물가
+• 무역: 수출, 수입, 무역수지
+• 혼인/이혼: 혼인율, 이혼율, 초혼연령, 여성초혼연령
+• 부동산: 주택가격, 아파트가격, 전세가격
+• 교통: 자동차, 교통사고
+• 환경: 미세먼지, PM2.5, PM10
+• 사회: 범죄율, 의사수, 외래관광객
+
+💡 지역별: "서울 실업률", "부산 인구" (17개 시도)
+💡 월별: "2024년 10월 출생아수" (일부 키워드)`.trim();
+            return {
+                success: false,
+                answer: `"${input.query}"에 대한 빠른 조회가 지원되지 않습니다.`,
+                note: `${keywordGuide}\n\n🔍 다른 통계는 search_statistics("${input.query}")로 검색해보세요.`,
+            };
+        }
+        // 2. 지역 결정
+        let regionName = '전국';
+        let objL1 = param.objL1;
+        let requestedRegion = null;
+        let districtNote = null;
+        // 자치구·시군 추출: input.region 우선, 없으면 query에서.
+        // (quickStats는 광역시도 단위까지 지원. 자치구는 fetch_kosis_excel 권장)
+        const trimmedRegion = input.region?.trim() ?? '';
+        const districtFromRegion = trimmedRegion ? extractDistrictName(trimmedRegion) : null;
+        const districtFromQuery = !districtFromRegion ? extractDistrictName(trimmedQuery) : null;
+        const districtName = districtFromRegion ?? districtFromQuery;
+        const provFromQuery = extractProvinceName(trimmedQuery, /* districtDetected: */ false);
+        if (districtName) {
+            let prov = findProvinceByDistrict(districtName);
+            // 모호한 자치구(예: '동구', '북구') + 광역시도 컨텍스트가 함께 있으면 그쪽 우선
+            if (provFromQuery && AMBIGUOUS_DISTRICTS[districtName]?.includes(provFromQuery)) {
+                const candidate = PROVINCES.find((p) => p.shortName === provFromQuery);
+                if (candidate)
+                    prov = candidate;
+            }
+            if (prov) {
+                requestedRegion = prov.shortName;
+                districtNote = `💡 "${districtName}" 자치구 데이터는 quick_stats가 지원하지 않아 ${prov.shortName} 광역시도 데이터로 표시했습니다. 자치구 단위는 fetch_kosis_excel("${districtName}", "${keyword}")로 조회하세요.`;
+            }
+            else if (provFromQuery) {
+                // 자치구 매핑 실패했지만 광역시도는 명시 → 그걸로 fallback
+                requestedRegion = provFromQuery;
+                districtNote = `💡 "${districtName}"은(는) 자치구 매핑이 모호합니다. ${provFromQuery} 광역시도 데이터로 표시합니다.`;
+            }
+            else {
+                // 자치구도 광역시도도 매칭 실패 → 전국 데이터
+                districtNote = `💡 "${districtName}"은(는) 자치구 매핑이 모호합니다 (여러 광역시도에 동명 자치구 존재 가능). 전국 데이터로 표시합니다. 정확한 자치구 조회는 search_statistics("${districtName} ${keyword}") 사용.`;
+            }
+        }
+        else if (trimmedRegion) {
+            // 명시적 region 파라미터 (광역시도)
+            requestedRegion = trimmedRegion;
+        }
+        else if (provFromQuery) {
+            // query에서 광역시도만 추출
+            requestedRegion = provFromQuery;
+        }
+        // 지역 요청이 있는 경우 처리
+        if (requestedRegion) {
+            if (!param.regionCodes) {
+                return {
+                    success: false,
+                    answer: `"${keyword}" 통계는 지역별 조회를 지원하지 않습니다. 전국 데이터만 제공됩니다.`,
+                    note: `지역별 조회 가능: 인구, 출산율, 사망률, 혼인율, 이혼율, 실업률, 고용률, GRDP, 물가, 주택가격, 아파트가격, 전세가격, 미세먼지, 교통사고, 범죄율, 의사수, 자동차 등`,
+                };
+            }
+            const regionCode = getRegionCode(param, requestedRegion);
+            if (regionCode !== param.objL1) {
+                objL1 = regionCode;
+                regionName = requestedRegion;
+            }
+        }
+        // 3. 주기(period) 결정 및 검증
+        const supportedPeriods = param.supportedPeriods || ['Y'];
+        // 사용자가 주기를 지정하지 않으면 키워드의 첫 번째 지원 주기 사용
+        const defaultPeriod = supportedPeriods[0];
+        const requestedPeriod = input.period || defaultPeriod;
+        if (!supportedPeriods.includes(requestedPeriod)) {
+            const periodNames = { 'Y': '연간', 'Q': '분기', 'M': '월별' };
+            const supportedNames = supportedPeriods.map(p => periodNames[p]).join(', ');
+            return {
+                success: false,
+                answer: `"${input.query}"는 ${periodNames[requestedPeriod]} 조회를 지원하지 않습니다.`,
+                note: `지원 주기: ${supportedNames}`,
+            };
+        }
+        // 4. 조회 기간 계산
+        let startPrd;
+        let endPrd;
+        if (input.year) {
+            if (requestedPeriod === 'Y') {
+                startPrd = input.year.toString();
+                endPrd = input.year.toString();
+            }
+            else if (requestedPeriod === 'Q' && input.quarter) {
+                const qStr = `${input.year}${input.quarter.toString().padStart(2, '0')}`;
+                startPrd = qStr;
+                endPrd = qStr;
+            }
+            else if (requestedPeriod === 'M' && input.month) {
+                const mStr = `${input.year}${input.month.toString().padStart(2, '0')}`;
+                startPrd = mStr;
+                endPrd = mStr;
+            }
+            else if (requestedPeriod === 'Q') {
+                // 해당 연도의 모든 분기
+                startPrd = `${input.year}01`;
+                endPrd = `${input.year}04`;
+            }
+            else if (requestedPeriod === 'M') {
+                // 해당 연도의 모든 월
+                startPrd = `${input.year}01`;
+                endPrd = `${input.year}12`;
+            }
+        }
+        // 5. 데이터 조회 (검증된 정적 파라미터 사용)
+        const results = await cache.getStatisticsData({
+            orgId: param.orgId,
+            tableId: param.tableId,
+            objL1,
+            objL2: param.objL2,
+            itemId: param.itemId,
+            periodType: requestedPeriod,
+            recentCount: startPrd ? undefined : 1,
+            year: input.year,
+            month: input.month,
+            quarter: input.quarter,
+        }, async () => {
+            return client.getStatisticsData({
+                orgId: param.orgId,
+                tblId: param.tableId,
+                objL1,
+                objL2: param.objL2,
+                itmId: param.itemId,
+                prdSe: requestedPeriod,
+                newEstPrdCnt: startPrd ? undefined : 1,
+                startPrdDe: startPrd,
+                endPrdDe: endPrd,
+            });
+        });
+        if (results.length === 0) {
+            return {
+                success: false,
+                answer: `"${input.query}"에 대한 데이터를 찾을 수 없습니다.`,
+                note: `테이블: ${param.tableName} (${param.tableId})\n다른 검색어로 시도하거나 search_statistics를 사용해보세요.`,
+            };
+        }
+        // 6. 결과 파싱
+        const latestData = results[0];
+        const value = latestData.DT;
+        const period = latestData.PRD_DE;
+        const periodFormatted = formatPeriodWithType(period, requestedPeriod);
+        const unit = param.unit;
+        // 5. 자연어 응답 생성
+        const baseAnswer = generateNaturalResponse({
+            keyword,
+            regionName,
+            value,
+            unit,
+            period: periodFormatted,
+            description: param.description,
+        });
+        // 장래추계 데이터 안내 (미래연도 데이터는 실측이 아님)
+        const projectionNote = param.isProjection
+            ? `⚠️ 본 수치는 통계청 장래추계 데이터입니다 (실측 아닌 미래 추계). 정책·보고 인용 시 "추계" 명시 권장.`
+            : null;
+        // 출처 + 자치구 + 추계 안내 부착
+        const noteSuffix = [districtNote, projectionNote].filter(Boolean).join('\n\n');
+        const answer = `${baseAnswer}\n\n📊 출처: ${param.tableName} (KOSIS)${noteSuffix ? `\n\n${noteSuffix}` : ''}`;
+        const combinedNote = [districtNote, projectionNote].filter(Boolean).join(' / ');
+        return {
+            success: true,
+            answer,
+            value,
+            unit,
+            period: periodFormatted,
+            source: {
+                orgId: param.orgId,
+                tableId: param.tableId,
+                tableName: param.tableName,
+            },
+            ...(param.isProjection ? { isProjection: true } : {}),
+            ...(combinedNote ? { note: combinedNote } : {}),
+        };
+    }
+    catch (error) {
+        console.error('Quick stats error:', error);
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // KOSIS "데이터가 존재하지 않습니다" → 친절한 안내
+        const isMissing = /데이터가 존재하지 않습니다/.test(errorMessage);
+        if (isMissing) {
+            const yearHint = input.year != null
+                ? (input.year > new Date().getFullYear()
+                    ? `${input.year}년은 아직 발표되지 않았을 가능성이 큽니다. 연도 미지정 시 최신 데이터를 자동 조회합니다.`
+                    : `${input.year}년 데이터가 해당 통계표에 없습니다. 가용 연도 범위를 좁혀 다시 시도해보세요.`)
+                : '해당 통계표에 데이터가 없습니다.';
+            return {
+                success: false,
+                answer: `"${input.query}" 데이터를 찾을 수 없습니다.`,
+                note: `${yearHint}\n다른 검색은 search_statistics("${input.query}") 사용.`,
+            };
+        }
+        return {
+            success: false,
+            answer: `조회 중 오류가 발생했습니다: ${errorMessage}`,
+            note: `search_statistics("${input.query}")로 직접 검색해보세요.`,
+        };
+    }
+}
+/**
+ * 쿼리에서 키워드 추출 (korean-law-mcp의 정규화 alias 패턴 차용)
+ *
+ * 알고리즘:
+ *   1. 정규화 (공백·대소문자·중점/하이픈 제거 + 률/율 오타 매핑)
+ *   2. KEYWORD_LOOKUP에서 가장 긴 정규화 키 부분 매칭 (긴 키 우선 → 충돌 방지)
+ *      → "경기 노인 인구"는 '노인인구'(4자)가 '인구'(2자)보다 먼저 매칭
+ *      → "G D P"·"출산률"·"PM 2.5"도 모두 정규화 후 매칭
+ *   3. 매칭 실패 시 원문 그대로 반환 (getQuickStatsParam에서 추가 처리)
+ *
+ * KEYWORD_LOOKUP은 정식 키워드 + KEYWORD_ALIASES + BASIC_TYPO_MAP을 통합한 사전 빌드 Map.
+ */
+const SORTED_NORM_KEYS = Array.from(KEYWORD_LOOKUP.keys())
+    .filter((k) => k.length >= 2)
+    .sort((a, b) => b.length - a.length);
+export function extractKeyword(query) {
+    if (!query)
+        return query;
+    const normQuery = normalizeKeywordKey(query);
+    if (!normQuery)
+        return query;
+    for (const nk of SORTED_NORM_KEYS) {
+        if (normQuery.includes(nk)) {
+            return KEYWORD_LOOKUP.get(nk);
+        }
+    }
+    return query;
+}
+/**
+ * 기간 형식 포맷팅 (년/분기/월 지원)
+ */
+function formatPeriod(period) {
+    if (period.length === 4) {
+        // 연간: "2024" → "2024년"
+        return `${period}년`;
+    }
+    else if (period.length === 6) {
+        const year = period.slice(0, 4);
+        const suffix = period.slice(4);
+        const num = parseInt(suffix, 10);
+        // 분기인지 월인지 구분 (01~04는 분기일 수도, 01~12는 월)
+        // KOSIS API는 분기를 01, 02, 03, 04로, 월을 01~12로 표현
+        // 구분을 위해 값의 범위로 판단 (5 이상이면 월)
+        if (num >= 5 && num <= 12) {
+            // 월간: "202410" → "2024년 10월"
+            return `${year}년 ${num}월`;
+        }
+        else if (num >= 1 && num <= 4) {
+            // 분기: "202401" → "2024년 1분기" (단, 월일 수도 있음)
+            // 이 경우 호출 컨텍스트에서 판단해야 함
+            // 기본적으로 월로 처리 (1~4월)
+            return `${year}년 ${num}월`;
+        }
+    }
+    return period;
+}
+/**
+ * 기간 형식 포맷팅 (주기 타입 명시)
+ */
+function formatPeriodWithType(period, periodType) {
+    if (period.length === 4) {
+        return `${period}년`;
+    }
+    else if (period.length === 6) {
+        const year = period.slice(0, 4);
+        const num = parseInt(period.slice(4), 10);
+        if (periodType === 'Q') {
+            return `${year}년 ${num}분기`;
+        }
+        else if (periodType === 'M') {
+            return `${year}년 ${num}월`;
+        }
+    }
+    return period;
+}
+/**
+ * 한국어 받침 유무에 따라 조사 선택
+ * 받침이 있으면 '은', 없으면 '는'
+ */
+function getKoreanParticle(text) {
+    if (!text || text.length === 0)
+        return '은';
+    const lastChar = text.charAt(text.length - 1);
+    const code = lastChar.charCodeAt(0);
+    // 한글 유니코드 범위: 0xAC00 ~ 0xD7A3
+    if (code >= 0xAC00 && code <= 0xD7A3) {
+        // 종성(받침) 존재 여부 확인
+        // (code - 0xAC00) % 28 === 0 이면 받침 없음
+        const hasJongseong = (code - 0xAC00) % 28 !== 0;
+        return hasJongseong ? '은' : '는';
+    }
+    // 숫자나 영문 등은 기본적으로 '는' 사용
+    return '는';
+}
+/**
+ * 자연어 응답 생성
+ */
+function generateNaturalResponse(data) {
+    const { regionName, value, unit, period, description } = data;
+    // 숫자 포맷팅 (콤마 추가)
+    const formattedValue = value.includes(',') ? value : Number(value).toLocaleString();
+    // 단위 포맷팅 (지수 기준연도는 괄호로 감싸기)
+    let formattedUnit = unit;
+    if (unit.includes('=')) {
+        // 지수 단위 (예: 2020=100, 2021.6=100)
+        formattedUnit = unit.startsWith('(') ? ` ${unit}` : ` (${unit})`;
+    }
+    // 한국어 문법: 받침 유무에 따라 은/는 선택
+    const suffix = getKoreanParticle(description);
+    if (regionName === '전국') {
+        return `${period} 한국의 ${description}${suffix} ${formattedValue}${formattedUnit}입니다.`;
+    }
+    else {
+        return `${period} ${regionName}의 ${description}${suffix} ${formattedValue}${formattedUnit}입니다.`;
+    }
+}
+//# sourceMappingURL=quickStats.js.map

package/dist/tools/quickStats.js.map

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

package/dist/tools/quickTrend.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 빠른 추세 분석 도구
+ * 자연어 키워드로 시계열 추세를 간편하게 분석
+ */
+import { z } from 'zod';
+/**
+ * 자연어 키워드에서 yearCount 추정
+ *
+ * 인식 패턴:
+ *   - "지난/최근 N년", "N년 추세/추이" → N
+ *   - "작년 대비", "전년 대비" → 2
+ *   - "민선 N기" → N*4 (지방선거 임기 4년)
+ *   - "임기 N년" → N
+ *   - "취임 N년", "취임 N년차" → N+1 (취임 시점 포함)
+ *   - "역대", "장기" → 20
+ */
+export declare function extractYearCount(query: string): number | null;
+export declare const quickTrendSchema: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        keyword: z.ZodString;
+        region: z.ZodOptional<z.ZodString>;
+        yearCount: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        keyword: string;
+        region?: string | undefined;
+        yearCount?: number | undefined;
+    }, {
+        keyword: string;
+        region?: string | undefined;
+        yearCount?: number | undefined;
+    }>;
+};
+export type QuickTrendInput = z.infer<typeof quickTrendSchema.inputSchema>;
+export interface TrendDataPoint {
+    year: string;
+    value: number;
+    formatted: string;
+    changeRate?: string;
+}
+interface QuickTrendResult {
+    success: boolean;
+    keyword: string;
+    region: string;
+    trend: 'increasing' | 'decreasing' | 'stable' | 'fluctuating';
+    trendDescription: string;
+    summary: string;
+    dataPoints: TrendDataPoint[];
+    insights: string[];
+    source?: {
+        orgId: string;
+        tableId: string;
+        tableName: string;
+    };
+    isProjection?: boolean;
+    note?: string;
+}
+export declare function quickTrend(input: QuickTrendInput): Promise<QuickTrendResult>;
+export {};
+//# sourceMappingURL=quickTrend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quickTrend.d.ts","sourceRoot":"","sources":["../../src/tools/quickTrend.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8B7D;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;CA8B5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC;AAE3E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC9D,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAUD,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8PlF"}