ragalgo-mcp-server 1.0.5 → 1.0.7

package/dist/tools/chart.d.ts

@@ -4,30 +4,33 @@
 import { z } from 'zod';
 export declare const ChartStockParamsSchema: z.ZodObject<{
     ticker: z.ZodOptional<z.ZodString>;
-    market: z.ZodOptional<z.ZodEnum<{
-        KOSPI: "KOSPI";
-        KOSDAQ: "KOSDAQ";
-    }>>;
-    zone: z.ZodOptional<z.ZodEnum<{
-        STRONG_UP: "STRONG_UP";
-        UP_ZONE: "UP_ZONE";
-        NEUTRAL: "NEUTRAL";
-        DOWN_ZONE: "DOWN_ZONE";
-        STRONG_DOWN: "STRONG_DOWN";
-    }>>;
+    market: z.ZodOptional<z.ZodEnum<["KOSPI", "KOSDAQ", "US", "JP", "UK"]>>;
+    zone: z.ZodOptional<z.ZodEnum<["STRONG_UP", "UP_ZONE", "NEUTRAL", "DOWN_ZONE", "STRONG_DOWN"]>>;
     limit: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    market?: "KOSPI" | "KOSDAQ" | "US" | "JP" | "UK" | undefined;
+    ticker?: string | undefined;
+    zone?: "STRONG_UP" | "UP_ZONE" | "NEUTRAL" | "DOWN_ZONE" | "STRONG_DOWN" | undefined;
+}, {
+    limit?: number | undefined;
+    market?: "KOSPI" | "KOSDAQ" | "US" | "JP" | "UK" | undefined;
+    ticker?: string | undefined;
+    zone?: "STRONG_UP" | "UP_ZONE" | "NEUTRAL" | "DOWN_ZONE" | "STRONG_DOWN" | undefined;
+}>;
 export declare const ChartCoinParamsSchema: z.ZodObject<{
     ticker: z.ZodOptional<z.ZodString>;
-    zone: z.ZodOptional<z.ZodEnum<{
-        STRONG_UP: "STRONG_UP";
-        UP_ZONE: "UP_ZONE";
-        NEUTRAL: "NEUTRAL";
-        DOWN_ZONE: "DOWN_ZONE";
-        STRONG_DOWN: "STRONG_DOWN";
-    }>>;
+    zone: z.ZodOptional<z.ZodEnum<["STRONG_UP", "UP_ZONE", "NEUTRAL", "DOWN_ZONE", "STRONG_DOWN"]>>;
     limit: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    ticker?: string | undefined;
+    zone?: "STRONG_UP" | "UP_ZONE" | "NEUTRAL" | "DOWN_ZONE" | "STRONG_DOWN" | undefined;
+}, {
+    limit?: number | undefined;
+    ticker?: string | undefined;
+    zone?: "STRONG_UP" | "UP_ZONE" | "NEUTRAL" | "DOWN_ZONE" | "STRONG_DOWN" | undefined;
+}>;
 export type ChartStockParams = z.infer<typeof ChartStockParamsSchema>;
 export type ChartCoinParams = z.infer<typeof ChartCoinParamsSchema>;
 export declare function getChartStock(params: ChartStockParams): Promise<{
@@ -39,6 +42,13 @@ export declare function getChartStock(params: ChartStockParams): Promise<{
         scores: number[];
         zone: string;
         oscillator_state: string;
+        analysis?: {
+            weekly_zone: string;
+            daily_momentum: string;
+            daily_signal: string;
+        };
+        outlook?: string;
+        chart_history?: any;
         last_price: number;
         updated_at: string;
     } | Array<{
@@ -57,6 +67,13 @@ export declare function getChartCoin(params: ChartCoinParams): Promise<{
         scores: number[];
         zone: string;
         oscillator_state: string;
+        analysis?: {
+            weekly_zone: string;
+            daily_momentum: string;
+            daily_signal: string;
+        };
+        outlook?: string;
+        chart_history?: any;
         last_price: number;
         updated_at: string;
     } | Array<{

package/dist/tools/chart.js

@@ -6,7 +6,7 @@ import { callApi } from '../utils/api.js';
 // 주식 차트 파라미터 스키마
 export const ChartStockParamsSchema = z.object({
     ticker: z.string().optional().describe('종목 코드 (예: 005930)'),
-    market: z.enum(['KOSPI', 'KOSDAQ']).optional().describe('시장 구분'),
+    market: z.enum(['KOSPI', 'KOSDAQ', 'US', 'JP', 'UK']).optional().describe('시장 구분 (KOSPI/KOSDAQ/US/JP/UK)'),
     zone: z.enum(['STRONG_UP', 'UP_ZONE', 'NEUTRAL', 'DOWN_ZONE', 'STRONG_DOWN']).optional().describe('차트 구간'),
     limit: z.number().min(1).max(100).default(20).describe('결과 수'),
 });
@@ -18,15 +18,14 @@ export const ChartCoinParamsSchema = z.object({
 });
 // 주식 차트 조회
 export async function getChartStock(params) {
-    const endpoint = params.ticker ? `chart-stock/${params.ticker}` : 'chart-stock';
-    const { ticker, ...queryParams } = params;
-    const result = await callApi(endpoint, queryParams);
+    const endpoint = 'chart-stock';
+    // params passes through directly as query params
+    const result = await callApi(endpoint, params);
     return result;
 }
 // 코인 차트 조회
 export async function getChartCoin(params) {
-    const endpoint = params.ticker ? `chart-coin/${params.ticker}` : 'chart-coin';
-    const { ticker, ...queryParams } = params;
-    const result = await callApi(endpoint, queryParams);
+    const endpoint = 'chart-coin';
+    const result = await callApi(endpoint, params);
     return result;
 }

package/dist/tools/financials.d.ts

@@ -5,14 +5,25 @@ import { z } from 'zod';
 export declare const FinancialsParamsSchema: z.ZodObject<{
     ticker: z.ZodOptional<z.ZodString>;
     period: z.ZodOptional<z.ZodString>;
-    market: z.ZodOptional<z.ZodEnum<{
-        KOSPI: "KOSPI";
-        KOSDAQ: "KOSDAQ";
-    }>>;
+    market: z.ZodOptional<z.ZodEnum<["KOSPI", "KOSDAQ", "US", "JP", "UK"]>>;
     periods: z.ZodDefault<z.ZodNumber>;
     limit: z.ZodDefault<z.ZodNumber>;
     offset: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    periods: number;
+    market?: "KOSPI" | "KOSDAQ" | "US" | "JP" | "UK" | undefined;
+    ticker?: string | undefined;
+    period?: string | undefined;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+    market?: "KOSPI" | "KOSDAQ" | "US" | "JP" | "UK" | undefined;
+    ticker?: string | undefined;
+    period?: string | undefined;
+    periods?: number | undefined;
+}>;
 export type FinancialsParams = z.infer<typeof FinancialsParamsSchema>;
 export declare function getFinancials(params: FinancialsParams): Promise<{
     success: boolean;

package/dist/tools/financials.js

@@ -7,7 +7,7 @@ import { callApi } from '../utils/api.js';
 export const FinancialsParamsSchema = z.object({
     ticker: z.string().optional().describe('종목 코드 (예: 005930)'),
     period: z.string().optional().describe('분기 (예: 2024Q3)'),
-    market: z.enum(['KOSPI', 'KOSDAQ']).optional().describe('시장 구분'),
+    market: z.enum(['KOSPI', 'KOSDAQ', 'US', 'JP', 'UK']).optional().describe('시장 구분 (KOSPI/KOSDAQ/US/JP/UK)'),
     periods: z.number().min(1).max(8).default(4).describe('최근 N분기 (기본: 4)'),
     limit: z.number().min(1).max(200).default(50).describe('결과 수'),
     offset: z.number().min(0).default(0).describe('페이지네이션 오프셋'),

package/dist/tools/news.d.ts

@@ -8,30 +8,75 @@ export declare const NewsParamsSchema: z.ZodObject<{
     search: z.ZodOptional<z.ZodString>;
     from_date: z.ZodOptional<z.ZodString>;
     to_date: z.ZodOptional<z.ZodString>;
-    limit: z.ZodDefault<z.ZodNumber>;
-    offset: z.ZodDefault<z.ZodNumber>;
     start_date: z.ZodOptional<z.ZodString>;
     end_date: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    tag_code?: string | undefined;
+    source?: string | undefined;
+    search?: string | undefined;
+    from_date?: string | undefined;
+    to_date?: string | undefined;
+    start_date?: string | undefined;
+    end_date?: string | undefined;
+}, {
+    tag_code?: string | undefined;
+    source?: string | undefined;
+    search?: string | undefined;
+    from_date?: string | undefined;
+    to_date?: string | undefined;
+    start_date?: string | undefined;
+    end_date?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
 export declare const NewsScoredParamsSchema: z.ZodObject<{
     tag_code: z.ZodOptional<z.ZodString>;
     source: z.ZodOptional<z.ZodString>;
     search: z.ZodOptional<z.ZodString>;
     from_date: z.ZodOptional<z.ZodString>;
     to_date: z.ZodOptional<z.ZodString>;
-    limit: z.ZodDefault<z.ZodNumber>;
-    offset: z.ZodDefault<z.ZodNumber>;
     start_date: z.ZodOptional<z.ZodString>;
     end_date: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+} & {
     min_score: z.ZodOptional<z.ZodNumber>;
     max_score: z.ZodOptional<z.ZodNumber>;
-    verdict: z.ZodOptional<z.ZodEnum<{
-        bullish: "bullish";
-        bearish: "bearish";
-        neutral: "neutral";
-    }>>;
+    verdict: z.ZodOptional<z.ZodEnum<["bullish", "bearish", "neutral"]>>;
     market: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    tag_code?: string | undefined;
+    source?: string | undefined;
+    search?: string | undefined;
+    from_date?: string | undefined;
+    to_date?: string | undefined;
+    start_date?: string | undefined;
+    end_date?: string | undefined;
+    min_score?: number | undefined;
+    max_score?: number | undefined;
+    verdict?: "bullish" | "bearish" | "neutral" | undefined;
+    market?: string | undefined;
+}, {
+    tag_code?: string | undefined;
+    source?: string | undefined;
+    search?: string | undefined;
+    from_date?: string | undefined;
+    to_date?: string | undefined;
+    start_date?: string | undefined;
+    end_date?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    min_score?: number | undefined;
+    max_score?: number | undefined;
+    verdict?: "bullish" | "bearish" | "neutral" | undefined;
+    market?: string | undefined;
+}>;
 export type NewsParams = z.infer<typeof NewsParamsSchema>;
 export type NewsScoredParams = z.infer<typeof NewsScoredParamsSchema>;
 export declare function getNews(params: NewsParams): Promise<{

package/dist/tools/news.js

@@ -6,25 +6,27 @@ import { callApi } from '../utils/api.js';
 // 뉴스 파라미터 스키마
 export const NewsParamsSchema = z.object({
     tag_code: z.string().optional().describe('태그 코드 (search_tags 결과값, 예: STK005930, THM001)'),
-    source: z.string().optional().describe('소스 필터 (예: 한경, 매경)'),
+    source: z.string().optional().describe('소스 필터 (예: 한경, 매경, WSJ, Bloomberg)'),
     search: z.string().optional().describe('제목 검색어'),
     from_date: z.string().optional().describe('시작일 (YYYY-MM-DD)'),
     to_date: z.string().optional().describe('종료일 (YYYY-MM-DD)'),
+    start_date: z.string().optional().describe('시작일 (from_date의 별칭)'), // [FIX] LLM Alias support
+    end_date: z.string().optional().describe('종료일 (to_date의 별칭)'), // [FIX] LLM Alias support
     limit: z.number().min(1).max(100).default(20).describe('결과 수 (기본: 20, 최대: 100)'),
     offset: z.number().min(0).default(0).describe('페이지네이션 오프셋'),
-    start_date: z.string().optional().describe('시작일 alias'),
-    end_date: z.string().optional().describe('종료일 alias'),
 }); // [MOD] Removed .strict()
 // 점수 포함 뉴스 파라미터 스키마
 export const NewsScoredParamsSchema = NewsParamsSchema.extend({
     min_score: z.number().min(-10).max(10).optional().describe('최소 감정 점수 (-10~10)'),
     max_score: z.number().min(-10).max(10).optional().describe('최대 감정 점수 (-10~10)'),
     verdict: z.enum(['bullish', 'bearish', 'neutral']).optional().describe('판정 필터'),
-    market: z.string().optional().describe('시장 필터 (KR, US, JP, UK)'),
+    market: z.string().optional().describe('시장 필터 (KR, US 등) - 호환성 유지용'), // [FIX] LLM Compatibility
 }); // [MOD] Removed .strict()
 // 뉴스 조회 (점수 제외)
 export async function getNews(params) {
+    console.error(`[getNews] Params: ${JSON.stringify(params)}`); // [DEBUG]
     const { tag_code, start_date, end_date, ...rest } = params;
+    // [FIX] Handle Aliases
     const apiParams = { ...rest, tag: tag_code };
     if (start_date && !apiParams.from_date)
         apiParams.from_date = start_date;
@@ -35,29 +37,14 @@ export async function getNews(params) {
 }
 // 뉴스 조회 (점수 포함)
 export async function getNewsScored(params) {
-    const { tag_code, start_date, end_date, ...rest } = params;
+    console.error(`[getNewsScored] Params: ${JSON.stringify(params)}`); // [DEBUG]
+    const { tag_code, start_date, end_date, ...rest } = params; // [FIXED] Include 'market' in API call by not destructuring it from rest (it's inside rest now or handled by type)
+    // [FIX] Handle Aliases
     const apiParams = { ...rest, tag: tag_code };
     if (start_date && !apiParams.from_date)
         apiParams.from_date = start_date;
     if (end_date && !apiParams.to_date)
         apiParams.to_date = end_date;
-    // [FIX] JP/UK Fallback: 'news-scored' endpoint only supports scored news (news_final).
-    // Raw markets (JP/UK) are in raw tables accessed via 'news' endpoint.
-    // We hijack the call to 'news' and polyfill the score fields.
-    const market = apiParams.market?.toUpperCase();
-    if (market === 'JP' || market === 'UK') {
-        const result = await callApi('news', apiParams);
-        return {
-            ...result,
-            data: (result.data || []).map(item => ({
-                ...item,
-                sentiment_score: 0,
-                verdict: 'neutral',
-                tag_codes: item.tags || [] // 'news' endpoint returns tags as strings or codes? check 'news' return type.
-                // Actually 'news' endpoint handles mapping too.
-            }))
-        };
-    }
     const result = await callApi('news-scored', apiParams);
     return result;
 }

package/dist/tools/research.d.ts

@@ -1,26 +1,39 @@
 /**
- * 컨설팅 보고서 관련 MCP Tools
+ * Research (보고서) 관련 MCP Tools
  */
 import { z } from 'zod';
 export declare const ResearchParamsSchema: z.ZodObject<{
-    tag_code: z.ZodString;
-    limit: z.ZodDefault<z.ZodNumber>;
+    tag_code: z.ZodOptional<z.ZodString>;
     source: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    tag_code?: string | undefined;
+    source?: string | undefined;
+}, {
+    tag_code?: string | undefined;
+    source?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
 export type ResearchParams = z.infer<typeof ResearchParamsSchema>;
 export declare function getResearch(params: ResearchParams): Promise<{
-    tag_code: string;
-    tag_name: string | null;
-    research_count: number;
-    research: Array<{
+    success: boolean;
+    data: Array<{
         id: number;
         title: string;
+        summary: string;
+        tag_codes: string[];
+        created_at: string;
+        processed_at: string;
         source: string;
-        content_type: string;
-        published_at: string | null;
-        chunks: Array<{
-            section: string;
-            content: string;
-        }>;
+        market_outlook?: string;
     }>;
+    meta: {
+        count: number;
+        limit: number;
+        offset: number;
+    };
 }>;

package/dist/tools/research.js

@@ -1,18 +1,18 @@
 /**
- * 컨설팅 보고서 관련 MCP Tools
+ * Research (보고서) 관련 MCP Tools
  */
 import { z } from 'zod';
 import { callApi } from '../utils/api.js';
-const API_BASE = 'https://ragalgo-research-production.up.railway.app'; // 혹시 몰라 남겨룸, 하지만 callApi 사용시 Supabase Edge Function 호출
-// 보고서 조회 파라미터 스키마
+// Research 파라미터 스키마
 export const ResearchParamsSchema = z.object({
-    tag_code: z.string().describe('태그 코드 (필수). search_tags로 먼저 조회하세요.'),
-    limit: z.number().min(1).max(10).default(5).describe('보고서 수 (기본 5, 최대 10)'),
-    source: z.string().optional().describe('출처 필터 (선택): mckinsey, goldman, bcg, lg_research 등'),
+    tag_code: z.string().optional().describe('Tag code filter (e.g., STK005930, USTK_AAPL)'),
+    source: z.string().optional().describe('Source filter (e.g., mckinsey, bcg, ls)'),
+    limit: z.number().min(1).max(50).default(10).describe('Result count (default: 10)'),
+    offset: z.number().min(0).default(0).describe('Pagination offset'),
 });
-// 보고서 조회
+// Research 보고서 조회
 export async function getResearch(params) {
-    // Supabase Edge Function 호출
-    const result = await callApi('research', params); // 'research' function 호출
+    const endpoint = 'research';
+    const result = await callApi(endpoint, params);
     return result;
 }

package/dist/tools/rooms.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+export declare const RoomsParamsSchema: z.ZodObject<{
+    search: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["tag", "ticker", "keyword"]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    type?: "ticker" | "tag" | "keyword" | undefined;
+    search?: string | undefined;
+}, {
+    type?: "ticker" | "tag" | "keyword" | undefined;
+    search?: string | undefined;
+    limit?: number | undefined;
+}>;
+export type RoomsParams = z.infer<typeof RoomsParamsSchema>;
+export declare const GetAvailableRoomsSchema: z.ZodObject<{
+    search: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["tag", "ticker", "keyword"]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    type?: "ticker" | "tag" | "keyword" | undefined;
+    search?: string | undefined;
+}, {
+    type?: "ticker" | "tag" | "keyword" | undefined;
+    search?: string | undefined;
+    limit?: number | undefined;
+}>;
+export declare function getAvailableRooms(params: RoomsParams): Promise<{
+    rooms: any;
+    count: any;
+    help: string;
+}>;

package/dist/tools/rooms.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+const SUPABASE_PROJECT_URL = 'https://xunrsikkybgxkybjzrgz.supabase.co';
+const SUPABASE_REST_URL = `${SUPABASE_PROJECT_URL}/rest/v1`;
+const SUPABASE_ANON_KEY = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Inh1bnJzaWtreWJneGt5Ymp6cmd6Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NjQ0NTExNTgsImV4cCI6MjA4MDAyNzE1OH0.SsXri828-Rf0gHlu4Bls-pewhfMNNII4mbiuLnc9ACs';
+export const RoomsParamsSchema = z.object({
+    search: z.string().optional().describe('Search term for rooms (e.g., "Samsung", "Semiconductor")'),
+    type: z.enum(['tag', 'ticker', 'keyword']).optional().describe('Filter by room type'),
+    limit: z.number().min(1).max(100).default(20).describe('Result count'),
+});
+export const GetAvailableRoomsSchema = RoomsParamsSchema;
+export async function getAvailableRooms(params) {
+    const url = new URL(`${SUPABASE_REST_URL}/available_websocket_rooms`);
+    // Select specific columns
+    url.searchParams.append('select', 'room_id,type,description');
+    // Add filters
+    if (params.search) {
+        // Search in both description and room_id
+        url.searchParams.append('or', `(description.ilike.*${params.search}*,room_id.ilike.*${params.search}*)`);
+    }
+    if (params.type) {
+        url.searchParams.append('type', `eq.${params.type}`);
+    }
+    // Limit
+    url.searchParams.append('limit', String(params.limit));
+    const response = await fetch(url.toString(), {
+        method: 'GET',
+        headers: {
+            'Authorization': `Bearer ${SUPABASE_ANON_KEY}`,
+            'apikey': SUPABASE_ANON_KEY,
+            'Content-Type': 'application/json',
+        },
+    });
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`Failed to fetch rooms: ${response.status} - ${error}`);
+    }
+    const data = await response.json();
+    return {
+        rooms: data,
+        count: data.length,
+        help: "Use these room_ids to subscribe via WebSocket. Example: socket.emit('subscribe', 'tag:STK005930')"
+    };
+}

package/dist/tools/snapshots.d.ts

@@ -4,11 +4,26 @@
 import { z } from 'zod';
 export declare const SnapshotsParamsSchema: z.ZodObject<{
     tag_code: z.ZodOptional<z.ZodString>;
+    market: z.ZodOptional<z.ZodEnum<["KR", "US", "JP", "UK", "UNIFIED", "CRY", "FUTURES"]>>;
     date: z.ZodOptional<z.ZodString>;
     days: z.ZodDefault<z.ZodNumber>;
     limit: z.ZodDefault<z.ZodNumber>;
     offset: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    days: number;
+    tag_code?: string | undefined;
+    market?: "US" | "JP" | "UK" | "KR" | "UNIFIED" | "CRY" | "FUTURES" | undefined;
+    date?: string | undefined;
+}, {
+    tag_code?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    market?: "US" | "JP" | "UK" | "KR" | "UNIFIED" | "CRY" | "FUTURES" | undefined;
+    date?: string | undefined;
+    days?: number | undefined;
+}>;
 export type SnapshotsParams = z.infer<typeof SnapshotsParamsSchema>;
 export declare function getSnapshots(params: SnapshotsParams): Promise<{
     success: boolean;

package/dist/tools/snapshots.js

@@ -6,15 +6,28 @@ import { callApi } from '../utils/api.js';
 // 스냅샷 파라미터 스키마
 export const SnapshotsParamsSchema = z.object({
     tag_code: z.string().optional().describe('태그 코드 (예: STK005930)'),
+    market: z.enum(['KR', 'US', 'JP', 'UK', 'UNIFIED', 'CRY', 'FUTURES']).optional().describe('시장 구분 (KR/US/JP/UK/UNIFIED/CRY/FUTURES)'),
     date: z.string().optional().describe('날짜 (YYYY-MM-DD)'),
-    days: z.number().min(1).max(30).default(7).describe('최근 N일 (기본: 7)'),
-    limit: z.number().min(1).max(100).default(50).describe('결과 수'),
+    days: z.number().min(1).default(7).describe('최근 N일 (기본: 7, 무제한)'),
+    limit: z.number().min(1).default(50).describe('결과 수 (기본: 50, 무제한)'),
     offset: z.number().min(0).default(0).describe('페이지네이션 오프셋'),
 });
 // 스냅샷 조회
+// [IMPORTANT] Snapshots are generated daily at 17:00 KST (market close).
+// If you request 'today' and get no results (because it's morning in KST),
+// you MUST:
+// 1. Fetch 'yesterday's snapshot for context.
+// 2. Call 'get_news_scored' to get REAL-TIME news for the current day.
 export async function getSnapshots(params) {
-    const endpoint = params.tag_code ? `snapshots/${params.tag_code}` : 'snapshots';
+    const endpoint = 'snapshots';
     const { tag_code, ...queryParams } = params;
+    // 태그 코드가 있으면 쿼리 파라미터에 추가
+    if (tag_code) {
+        queryParams.tag_code = tag_code;
+    }
+    if (params.market) {
+        queryParams.market = params.market;
+    }
     const result = await callApi(endpoint, queryParams);
     return result;
 }

package/dist/tools/tags.d.ts

@@ -3,28 +3,68 @@
  */
 import { z } from 'zod';
 export declare const TagsSearchParamsSchema: z.ZodObject<{
-    q: z.ZodString;
-    type: z.ZodOptional<z.ZodEnum<{
-        STOCK: "STOCK";
-        SECTOR: "SECTOR";
-        THEME: "THEME";
-        CRYPTO: "CRYPTO";
-    }>>;
+    q: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["STOCK", "SECTOR", "THEME", "CRYPTO"]>>;
     limit: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    type?: "STOCK" | "SECTOR" | "THEME" | "CRYPTO" | undefined;
+    q?: string | undefined;
+    query?: string | undefined;
+}, {
+    type?: "STOCK" | "SECTOR" | "THEME" | "CRYPTO" | undefined;
+    limit?: number | undefined;
+    q?: string | undefined;
+    query?: string | undefined;
+}>;
 export declare const TagsMatchParamsSchema: z.ZodObject<{
     text: z.ZodString;
-    types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        STOCK: "STOCK";
-        SECTOR: "SECTOR";
-        THEME: "THEME";
-        CRYPTO: "CRYPTO";
-    }>>>;
+    types: z.ZodOptional<z.ZodArray<z.ZodEnum<["STOCK", "SECTOR", "THEME", "CRYPTO"]>, "many">>;
     limit: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    limit: number;
+    types?: ("STOCK" | "SECTOR" | "THEME" | "CRYPTO")[] | undefined;
+}, {
+    text: string;
+    limit?: number | undefined;
+    types?: ("STOCK" | "SECTOR" | "THEME" | "CRYPTO")[] | undefined;
+}>;
 export type TagsSearchParams = z.infer<typeof TagsSearchParamsSchema>;
 export type TagsMatchParams = z.infer<typeof TagsMatchParamsSchema>;
-export declare function searchTags(params: TagsSearchParams): Promise<{
+export declare const SearchTagsParamsSchema: z.ZodObject<{
+    q: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["STOCK", "SECTOR", "THEME", "CRYPTO"]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    type?: "STOCK" | "SECTOR" | "THEME" | "CRYPTO" | undefined;
+    q?: string | undefined;
+    query?: string | undefined;
+}, {
+    type?: "STOCK" | "SECTOR" | "THEME" | "CRYPTO" | undefined;
+    limit?: number | undefined;
+    q?: string | undefined;
+    query?: string | undefined;
+}>;
+export declare const MatchTagsParamsSchema: z.ZodObject<{
+    text: z.ZodString;
+    types: z.ZodOptional<z.ZodArray<z.ZodEnum<["STOCK", "SECTOR", "THEME", "CRYPTO"]>, "many">>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    limit: number;
+    types?: ("STOCK" | "SECTOR" | "THEME" | "CRYPTO")[] | undefined;
+}, {
+    text: string;
+    limit?: number | undefined;
+    types?: ("STOCK" | "SECTOR" | "THEME" | "CRYPTO")[] | undefined;
+}>;
+export declare function searchTags(params: TagsSearchParams & {
+    query?: string;
+}): Promise<{
     success: boolean;
     data: Array<{
         tag_code: string;

package/dist/tools/tags.js

@@ -5,7 +5,8 @@ import { z } from 'zod';
 import { callApi, callApiPost } from '../utils/api.js';
 // 태그 검색 파라미터 스키마
 export const TagsSearchParamsSchema = z.object({
-    q: z.string().describe('검색어 (예: 삼성, 반도체)'),
+    q: z.string().describe('검색어 (예: 삼성, 반도체)').optional(),
+    query: z.string().optional().describe('검색어 alias'), // [FIX] LLM often sends 'query'
     type: z.enum(['STOCK', 'SECTOR', 'THEME', 'CRYPTO']).optional().describe('태그 타입'),
     limit: z.number().min(1).max(50).default(20).describe('결과 수'),
 });
@@ -15,9 +16,19 @@ export const TagsMatchParamsSchema = z.object({
     types: z.array(z.enum(['STOCK', 'SECTOR', 'THEME', 'CRYPTO'])).optional().describe('태그 타입 필터'),
     limit: z.number().min(1).max(20).default(10).describe('결과 수'),
 });
+export const SearchTagsParamsSchema = TagsSearchParamsSchema;
+export const MatchTagsParamsSchema = TagsMatchParamsSchema;
 // 태그 검색
 export async function searchTags(params) {
-    const result = await callApi('tags/search', params);
+    // [FIX] Alias mapping: query -> q
+    if (!params.q && params.query) {
+        params.q = params.query;
+    }
+    if (!params.q) {
+        throw new Error("검색어(q 또는 query)가 필요합니다.");
+    }
+    const { query, ...apiParams } = params; // Remove 'query' alias from API call
+    const result = await callApi('tags/search', apiParams);
     return result;
 }
 // 태그 매칭 (텍스트 → 태그)