Upload 25 files

scripts/chunk_handlers.py

@@ -922,7 +922,14 @@ def handle_credit_cards(data: Any, context: Dict[str, Any]) -> List[Dict[str, An
         if family_fee and isinstance(family_fee, dict) and family_fee.get("amount"):
             content += f"  - 가족카드: {family_fee.get('amount'):,} {family_fee.get('currency', '')}\n"
         if waiver_conds:
-            content += f"  - 면제 조건: {', '.join(waiver_conds[:2])}\n"
+            # Handle both list of strings and list of dicts
+            waiver_strs = []
+            for item in waiver_conds[:2]:
+                if isinstance(item, dict):
+                    waiver_strs.append(item.get("summary", item.get("condition", str(item))))
+                else:
+                    waiver_strs.append(str(item))
+            content += f"  - 면제 조건: {', '.join(waiver_strs)}\n"
         
         # 카드 유형 (Phase 3)
         if card_type:
@@ -985,7 +992,14 @@ def handle_credit_cards(data: Any, context: Dict[str, Any]) -> List[Dict[str, An
         if lounge_access or lounge_visits:
             content += "\n라운지 혜택:\n"
             if lounge_access:
-                content += f"  - 이용 가능: {', '.join(lounge_access[:5])}\n"
+                # Handle both list of strings and list of dicts
+                lounge_names = []
+                for item in lounge_access[:5]:
+                    if isinstance(item, dict):
+                        lounge_names.append(item.get("lounge_name", item.get("name", str(item))))
+                    else:
+                        lounge_names.append(str(item))
+                content += f"  - 이용 가능: {', '.join(lounge_names)}\n"
             if lounge_visits:
                 content += f"  - 연간 이용: {lounge_visits}회\n"
             if lounge_guest:
@@ -1195,10 +1209,53 @@ def handle_pricing(data: Any, context: Dict[str, Any]) -> List[Dict[str, Any]]:
     """pricing, pricing_2026 등 다양한 형식 처리"""
     chunks = []
     hotel_name, hotel_name_ko, chain = get_hotel_info(context)
-    
+
     if data is None:
         return chunks
-    
+
+    # --- 리스트 구조 처리 (raw_pricing_data 등) ---
+    if isinstance(data, list):
+        for item in data[:10]:
+            if not isinstance(item, dict):
+                continue
+
+            room_type = item.get("room_type_code", item.get("room_type", ""))
+            room_name = item.get("room_type_full_name", "")
+            rate_type = item.get("rate_type", "")
+            rate_krw = item.get("rate_krw", 0)
+            rate_usd = item.get("rate_usd_approx", 0)
+
+            content = format_hotel_header(hotel_name, hotel_name_ko, chain)
+            content += f"객실 유형: {room_type}\n"
+            if room_name:
+                content += f"객실명: {room_name}\n"
+            if rate_type:
+                content += f"요금 유형: {rate_type}\n"
+
+            content += f"가격:\n"
+            if rate_krw:
+                content += f"  - KRW: ₩{rate_krw:,}\n"
+            if rate_usd:
+                content += f"  - USD: ${rate_usd}\n"
+
+            content += DISCLAIMER_PRICE
+
+            chunks.append({
+                "content": content.strip(),
+                "metadata": {
+                    "type": "room_pricing_raw",
+                    "hotel_name": hotel_name,
+                    "room_type": room_type,
+                    "rate_krw": rate_krw
+                }
+            })
+
+        return chunks
+
+    # 딕셔너리 구조가 아니면 빈 배열 반환
+    if not isinstance(data, dict):
+        return chunks
+
     # --- 형식 1: annual_statistics 구조 (Westin 등) ---
     annual_stats = data.get("annual_statistics", {})
     points_stats = annual_stats.get("points", {})
@@ -1330,10 +1387,60 @@ def handle_pricing_analysis(data: Any, context: Dict[str, Any]) -> List[Dict[str
     """pricing_analysis 형식 처리 (Josun Palace 등)"""
     chunks = []
     hotel_name, hotel_name_ko, chain = get_hotel_info(context)
-    
+
+    # 리스트 구조인 경우 처리 (ClassicTravel 등)
+    if isinstance(data, list):
+        for item in data[:10]:
+            if not isinstance(item, dict):
+                continue
+
+            hotel_id = item.get("hotel_id", "")
+            item_hotel_name = item.get("hotel_name", hotel_name)
+            search_date = item.get("search_date", "")
+            stay_nights = item.get("stay_nights", 1)
+            currency = item.get("currency", "KRW")
+
+            content = format_hotel_header(item_hotel_name, hotel_name_ko, chain)
+            content += f"호텔 ID: {hotel_id}\n"
+            content += f"검색 날짜: {search_date}\n"
+            content += f"숙박 기간: {stay_nights}박\n\n"
+
+            room_rates = item.get("room_rates", [])
+            if room_rates:
+                content += "객실 요금:\n"
+                for rate in room_rates[:5]:
+                    room_type = rate.get("room_type", "")
+                    rate_plan = rate.get("rate_plan", "")
+                    rate_desc = rate.get("rate_plan_description", "")
+                    price_krw = rate.get("price_krw", 0)
+
+                    content += f"  - {room_type}\n"
+                    content += f"    요금제: {rate_plan}\n"
+                    if rate_desc:
+                        content += f"    설명: {rate_desc}\n"
+                    content += f"    가격: ₩{price_krw:,}\n"
+
+            content += DISCLAIMER_PRICE
+
+            chunks.append({
+                "content": content.strip(),
+                "metadata": {
+                    "type": "room_pricing",
+                    "hotel_name": item_hotel_name,
+                    "hotel_id": hotel_id,
+                    "currency": currency
+                }
+            })
+
+        return chunks
+
+    # 기존 딕셔너리 구조 처리
+    if not isinstance(data, dict):
+        return chunks
+
     points_stats = data.get("points_price_stats", {})
     cash_stats = data.get("cash_price_stats", {})
-    
+
     if not points_stats:
         return chunks
     
@@ -1989,35 +2096,104 @@ def handle_member_rates(data: Any, context: Dict[str, Any]) -> List[Dict[str, An
 # ===========================================================================
 
 def handle_hotel_facilities(data: Any, context: Dict[str, Any]) -> List[Dict[str, Any]]:
-    """hotel_facilities, other_facilities 처리"""
+    """hotel_facilities, other_facilities, hotel_amenities_summary, 
+    executive_lounge, pulse8_wellness 등 다양한 시설 데이터 처리
+    
+    지원 형태:
+    1. 리스트 형태 (기존 hotel_facilities)
+    2. 딕셔너리 형태 (executive_lounge, pulse8_wellness 등)
+    3. 문자열 리스트 (hotel_amenities_summary)
+    """
     chunks = []
     hotel_name, hotel_name_ko, chain = get_hotel_info(context)
     
     if data is None:
         return chunks
     
-    facilities = data if isinstance(data, list) else [data]
-    
-    # 시설을 하나의 청크로 통합
     content = format_hotel_header(hotel_name, hotel_name_ko, chain)
-    content += "호텔 시설:\n"
     
-    for facility in facilities[:15]:
-        if isinstance(facility, dict):
-            name = facility.get("name", facility.get("facility_name", "N/A"))
-            desc = facility.get("description", "")
-            content += f"  - {name}"
-            if desc:
-                content += f": {desc[:60]}"
-            content += "\n"
-        elif isinstance(facility, str):
-            content += f"  - {facility}\n"
+    # 데이터 형태에 따른 처리
+    if isinstance(data, dict):
+        # 딕셔너리 형태 (executive_lounge, pulse8_wellness 등)
+        facility_name = data.get("name", data.get("lounge_name", "시설"))
+        location = data.get("location", "")
+        hours = data.get("operating_hours", "")
+        
+        content += f"시설: {facility_name}\n"
+        if location:
+            content += f"위치: {location}\n"
+        if hours:
+            content += f"운영시간: {hours}\n"
+        
+        # 전망
+        if data.get("view"):
+            content += f"전망: {data.get('view')}\n"
+        
+        # 서비스/시설 목록
+        services = data.get("services", data.get("facilities", []))
+        if services:
+            content += "\n제공 서비스/시설:\n"
+            for service in services[:10]:
+                if isinstance(service, dict):
+                    s_name = service.get("name", "N/A")
+                    s_desc = service.get("description", "")
+                    content += f"  - {s_name}"
+                    if s_desc:
+                        content += f": {s_desc[:60]}"
+                    content += "\n"
+                else:
+                    content += f"  - {service}\n"
+        
+        # 드레스코드
+        if data.get("dress_code"):
+            content += f"\n드레스코드: {data.get('dress_code')}\n"
+        
+        # 연령 제한
+        if data.get("age_restriction"):
+            content += f"연령 제한: {data.get('age_restriction')}\n"
+        
+        # 메타데이터 타입 결정
+        meta_type = "hotel_facility"
+        if "lounge" in str(data).lower():
+            meta_type = "executive_lounge"
+        elif "wellness" in str(data).lower() or "pulse" in str(data).lower():
+            meta_type = "wellness_facility"
+        
+    elif isinstance(data, list):
+        # 리스트 형태
+        facilities = data
+        
+        # 첫 번째 항목 확인하여 타입 결정
+        first_item = facilities[0] if facilities else None
+        
+        if first_item and isinstance(first_item, str):
+            # 문자열 리스트 (hotel_amenities_summary)
+            content += "호텔 시설 및 서비스 요약:\n"
+            for amenity in facilities[:20]:
+                content += f"  ✓ {amenity}\n"
+            meta_type = "hotel_amenities_summary"
+        else:
+            # 딕셔너리 리스트 (기존 hotel_facilities)
+            content += "호텔 시설:\n"
+            for facility in facilities[:15]:
+                if isinstance(facility, dict):
+                    name = facility.get("name", facility.get("facility_name", "N/A"))
+                    desc = facility.get("description", "")
+                    content += f"  - {name}"
+                    if desc:
+                        content += f": {desc[:60]}"
+                    content += "\n"
+                elif isinstance(facility, str):
+                    content += f"  - {facility}\n"
+            meta_type = "hotel_facilities"
+    else:
+        return chunks
     
     if len(content) > 100:
         chunks.append({
             "content": content.strip(),
             "metadata": {
-                "type": "hotel_facilities",
+                "type": meta_type,
                 "hotel_name": hotel_name
             }
         })
@@ -2358,6 +2534,82 @@ def handle_dining_programs(data: Any, context: Dict[str, Any]) -> List[Dict[str,
     return chunks
 
 
+# ===========================================================================
+# 핸들러: 항공 파트너십 (Flying Blue → Korean Air 등)
+# ===========================================================================
+
+def handle_airline_partnership(data: Any, context: Dict[str, Any]) -> List[Dict[str, Any]]:
+    """airline_partnership 처리 - 파트너 프로그램으로 타항공사 예약 정보"""
+    chunks = []
+    
+    if not data or not isinstance(data, dict):
+        return chunks
+    
+    partner_program = data.get("partner_program", "N/A")
+    operating_airline = data.get("operating_airline", "UNKNOWN")
+    alliance = data.get("alliance", "")
+    currency_name = data.get("currency_name", "포인트")
+    pricing_model = data.get("pricing_model", "")
+    pricing_desc = data.get("pricing_model_description", "")
+    
+    content = f"""# {partner_program}로 {operating_airline} 예약하기
+
+**파트너 프로그램**: {partner_program}
+**운항 항공사**: {operating_airline}
+**제휴**: {alliance if alliance else "N/A"}
+**포인트 단위**: {currency_name}
+"""
+    
+    if pricing_model:
+        content += f"**가격 정책**: {pricing_model}"
+        if pricing_desc:
+            content += f" - {pricing_desc}"
+        content += "\n"
+    
+    # 운영 주체
+    operator = data.get("partner_program_operator")
+    if operator:
+        content += f"**프로그램 운영**: {operator}\n"
+    
+    # 제한사항
+    restrictions = data.get("restrictions", [])
+    if restrictions:
+        content += "\n## ⚠️ 예약 제한사항\n"
+        for restriction in restrictions[:10]:
+            if isinstance(restriction, dict):
+                r_type = restriction.get("restriction_type", "")
+                desc = restriction.get("description", "")
+                content += f"- **{r_type}**: {desc}\n"
+            else:
+                content += f"- {restriction}\n"
+    
+    # 예약 가능 항목
+    available = data.get("available_booking_classes", [])
+    if available:
+        content += "\n## ✅ 예약 가능 클래스\n"
+        for cls in available[:5]:
+            if isinstance(cls, dict):
+                cabin = cls.get("cabin_class", "")
+                is_available = cls.get("available", True)
+                status = "✅ 가능" if is_available else "❌ 불가"
+                content += f"- {cabin}: {status}\n"
+    
+    content += DISCLAIMER_SHORT
+    
+    if len(content) > 100:
+        chunks.append({
+            "content": content.strip(),
+            "metadata": {
+                "type": "airline_partnership",
+                "partner_program": partner_program,
+                "operating_airline": operating_airline,
+                "alliance": alliance
+            }
+        })
+    
+    return chunks
+
+
 # ===========================================================================
 # 핸들러: 항공 프로그램 (Phase 2)
 # ===========================================================================
@@ -4399,7 +4651,12 @@ def handle_route_classifications(data: Any, context: Dict[str, Any]) -> List[Dic
 # ===========================================================================
 
 def handle_award_chart_entries(data: Any, context: Dict[str, Any]) -> List[Dict[str, Any]]:
-    """award_chart_entries 처리 - 어워드 차트 상세 항목"""
+    """award_chart_entries 처리 - 어워드 차트 상세 항목
+    
+    두 가지 구조 지원:
+    1) Flat 구조: [{"region": "...", "route_type": "...", "economy_low": ...}, ...]
+    2) Nested 구조: [{"region": "...", "routes": [{"route": "...", ...}]}, ...]
+    """
     chunks = []
     if not data:
         return chunks
@@ -4407,62 +4664,124 @@ def handle_award_chart_entries(data: Any, context: Dict[str, Any]) -> List[Dict[
     items = data if isinstance(data, list) else [data]
     airline = context.get("chain", "UNKNOWN")
     
-    # 지역별로 그룹화
-    region_entries = {}
-    for item in items:
-        region = item.get("region", "OTHER")
-        if region not in region_entries:
-            region_entries[region] = []
-        region_entries[region].append(item)
+    # 구조 탐지: 첫 번째 항목에 'routes' 키가 있으면 중첩 구조
+    is_nested = any(isinstance(item, dict) and "routes" in item for item in items)
     
-    for region, entries in region_entries.items():
-        content = f"# {airline} 어워드 차트 - {region}\n\n"
-        
-        for entry in entries:
-            route_type = entry.get("route_type", "")
-            trip_type = entry.get("trip_type", "")
-            trip_label = "왕복" if trip_type == "ROUND_TRIP" else "편도"
+    if is_nested:
+        # === 중첩 구조 처리 (Flying Blue 스타일) ===
+        for region_data in items:
+            if not isinstance(region_data, dict):
+                continue
             
-            content += f"## {route_type} ({trip_label})\n"
+            region = region_data.get("region", "OTHER")
+            region_name = region_data.get("region_name", region)
+            routes = region_data.get("routes", [])
             
-            # 좌석 등급별 마일리지
-            economy_low = entry.get("economy_low")
-            economy_high = entry.get("economy_high")
-            if economy_low or economy_high:
-                content += f"- **일반석**: {economy_low:,}~{economy_high:,} 마일\n"
+            if not routes:
+                continue
             
-            premium_economy_low = entry.get("premium_economy_low")
-            premium_economy_high = entry.get("premium_economy_high")
-            if premium_economy_low or premium_economy_high:
-                content += f"- **프리미엄 이코노미**: {premium_economy_low:,}~{premium_economy_high:,} 마일\n"
+            content = f"# {airline} 어워드 차트 - {region_name}\n\n"
+            content += "| 노선 | 출발 | 도착 | 이코노미 | 비즈니스 | 비고 |\n"
+            content += "|------|------|------|----------|----------|------|\n"
             
-            business_low = entry.get("business_low")
-            business_high = entry.get("business_high")
-            if business_low or business_high:
-                content += f"- **비즈니스/프레스티지**: {business_low:,}~{business_high:,} 마일\n"
+            for route in routes[:50]:  # 지역당 최대 50개 노선
+                if not isinstance(route, dict):
+                    continue
+                
+                route_code = route.get("route", "")
+                origin_name = route.get("origin_name", route.get("origin", ""))
+                dest_name = route.get("destination_name", route.get("destination", ""))
+                
+                # 이코노미/비즈니스 포인트
+                eco_low = route.get("economy_low")
+                eco_high = route.get("economy_high")
+                biz_low = route.get("business_low")
+                biz_high = route.get("business_high")
+                
+                eco_str = f"{eco_low:,}" if eco_low else "N/A"
+                if eco_high and eco_high != eco_low:
+                    eco_str += f"~{eco_high:,}"
+                
+                if biz_low:
+                    biz_str = f"{biz_low:,}"
+                    if biz_high and biz_high != biz_low:
+                        biz_str += f"~{biz_high:,}"
+                else:
+                    biz_str = "N/A"
+                
+                notes = route.get("notes", "") or ""
+                
+                content += f"| {route_code} | {origin_name} | {dest_name} | {eco_str} | {biz_str} | {notes} |\n"
             
-            first_low = entry.get("first_low")
-            first_high = entry.get("first_high")
-            if first_low or first_high:
-                content += f"- **일등석**: {first_low:,}~{first_high:,} 마일\n"
+            content += DISCLAIMER_SHORT
             
-            notes = entry.get("notes", "")
-            if notes:
-                content += f"- 참고: {notes}\n"
+            if len(content) > 150:
+                chunks.append({
+                    "content": content.strip(),
+                    "metadata": {
+                        "type": "award_chart_entries",
+                        "airline": airline,
+                        "region": region,
+                        "region_name": region_name
+                    }
+                })
+    else:
+        # === 기존 Flat 구조 처리 ===
+        region_entries = {}
+        for item in items:
+            region = item.get("region", "OTHER")
+            if region not in region_entries:
+                region_entries[region] = []
+            region_entries[region].append(item)
+        
+        for region, entries in region_entries.items():
+            content = f"# {airline} 어워드 차트 - {region}\n\n"
             
-            content += "\n"
-        
-        content += DISCLAIMER_SHORT
-        
-        if len(content) > 100:
-            chunks.append({
-                "content": content.strip(),
-                "metadata": {
-                    "type": "award_chart_entries",
-                    "airline": airline,
-                    "region": region
-                }
-            })
+            for entry in entries:
+                route_type = entry.get("route_type", "")
+                trip_type = entry.get("trip_type", "")
+                trip_label = "왕복" if trip_type == "ROUND_TRIP" else "편도"
+                
+                content += f"## {route_type} ({trip_label})\n"
+                
+                # 좌석 등급별 마일리지
+                economy_low = entry.get("economy_low")
+                economy_high = entry.get("economy_high")
+                if economy_low or economy_high:
+                    content += f"- **일반석**: {economy_low:,}~{economy_high:,} 마일\n"
+                
+                premium_economy_low = entry.get("premium_economy_low")
+                premium_economy_high = entry.get("premium_economy_high")
+                if premium_economy_low or premium_economy_high:
+                    content += f"- **프리미엄 이코노미**: {premium_economy_low:,}~{premium_economy_high:,} 마일\n"
+                
+                business_low = entry.get("business_low")
+                business_high = entry.get("business_high")
+                if business_low or business_high:
+                    content += f"- **비즈니스/프레스티지**: {business_low:,}~{business_high:,} 마일\n"
+                
+                first_low = entry.get("first_low")
+                first_high = entry.get("first_high")
+                if first_low or first_high:
+                    content += f"- **일등석**: {first_low:,}~{first_high:,} 마일\n"
+                
+                notes = entry.get("notes", "")
+                if notes:
+                    content += f"- 참고: {notes}\n"
+                
+                content += "\n"
+            
+            content += DISCLAIMER_SHORT
+            
+            if len(content) > 100:
+                chunks.append({
+                    "content": content.strip(),
+                    "metadata": {
+                        "type": "award_chart_entries",
+                        "airline": airline,
+                        "region": region
+                    }
+                })
     
     return chunks
 
@@ -4739,7 +5058,13 @@ def handle_key_insights(data: Any, context: Dict[str, Any]) -> List[Dict[str, An
 
 
 def handle_usage_recommendations(data: Any, context: Dict[str, Any]) -> List[Dict[str, Any]]:
-    """usage_recommendations 처리 - 마일리지 사용 권장사항"""
+    """usage_recommendations 처리 - 마일리지 사용 권장사항
+    
+    세 가지 구조 지원:
+    1) 최상위 List 구조: [{"category": "...", "routes": [...]}]
+    2) Dict 구조 (값이 dict): {"highly_recommended": {"description": "...", "routes": [...]}}
+    3) Dict 구조 (값이 list): {"highly_recommended": [{route_data...}], "recommended": [...]}
+    """
     chunks = []
     if not data:
         return chunks
@@ -4748,53 +5073,97 @@ def handle_usage_recommendations(data: Any, context: Dict[str, Any]) -> List[Dic
     
     content = f"# {airline} 마일리지 사용 권장사항\n\n"
     
-    # highly_recommended
-    highly_rec = data.get("highly_recommended", {})
-    if highly_rec:
-        desc = highly_rec.get("description", "강력 추천")
-        content += f"## {desc}\n"
-        routes = highly_rec.get("routes", [])
-        for route in routes[:10]:
-            if isinstance(route, dict):
-                r_name = route.get("route", "")
-                cabin = route.get("cabin_class", "")
-                season = route.get("recommended_season", "")
-                eff_range = route.get("efficiency_range", "")
-                content += f"- **{r_name}** ({cabin}, {season}): {eff_range}원/마일\n"
-        content += "\n"
-    
-    # recommended
-    rec = data.get("recommended", {})
-    if rec:
-        desc = rec.get("description", "추천")
-        content += f"## {desc}\n"
-        routes = rec.get("routes", [])
-        for route in routes[:10]:
-            if isinstance(route, dict):
-                r_name = route.get("route", "")
-                cabin = route.get("cabin_class", "")
-                season = route.get("recommended_season", "")
-                eff_range = route.get("efficiency_range", "")
-                content += f"- **{r_name}** ({cabin}, {season}): {eff_range}원/마일\n"
-        content += "\n"
+    # 최상위가 리스트인 경우
+    if isinstance(data, list):
+        for idx, item in enumerate(data[:20]):
+            if isinstance(item, dict):
+                category = item.get("category", item.get("recommendation_type", f"항목 {idx+1}"))
+                desc = item.get("description", "")
+                routes = item.get("routes", [])
+                
+                content += f"## {category}\n"
+                if desc:
+                    content += f"{desc}\n\n"
+                
+                for route in routes[:10]:
+                    if isinstance(route, dict):
+                        r_name = route.get("route", route.get("route_code", ""))
+                        cabin = route.get("cabin_class", "")
+                        season = route.get("recommended_season", "")
+                        eff_range = route.get("efficiency_range", route.get("efficiency", ""))
+                        content += f"- **{r_name}** ({cabin}"
+                        if season:
+                            content += f", {season}"
+                        content += f"): {eff_range}\n"
+                    else:
+                        content += f"- {route}\n"
+                content += "\n"
+            else:
+                # 단순 문자열
+                content += f"- {item}\n"
     
-    # not_recommended
-    not_rec = data.get("not_recommended", {})
-    if not_rec:
-        desc = not_rec.get("description", "비추천")
-        content += f"## {desc}\n"
-        routes = not_rec.get("routes", [])
-        for route in routes[:10]:
-            if isinstance(route, dict):
-                r_name = route.get("route", "")
-                cabin = route.get("cabin_class", "")
-                eff_range = route.get("efficiency_range", "")
-                content += f"- **{r_name}** ({cabin}): {eff_range}원/마일\n"
-        content += "\n"
+    # 딕셔너리 구조 처리
+    elif isinstance(data, dict):
+        categories = [
+            ("highly_recommended", "강력 추천", 5),
+            ("recommended", "추천", 3),
+            ("not_recommended", "비추천", 1),
+            ("booking_strategy", "예약 전략", 4),
+        ]
+        
+        for key, default_title, _ in categories:
+            category_data = data.get(key)
+            if not category_data:
+                continue
+            
+            # 값이 딕셔너리인 경우 (기존 구조)
+            if isinstance(category_data, dict):
+                desc = category_data.get("description", default_title)
+                content += f"## {desc}\n"
+                routes = category_data.get("routes", [])
+                for route in routes[:10]:
+                    if isinstance(route, dict):
+                        r_name = route.get("route", "")
+                        cabin = route.get("cabin_class", "")
+                        season = route.get("recommended_season", "")
+                        eff_range = route.get("efficiency_range", "")
+                        if key == "not_recommended":
+                            content += f"- **{r_name}** ({cabin}): {eff_range}원/마일\n"
+                        else:
+                            content += f"- **{r_name}** ({cabin}, {season}): {eff_range}원/마일\n"
+                content += "\n"
+            
+            # 값이 리스트인 경우 (Aeroplan 구조)
+            elif isinstance(category_data, list):
+                content += f"## {default_title}\n"
+                for item in category_data[:10]:
+                    if isinstance(item, dict):
+                        # route_category 또는 route
+                        route_cat = item.get("route_category", item.get("route", ""))
+                        cabin = item.get("cabin_class", "")
+                        points = item.get("points_required", "")
+                        recommendation = item.get("recommendation", item.get("reason", ""))
+                        title = item.get("title", "")
+                        desc = item.get("description", "")
+                        
+                        if title:  # booking_strategy 형식
+                            content += f"- **{title}**: {desc}\n"
+                        elif route_cat:
+                            content += f"- **{route_cat}** ({cabin}"
+                            if points:
+                                # points가 숫자인지 확인 후 천 단위 구분자 적용
+                                if isinstance(points, (int, float)):
+                                    content += f", {points:,}pts"
+                                else:
+                                    content += f", {points}pts"
+                            content += f"): {recommendation}\n"
+                        else:
+                            content += f"- {item}\n"
+                content += "\n"
     
     content += DISCLAIMER_SHORT
     
-    if len(content) > 100:
+    if len(content) > 150:
         chunks.append({
             "content": content.strip(),
             "metadata": {
@@ -5598,6 +5967,116 @@ def handle_news_updates(data: Any, context: Dict[str, Any]) -> List[Dict[str, An
     return chunks
 
 
+
+# ===========================================================================
+# 핸들러: 월별 가격 상세 (현금/포인트)
+# ===========================================================================
+
+def handle_monthly_prices_detailed(data: Any, context: Dict[str, Any]) -> List[Dict[str, Any]]:
+    """monthly_cash_prices_detailed, monthly_points_prices_detailed 처리
+    
+    월별 날짜별 상세 가격 데이터를 시즌별로 요약하여 청크 생성
+    """
+    chunks = []
+    hotel_name, hotel_name_ko, chain = get_hotel_info(context)
+    
+    if not isinstance(data, dict):
+        return chunks
+    
+    # 가격 유형 판단 (포인트 vs 현금)
+    is_points = any("points" in str(list(v[0].keys()) if isinstance(v, list) and v else []) 
+                    for v in data.values() if v)
+    
+    price_type = "포인트" if is_points else "현금"
+    content_type = "monthly_points_prices" if is_points else "monthly_cash_prices"
+    
+    content = format_hotel_header(hotel_name, hotel_name_ko, chain)
+    content += f"월별 {price_type} 가격 상세:\n\n"
+    
+    # 월별로 통계 계산
+    for month_key, prices_list in list(data.items())[:12]:
+        if not isinstance(prices_list, list) or not prices_list:
+            continue
+        
+        # 월 이름 포맷
+        month_name = month_key.replace("_", " ").title()
+        
+        # 가격/포인트 추출
+        if is_points:
+            values = [p.get("points", 0) for p in prices_list if isinstance(p, dict) and p.get("points")]
+        else:
+            values = [p.get("price_krw", 0) for p in prices_list if isinstance(p, dict) and p.get("price_krw")]
+        
+        if not values:
+            continue
+        
+        min_val = min(values)
+        max_val = max(values)
+        
+        if is_points:
+            content += f"• {month_name}: {min_val:,}P ~ {max_val:,}P\n"
+        else:
+            content += f"• {month_name}: ₩{min_val:,} ~ ₩{max_val:,}\n"
+    
+    content += DISCLAIMER_PRICE
+    
+    if len(content) > 150:
+        chunks.append({
+            "content": content.strip(),
+            "metadata": {
+                "type": content_type,
+                "hotel_name": hotel_name
+            }
+        })
+    
+    return chunks
+
+
+# ===========================================================================
+# 핸들러: 객실 유형별 요금
+# ===========================================================================
+
+def handle_room_rates_by_type(data: Any, context: Dict[str, Any]) -> List[Dict[str, Any]]:
+    """room_rates_by_type 처리 - 객실 유형별 멤버 요금"""
+    chunks = []
+    hotel_name, hotel_name_ko, chain = get_hotel_info(context)
+    
+    if not isinstance(data, list) or not data:
+        return chunks
+    
+    content = format_hotel_header(hotel_name, hotel_name_ko, chain)
+    content += "객실 유형별 멤버 요금:\n\n"
+    
+    for room in data[:15]:
+        if not isinstance(room, dict):
+            continue
+        
+        room_type = room.get("room_type", "N/A")
+        rate = room.get("member_rate_krw", room.get("rate", "N/A"))
+        notes = room.get("notes", "")
+        
+        if isinstance(rate, (int, float)):
+            content += f"• {room_type}: ₩{rate:,}"
+        else:
+            content += f"• {room_type}: {rate}"
+        
+        if notes:
+            content += f" ({notes})"
+        content += "\n"
+    
+    content += DISCLAIMER_PRICE
+    
+    chunks.append({
+        "content": content.strip(),
+        "metadata": {
+            "type": "room_rates_by_type",
+            "hotel_name": hotel_name
+        }
+    })
+    
+    return chunks
+
+
 # ===========================================================================
 # 키-핸들러 매핑
 # ===========================================================================
@@ -5663,6 +6142,25 @@ CHUNK_HANDLERS = {
     # 호텔 시설
     "hotel_facilities": handle_hotel_facilities,
     "other_facilities": handle_hotel_facilities,
+    
+    # 이그제큐티브 라운지 - hotel_facilities 핸들러로 통합 처리
+    "executive_lounge": handle_hotel_facilities,
+    
+    # 웰니스 시설 - hotel_facilities 핸들러로 통합 처리
+    "pulse8_wellness": handle_hotel_facilities,
+    "wellness_facility": handle_hotel_facilities,
+    "spa_wellness": handle_hotel_facilities,
+    
+    # 호텔 어메니티 요약 - hotel_facilities 핸들러로 통합 처리
+    "hotel_amenities_summary": handle_hotel_facilities,
+    "amenities_summary": handle_hotel_facilities,
+    
+    # 월별 가격 상세 (고유 구조로 별도 핸들러 유지)
+    "monthly_cash_prices_detailed": handle_monthly_prices_detailed,
+    "monthly_points_prices_detailed": handle_monthly_prices_detailed,
+    
+    # 객실 유형별 요금 (고유 구조로 별도 핸들러 유지)
+    "room_rates_by_type": handle_room_rates_by_type,
 
     # 객실 유형
     "room_types": handle_room_types,
@@ -5742,11 +6240,13 @@ CHUNK_HANDLERS = {
     # --- 항공 프로그램 (Phase 2) ---
     "airline_programs": handle_airline_programs,
     "airline_program": handle_airline_programs,
+    "airline_partnership": handle_airline_partnership,  # Flying Blue → Korean Air 등
     "airline_tiers": handle_airline_tiers,
     "airline_tier": handle_airline_tiers,
     "award_charts": handle_award_charts,
     "award_chart": handle_award_charts,
     "airline_earning_rules": handle_airline_earning_rules,
+
     
     # --- 항공 운임 (Airline Fares) ---
     "airline_fare_tables": handle_airline_fare_tables,
@@ -5871,6 +6371,74 @@ CHUNK_HANDLERS = {
     "mileage_purchase_programs": handle_mileage_purchase_programs,
     "price_summary": handle_mileage_price_summary,
     "insights": handle_mileage_insights,
+
+    # --- 미처리 키들을 적절한 핸들러에 매핑 ---
+    "raw_pricing_data": handle_pricing,               # ClassicTravel 원시 가격 데이터
+    "rate_descriptions": handle_benefits,             # ClassicTravel 요금 설명
+    "brunch_options": handle_breakfast,               # ClassicTravel 브런치 옵션
+    "regional_info": handle_hotel_facilities,         # ClassicTravel 지역 정보
+    "breakfast_benefit_participating_brands": handle_benefits, # GHA Discovery 조식 혜택 참여 브랜드
+    "direct_channels": handle_benefits,               # GHA Discovery 직접 채널
+    "irregular_prices_observed": handle_pricing,      # 항공사 불규칙 가격 관찰
+    "route_availability_patterns": handle_airline_programs, # 항공사 노선 가용성 패턴
+    "booking_policies": handle_benefits,              # WhataHotel 예약 정책 (서비스 수수료, 결제 정책, 취소 정책)
+    
+    # --- AMEX Platinum 카드 전용 키 매핑 ---
+    "travel_programs": handle_benefits,               # FHR, THC 등 여행 프로그램
+    "statement_credit_timing": handle_benefits,       # 스테이트먼트 크레딧 처리 시간
+    "statement_credit_troubleshooting": handle_benefits, # 크레딧 문제 해결 팁
+    "tier_eligibility_comparison": handle_benefits,   # 등급 자격 비교표
+    "benefit_exclusions": handle_benefits,            # 혜택 제외 항목
+    "benefit_calendar": handle_benefits,              # 혜택 일정 (월간/분기/연간)
+    "contact_information": handle_benefits,           # 연락처 정보
+    "important_notices": handle_benefits,             # 중요 공지사항
+    "benefit_value_summary": handle_benefits,         # 혜택 가치 요약
+    
+    # --- Chase 카드 관련 키 매핑 ---
+    "lounge_access_details": handle_benefits,         # 공항 라운지 접근 정보
+    "spending_tier_benefits": handle_benefits,        # 지출 등급별 혜택
+    "balance_transfer_conditions": handle_benefits,   # 잔액 이체 조건
+    "chase_pay_over_time": handle_benefits,           # Chase 할부 결제 옵션
+    "state_notices": handle_benefits,                 # 주별 고지사항
+    "mileageplus_integration": handle_benefits,       # MileagePlus 연동 정보
+    "privacy_legal": handle_benefits,                 # 개인정보/법적 고지
+    "concierge_services": handle_benefits,            # 컨시어지 서비스
+    "other_info": handle_benefits,                    # 기타 정보
+    
+    # --- 추가 미처리 키 매핑 (credit card 관련) ---
+    "ihg_membership_earning_rules": handle_benefits,  # IHG 멤버십 적립 규칙
+    "points_expiration_policy": handle_benefits,      # 포인트 만료 정책
+    "terms_summary": handle_benefits,                 # 약관 요약
+    "hyatt_brands_reference": handle_hotel_brands,    # Hyatt 브랜드 목록
+    "ihg_program_earning_info": handle_benefits,      # IHG 프로그램 적립 정보
+    "related_cards_comparison": handle_benefits,      # 관련 카드 비교
+    "value_analysis": handle_benefits,                # 가치 분석
+    
+    # --- Disney 카드 전용 키 매핑 ---
+    "dining_eligible_restaurants": handle_benefits,   # Disney 식당 할인 대상 레스토랑
+    "tour_eligible_experiences": handle_benefits,     # Disney 투어/체험 할인 대상
+    "photo_opportunities": handle_benefits,           # Disney 카드 포토 기회
+    
+    # --- IHG/United 카드 관련 키 매핑 ---
+    "airline_program_integration": handle_benefits,   # 항공사 프로그램 연동
+
+    # --- 추가 미처리 키 매핑 (Citi/Barclays/BoA 카드) ---
+    "aadvantage_program_tiers": handle_benefits,      # AAdvantage 프로그램 등급
+    "american_eagle_operators": handle_benefits,      # American Eagle 운항사
+    "additional_benefits": handle_benefits,           # 추가 혜택
+    "insurance_benefits": handle_benefits,            # 보험 혜택
+    "security_features": handle_benefits,             # 보안 기능
+    "entertainment_program": handle_benefits,         # 엔터테인먼트 프로그램
+    "annual_benefit_value_summary": handle_benefits,  # 연간 혜택 가치 요약
+    "card_benefits": handle_benefits,                 # 카드 혜택 (최상위 키)
+    "eligibility_requirements": handle_benefits,      # 자격 요건
+    "balance_transfer_terms": handle_benefits,        # 잔액 이체 조건
+    "cash_equivalent_transactions": handle_benefits,  # 현금 등가 거래
+    "points_forfeiture_conditions": handle_benefits,  # 포인트 몰수 조건
+    "trueblue_integration": handle_benefits,          # TrueBlue 연동
+    "trueblue_points_important_info": handle_benefits, # TrueBlue 포인트 중요 정보
+    "additional_info": handle_benefits,               # 추가 정보
+    "partnership_programs": handle_benefits,          # 파트너십 프로그램
 }
 
 # 중첩 키 지원 (예: facts.pricing_analysis)
@@ -5933,6 +6501,18 @@ IGNORED_KEYS = {
     "collection_date",  # 수집일 메타데이터
     "related_documents",  # 관련 문서 참조
     
+    # AMEX 카드 관련 증거자료 및 법적 정보 (검색 가치 낮음)
+    "seller_of_travel",  # 여행 판매자 법적 정보
+    "statement_credit_evidence",  # 스테이트먼트 크레딧 증거
+    "verification_needed_evidence",  # 확인 필요 사항 증거
+    
+    # Chase 카드 관련 메타데이터 (검색 가치 낮음)
+    "related_links",  # 관련 링크 (URL 참조용)
+    "benefit_value_summary_total",  # 혜택 가치 총합 (메타데이터)
+    "spending_tier_120k_additional",  # 추가 지출 등급 (상세 내용 없음)
+    "benefit_value_evidence",  # 혜택 가치 증거 (내부용)
+    "legal_notices",  # 법적 고지사항
+    
     # Deprecated 키 (사용하지 않음)
     # "loyalty_programs" (복수) - 단, 하위 호환성 위해 핸들러는 유지
 }

src/auth/asset_parser.py

@@ -0,0 +1,213 @@
+"""
+Asset Text Parser
+==================
+
+사용자가 입력한 텍스트에서 포인트/마일리지 정보를 자동 추출합니다.
+
+예시 입력:
+- "대한항공 45,000 마일"
+- "AMEX MR 50000점"
+- "체이스 UR 30,000"
+"""
+
+import re
+from typing import Dict, Any, List, Optional
+from datetime import datetime
+
+from .config import POINT_VALUATIONS
+
+# =============================================================================
+# 프로그램 별칭 매핑
+# =============================================================================
+
+PROGRAM_ALIASES = {
+    # 한국 항공
+    "대한항공": "KOREAN_AIR",
+    "대한": "KOREAN_AIR",
+    "kal": "KOREAN_AIR",
+    "korean air": "KOREAN_AIR",
+    "스카이패스": "KOREAN_AIR",
+    
+    "아시아나": "ASIANA",
+    "oz": "ASIANA",
+    "asiana": "ASIANA",
+    
+    # 미국 항공
+    "delta": "DELTA_SKYMILES",
+    "델타": "DELTA_SKYMILES",
+    "skymiles": "DELTA_SKYMILES",
+    
+    "united": "UNITED_MILEAGEPLUS",
+    "유나이티드": "UNITED_MILEAGEPLUS",
+    "mileageplus": "UNITED_MILEAGEPLUS",
+    
+    "american": "AA_AADVANTAGE",
+    "aa": "AA_AADVANTAGE",
+    "아메리칸": "AA_AADVANTAGE",
+    "aadvantage": "AA_AADVANTAGE",
+    
+    # 신용카드 포인트
+    "amex": "AMEX_MR",
+    "아멕스": "AMEX_MR",
+    "mr": "AMEX_MR",
+    "membership rewards": "AMEX_MR",
+    
+    "chase": "CHASE_UR",
+    "체이스": "CHASE_UR",
+    "ur": "CHASE_UR",
+    "ultimate rewards": "CHASE_UR",
+    
+    "citi": "CITI_TYP",
+    "시티": "CITI_TYP",
+    "typ": "CITI_TYP",
+    "thankyou": "CITI_TYP",
+    
+    "capital one": "CAPITAL_ONE",
+    "캐피탈원": "CAPITAL_ONE",
+    
+    # 호텔 포인트
+    "marriott": "MARRIOTT_BONVOY",
+    "메리어트": "MARRIOTT_BONVOY",
+    "본보이": "MARRIOTT_BONVOY",
+    "bonvoy": "MARRIOTT_BONVOY",
+    
+    "hilton": "HILTON_HONORS",
+    "힐튼": "HILTON_HONORS",
+    "honors": "HILTON_HONORS",
+    
+    "ihg": "IHG_REWARDS",
+    
+    "hyatt": "HYATT_WOH",
+    "하얏트": "HYATT_WOH",
+    "woh": "HYATT_WOH",
+    "world of hyatt": "HYATT_WOH",
+}
+
+
+# =============================================================================
+# 파싱 함수
+# =============================================================================
+
+def parse_asset_text(text: str) -> List[Dict[str, Any]]:
+    """
+    텍스트에서 포인트/마일리지 정보를 추출합니다.
+    
+    Args:
+        text: 사용자 입력 텍스트
+        
+    Returns:
+        추출된 자산 목록 [{"program": "...", "amount": ...}, ...]
+    """
+    assets = []
+    
+    # 줄 단위 + 쉼표 단위로 분리
+    lines = re.split(r'[\n,]', text)
+    
+    for line in lines:
+        line = line.strip()
+        if not line:
+            continue
+        
+        result = _parse_single_line(line)
+        if result:
+            # 중복 제거 (같은 프로그램이면 합산)
+            existing = next(
+                (a for a in assets if a["program"] == result["program"]), 
+                None
+            )
+            if existing:
+                existing["amount"] += result["amount"]
+            else:
+                assets.append(result)
+    
+    return assets
+
+
+def _parse_single_line(line: str) -> Optional[Dict[str, Any]]:
+    """단일 라인에서 프로그램과 수량 추출."""
+    line_lower = line.lower()
+    
+    # 숫자 추출 (쉼표 제거)
+    numbers = re.findall(r'[\d,]+', line)
+    if not numbers:
+        return None
+    
+    # 가장 큰 숫자를 amount로 사용
+    amount = max(int(n.replace(',', '')) for n in numbers if n.replace(',', '').isdigit())
+    if amount == 0:
+        return None
+    
+    # 프로그램 식별
+    program = None
+    for alias, prog_id in PROGRAM_ALIASES.items():
+        if alias in line_lower:
+            program = prog_id
+            break
+    
+    if not program:
+        # 숫자만 있는 경우 - 문맥으로 추론 불가
+        return None
+    
+    return {"program": program, "amount": amount}
+
+
+def normalize_program_name(name: str) -> Optional[str]:
+    """프로그램 별칭을 정규화합니다."""
+    name_lower = name.lower().strip()
+    return PROGRAM_ALIASES.get(name_lower)
+
+
+# =============================================================================
+# MCP Tool 핸들러
+# =============================================================================
+
+async def handle_parse_asset_text(
+    arguments: Dict[str, Any],
+    user_id: str
+) -> Dict[str, Any]:
+    """
+    user_parse_asset_text Tool 핸들러.
+    
+    사용자 입력 텍스트에서 포인트/마일리지를 자동 추출합니다.
+    """
+    text = arguments.get("text", "")
+    save_to_profile = arguments.get("save_to_profile", False)
+    
+    if not text:
+        return {
+            "success": False,
+            "error": "파싱할 텍스트가 없습니다.",
+            "usage": "예: '대한항공 45000 마일, AMEX MR 50000점'"
+        }
+    
+    # 파싱
+    assets = parse_asset_text(text)
+    
+    if not assets:
+        return {
+            "success": False,
+            "error": "인식 가능한 포인트/마일리지 정보가 없습니다.",
+            "tip": "프로그램명과 숫자를 함께 입력해주세요. 예: '대한항공 45000'",
+            "supported_programs": list(POINT_VALUATIONS.keys())
+        }
+    
+    # 프로그램 이름 보강
+    for asset in assets:
+        prog_info = POINT_VALUATIONS.get(asset["program"], {})
+        asset["program_name"] = prog_info.get("name", asset["program"])
+        asset["currency"] = prog_info.get("currency", "USD")
+    
+    result = {
+        "success": True,
+        "parsed_assets": assets,
+        "count": len(assets),
+        "parsed_at": datetime.now().isoformat(),
+        "tip": "user_get_asset_valuation을 호출하여 총 가치를 계산할 수 있습니다."
+    }
+    
+    # 향후: save_to_profile이 True면 DB에 저장
+    if save_to_profile:
+        result["save_status"] = "not_implemented"
+        result["save_note"] = "자산 저장 기능은 향후 구현 예정"
+    
+    return result

src/auth/config.py

@@ -111,3 +111,131 @@ def validate_config():
         )
     
     logger.info("인증 설정 검증 완료")
+
+
+# =============================================================================
+# 포인트 가치 평가 (Shadow Valuation)
+# =============================================================================
+
+# 기본 포인트 가치 (CPP: Cents Per Point)
+# base: 일반 사용자, premium: 비즈니스/퍼스트 선호, cashback: 현금성 선호
+POINT_VALUATIONS = {
+    # 신용카드 포인트 (단위: cents per point)
+    "AMEX_MR": {
+        "name": "American Express Membership Rewards",
+        "currency": "USD",
+        "base": 2.0,
+        "premium": 2.2,
+        "cashback": 0.6,
+    },
+    "CHASE_UR": {
+        "name": "Chase Ultimate Rewards",
+        "currency": "USD",
+        "base": 2.0,
+        "premium": 2.05,
+        "cashback": 1.25,
+    },
+    "CITI_TYP": {
+        "name": "Citi ThankYou Points",
+        "currency": "USD",
+        "base": 1.8,
+        "premium": 1.9,
+        "cashback": 1.0,
+    },
+    "CAPITAL_ONE": {
+        "name": "Capital One Miles",
+        "currency": "USD",
+        "base": 1.85,
+        "premium": 1.9,
+        "cashback": 0.5,
+    },
+    
+    # 항공 마일리지 - 한국 (단위: 원/마일)
+    "KOREAN_AIR": {
+        "name": "대한항공 스카이패스",
+        "currency": "KRW",
+        "base": 18,
+        "domestic": 12,
+        "premium": 25,
+    },
+    "ASIANA": {
+        "name": "아시아나 스타얼라이언스",
+        "currency": "KRW", 
+        "base": 17,
+        "domestic": 11,
+        "premium": 24,
+    },
+    
+    # 항공 마일리지 - 미국 (단위: cents per mile)
+    "DELTA_SKYMILES": {
+        "name": "Delta SkyMiles",
+        "currency": "USD",
+        "base": 1.2,
+        "premium": 1.5,
+        "cashback": 1.0,
+    },
+    "UNITED_MILEAGEPLUS": {
+        "name": "United MileagePlus",
+        "currency": "USD",
+        "base": 1.3,
+        "premium": 1.6,
+        "cashback": 1.0,
+    },
+    "AA_AADVANTAGE": {
+        "name": "American Airlines AAdvantage",
+        "currency": "USD",
+        "base": 1.4,
+        "premium": 1.7,
+        "cashback": 0.8,
+    },
+    
+    # 호텔 포인트 (단위: cents per point)
+    "MARRIOTT_BONVOY": {
+        "name": "Marriott Bonvoy",
+        "currency": "USD",
+        "base": 0.8,
+        "premium": 1.0,
+        "cashback": 0.6,
+    },
+    "HILTON_HONORS": {
+        "name": "Hilton Honors",
+        "currency": "USD",
+        "base": 0.5,
+        "premium": 0.6,
+        "cashback": 0.4,
+    },
+    "IHG_REWARDS": {
+        "name": "IHG One Rewards",
+        "currency": "USD",
+        "base": 0.5,
+        "premium": 0.6,
+        "cashback": 0.5,
+    },
+    "HYATT_WOH": {
+        "name": "World of Hyatt",
+        "currency": "USD",
+        "base": 1.7,
+        "premium": 2.0,
+        "cashback": 1.5,
+    },
+}
+
+# 사용자 여행 스타일 프로필
+TRAVEL_STYLES = {
+    "PREMIUM": {
+        "description": "비즈니스/퍼스트클래스 선호",
+        "description_en": "Prefers Business/First Class",
+        "multiplier_key": "premium",
+    },
+    "VALUE": {
+        "description": "가성비 중시 (이코노미 + 호텔 업그레이드)",
+        "description_en": "Value-focused traveler",
+        "multiplier_key": "base",
+    },
+    "CASHBACK": {
+        "description": "현금성 사용 선호 (Statement Credit, 기프트카드)",
+        "description_en": "Prefers cash-equivalent redemptions",
+        "multiplier_key": "cashback",
+    },
+}
+

src/auth/credit_card_handlers.py

@@ -0,0 +1,684 @@
+"""
+Credit Card Tool Handlers
+=========================
+
+user_* 신용카드 관련 MCP Tool의 실제 실행 로직.
+"""
+
+import logging
+from typing import Dict, Any, List, Optional
+from datetime import datetime, date
+
+from .config import SERVER_BASE_URL
+
+logger = logging.getLogger("eodi.auth.credit_card_handlers")
+
+
+# =============================================================================
+# 지원 카드 정보
+# =============================================================================
+
+# 지원하는 카드 발급사 및 카드 ID 체계
+SUPPORTED_ISSUERS = {
+    "AMEX": {
+        "name": "American Express",
+        "cards": {
+            "AMEX_PLATINUM_US": "Platinum Card",
+            "AMEX_GOLD_US": "Gold Card",
+            "AMEX_GREEN_US": "Green Card",
+            "AMEX_MARRIOTT_BONVOY_US": "Marriott Bonvoy Card",
+            "AMEX_HILTON_HONORS_US": "Hilton Honors Card",
+            "AMEX_HILTON_SURPASS_US": "Hilton Honors Surpass Card",
+            "AMEX_HILTON_ASPIRE_US": "Hilton Honors Aspire Card",
+            "AMEX_DELTA_SKYMILES_GOLD_US": "Delta SkyMiles Gold Card",
+            "AMEX_DELTA_SKYMILES_PLATINUM_US": "Delta SkyMiles Platinum Card",
+            "AMEX_DELTA_SKYMILES_RESERVE_US": "Delta SkyMiles Reserve Card",
+        }
+    },
+    "CHASE": {
+        "name": "Chase",
+        "cards": {
+            "CHASE_SAPPHIRE_PREFERRED": "Sapphire Preferred",
+            "CHASE_SAPPHIRE_RESERVE": "Sapphire Reserve",
+            "CHASE_FREEDOM_UNLIMITED": "Freedom Unlimited",
+            "CHASE_FREEDOM_FLEX": "Freedom Flex",
+            "CHASE_UNITED_EXPLORER": "United Explorer",
+            "CHASE_UNITED_QUEST": "United Quest",
+            "CHASE_UNITED_CLUB": "United Club Infinite",
+            "CHASE_MARRIOTT_BOUNDLESS": "Marriott Bonvoy Boundless",
+            "CHASE_IHG_ONE_PREMIER": "IHG One Rewards Premier",
+            "CHASE_HYATT": "World of Hyatt",
+        }
+    },
+    "CITI": {
+        "name": "Citi",
+        "cards": {
+            "CITI_STRATA_PREMIER": "Strata Premier",
+            "CITI_DOUBLE_CASH": "Double Cash",
+            "CITI_CUSTOM_CASH": "Custom Cash",
+            "CITI_AA_EXECUTIVE": "AAdvantage Executive",
+            "CITI_AA_PLATINUM": "AAdvantage Platinum Select",
+        }
+    },
+    "CAPITAL_ONE": {
+        "name": "Capital One",
+        "cards": {
+            "CAPITAL_ONE_VENTURE_X": "Venture X",
+            "CAPITAL_ONE_VENTURE": "Venture",
+            "CAPITAL_ONE_SAVOR_ONE": "SavorOne",
+        }
+    },
+}
+
+# 카드별 혜택 추적 가능한 크레딧 정의 (KB 데이터와 연동)
+TRACKABLE_BENEFITS = {
+    "AMEX_PLATINUM_US": {
+        "amex_plat_hotel_credit": {
+            "name": "FHR/THC Hotel Credit",
+            "period_type": "semi-annually",  # monthly, quarterly, semi-annually, yearly
+            "amount_per_period": 300,
+            "currency": "USD",
+            "periods": ["H1", "H2"],  # H1=1-6월, H2=7-12월
+        },
+        "amex_plat_saks_credit": {
+            "name": "Saks Fifth Avenue Credit",
+            "period_type": "semi-annually",
+            "amount_per_period": 50,
+            "currency": "USD",
+            "periods": ["H1", "H2"],
+        },
+        "amex_plat_uber_cash": {
+            "name": "Uber Cash",
+            "period_type": "monthly",
+            "amount_per_period": 15,
+            "currency": "USD",
+            "december_bonus": 20,
+        },
+        "amex_plat_digital_entertainment": {
+            "name": "Digital Entertainment Credit",
+            "period_type": "monthly",
+            "amount_per_period": 25,
+            "currency": "USD",
+        },
+        "amex_plat_resy_credit": {
+            "name": "Resy Credit",
+            "period_type": "quarterly",
+            "amount_per_period": 100,
+            "currency": "USD",
+            "periods": ["Q1", "Q2", "Q3", "Q4"],
+        },
+        "amex_plat_lululemon_credit": {
+            "name": "lululemon Credit",
+            "period_type": "quarterly",
+            "amount_per_period": 75,
+            "currency": "USD",
+            "periods": ["Q1", "Q2", "Q3", "Q4"],
+        },
+        "amex_plat_airline_fee_credit": {
+            "name": "Airline Fee Credit",
+            "period_type": "yearly",
+            "amount_per_period": 200,
+            "currency": "USD",
+        },
+        "amex_plat_equinox_credit": {
+            "name": "Equinox Credit",
+            "period_type": "yearly",
+            "amount_per_period": 300,
+            "currency": "USD",
+        },
+        "amex_plat_clear_credit": {
+            "name": "CLEAR Plus Credit",
+            "period_type": "yearly",
+            "amount_per_period": 209,
+            "currency": "USD",
+        },
+        "amex_plat_walmart_credit": {
+            "name": "Walmart+ Credit",
+            "period_type": "monthly",
+            "amount_per_period": 12.95,
+            "currency": "USD",
+        },
+    },
+    "CHASE_SAPPHIRE_RESERVE": {
+        "chase_sr_travel_credit": {
+            "name": "Travel Credit",
+            "period_type": "yearly",
+            "amount_per_period": 300,
+            "currency": "USD",
+        },
+        "chase_sr_doordash": {
+            "name": "DoorDash DashPass",
+            "period_type": "yearly",
+            "amount_per_period": 0,  # Free membership
+            "currency": "USD",
+        },
+    },
+}
+
+
+# =============================================================================
+# 유틸리티 함수
+# =============================================================================
+
+def get_current_period_ids(period_type: str, ref_date: date = None) -> List[str]:
+    """
+    현재 날짜 기준 기간 ID 반환.
+    
+    Args:
+        period_type: monthly, quarterly, semi-annually, yearly
+        ref_date: 기준 날짜 (기본: 오늘)
+        
+    Returns:
+        기간 ID 리스트 (예: ["2026-H1"], ["2026-Q1"], ["2026-01"])
+    """
+    if ref_date is None:
+        ref_date = date.today()
+    
+    year = ref_date.year
+    month = ref_date.month
+    
+    if period_type == "monthly":
+        return [f"{year}-{month:02d}"]
+    elif period_type == "quarterly":
+        quarter = (month - 1) // 3 + 1
+        return [f"{year}-Q{quarter}"]
+    elif period_type == "semi-annually":
+        half = "H1" if month <= 6 else "H2"
+        return [f"{year}-{half}"]
+    elif period_type == "yearly":
+        return [f"{year}"]
+    else:
+        return [f"{year}"]
+
+
+def get_period_deadline(period_type: str, period_id: str) -> Optional[date]:
+    """
+    기간 ID의 마감일 반환.
+    
+    Args:
+        period_type: 기간 유형
+        period_id: 기간 ID (예: "2026-H1")
+        
+    Returns:
+        마감일
+    """
+    try:
+        year = int(period_id.split("-")[0])
+        
+        if period_type == "monthly":
+            month = int(period_id.split("-")[1])
+            if month == 12:
+                return date(year + 1, 1, 1)
+            else:
+                return date(year, month + 1, 1)
+        elif period_type == "quarterly":
+            quarter = period_id.split("-")[1]
+            if quarter == "Q1":
+                return date(year, 4, 1)
+            elif quarter == "Q2":
+                return date(year, 7, 1)
+            elif quarter == "Q3":
+                return date(year, 10, 1)
+            else:
+                return date(year + 1, 1, 1)
+        elif period_type == "semi-annually":
+            half = period_id.split("-")[1]
+            if half == "H1":
+                return date(year, 7, 1)
+            else:
+                return date(year + 1, 1, 1)
+        elif period_type == "yearly":
+            return date(year + 1, 1, 1)
+    except Exception as e:
+        logger.error(f"기간 마감일 계산 오류: {e}")
+        return None
+
+
+def days_until_deadline(period_type: str, period_id: str, ref_date: date = None) -> int:
+    """
+    마감일까지 남은 일수 계산.
+    """
+    if ref_date is None:
+        ref_date = date.today()
+    
+    deadline = get_period_deadline(period_type, period_id)
+    if deadline:
+        return (deadline - ref_date).days
+    return 999  # 알 수 없음
+
+
+# =============================================================================
+# Tool 핸들러
+# =============================================================================
+
+async def handle_add_credit_card(arguments: Dict[str, Any], user_id: str) -> Dict[str, Any]:
+    """
+    user_add_credit_card Tool 핸들러.
+    
+    사용자 신용카드 등록.
+    """
+    card_id = arguments.get("card_id", "").upper()
+    card_name = arguments.get("card_name", "")
+    issuer_code = arguments.get("issuer_code", "").upper()
+    region = arguments.get("region", "USA").upper()
+    card_open_date = arguments.get("card_open_date")  # YYYY-MM-DD
+    anniversary_month = arguments.get("anniversary_month")
+    annual_fee = arguments.get("annual_fee")
+    
+    # 필수값 검증
+    if not card_id:
+        return {
+            "success": False,
+            "error": "card_id가 필요합니다.",
+            "supported_issuers": list(SUPPORTED_ISSUERS.keys()),
+            "example_cards": {
+                issuer: list(data["cards"].keys())[:3]
+                for issuer, data in SUPPORTED_ISSUERS.items()
+            }
+        }
+    
+    # 발급사 검증 (card_id에서 추출 가능)
+    if not issuer_code:
+        for issuer, data in SUPPORTED_ISSUERS.items():
+            if card_id in data["cards"]:
+                issuer_code = issuer
+                card_name = card_name or data["cards"][card_id]
+                break
+    
+    if not issuer_code:
+        issuer_code = card_id.split("_")[0] if "_" in card_id else "OTHER"
+    
+    if not card_name:
+        card_name = card_id.replace("_", " ").title()
+    
+    try:
+        from src.db.supabase_adapter import SupabaseAdapter
+        adapter = SupabaseAdapter()
+        
+        result = adapter.upsert_credit_card(
+            user_id=user_id,
+            card_id=card_id,
+            card_name=card_name,
+            issuer_code=issuer_code,
+            region=region,
+            card_open_date=card_open_date,
+            anniversary_month=anniversary_month,
+            annual_fee=annual_fee
+        )
+        
+        if result:
+            # 추적 가능한 혜택 정보 포함
+            trackable = TRACKABLE_BENEFITS.get(card_id, {})
+            
+            return {
+                "success": True,
+                "card": {
+                    "card_id": card_id,
+                    "card_name": card_name,
+                    "issuer_code": issuer_code,
+                    "region": region,
+                },
+                "trackable_benefits": list(trackable.keys()) if trackable else [],
+                "message": f"✅ {card_name} 카드가 등록되었습니다." + 
+                    (f"\n\n💡 추적 가능한 혜택: {len(trackable)}개" if trackable else "")
+            }
+        else:
+            return {
+                "success": False,
+                "error": "카드 등록에 실패했습니다."
+            }
+    except Exception as e:
+        logger.error(f"카드 등록 오류: {e}")
+        return {
+            "success": False,
+            "error": f"카드 등록 중 오류가 발생했습니다: {e}"
+        }
+
+
+async def handle_get_credit_cards(arguments: Dict[str, Any], user_id: str) -> Dict[str, Any]:
+    """
+    user_get_credit_cards Tool 핸들러.
+    
+    사용자 보유 카드 목록 조회.
+    """
+    try:
+        from src.db.supabase_adapter import SupabaseAdapter
+        adapter = SupabaseAdapter()
+        
+        cards = adapter.get_user_credit_cards(user_id)
+        
+        return {
+            "success": True,
+            "cards": [
+                {
+                    "card_id": card["card_id"],
+                    "card_name": card["card_name"],
+                    "issuer_code": card["issuer_code"],
+                    "region": card.get("region", "USA"),
+                    "is_active": card.get("is_active", True),
+                    "anniversary_month": card.get("anniversary_month"),
+                }
+                for card in cards
+            ],
+            "count": len(cards)
+        }
+    except Exception as e:
+        logger.error(f"카드 목록 조회 오류: {e}")
+        return {
+            "success": False,
+            "error": f"카드 목록 조회 중 오류가 발생했습니다: {e}"
+        }
+
+
+async def handle_delete_credit_card(arguments: Dict[str, Any], user_id: str) -> Dict[str, Any]:
+    """
+    user_delete_credit_card Tool 핸들러.
+    """
+    card_id = arguments.get("card_id", "").upper()
+    
+    if not card_id:
+        return {
+            "success": False,
+            "error": "card_id가 필요합니다."
+        }
+    
+    try:
+        from src.db.supabase_adapter import SupabaseAdapter
+        adapter = SupabaseAdapter()
+        
+        if adapter.delete_credit_card(user_id, card_id):
+            return {
+                "success": True,
+                "message": f"✅ {card_id} 카드가 삭제되었습니다."
+            }
+        else:
+            return {
+                "success": False,
+                "error": "카드 삭제에 실패했습니다."
+            }
+    except Exception as e:
+        logger.error(f"카드 삭제 오류: {e}")
+        return {
+            "success": False,
+            "error": f"카드 삭제 중 오류가 발생했습니다: {e}"
+        }
+
+
+async def handle_update_credit_usage(arguments: Dict[str, Any], user_id: str) -> Dict[str, Any]:
+    """
+    user_update_credit_usage Tool 핸들러.
+    
+    크레딧/혜택 사용 기록 업데이트.
+    """
+    card_id = arguments.get("card_id", "").upper()
+    benefit_id = arguments.get("benefit_id", "").lower()
+    amount_used = arguments.get("amount_used")
+    usage_date = arguments.get("usage_date")  # YYYY-MM-DD
+    description = arguments.get("description", "")
+    
+    if not card_id or not benefit_id:
+        return {
+            "success": False,
+            "error": "card_id와 benefit_id가 필요합니다.",
+            "available_benefits": list(TRACKABLE_BENEFITS.get(card_id, {}).keys())
+        }
+    
+    # 혜택 정보 조회
+    card_benefits = TRACKABLE_BENEFITS.get(card_id, {})
+    benefit_info = card_benefits.get(benefit_id)
+    
+    if not benefit_info:
+        return {
+            "success": False,
+            "error": f"추적 가능한 혜택이 아닙니다: {benefit_id}",
+            "available_benefits": list(card_benefits.keys())
+        }
+    
+    # 현재 기간 계산
+    ref_date = date.fromisoformat(usage_date) if usage_date else date.today()
+    period_ids = get_current_period_ids(benefit_info["period_type"], ref_date)
+    period_id = period_ids[0] if period_ids else f"{ref_date.year}"
+    
+    # 사용 금액 기본값: 기간당 한도 전체
+    if amount_used is None:
+        amount_used = benefit_info["amount_per_period"]
+    
+    try:
+        from src.db.supabase_adapter import SupabaseAdapter
+        adapter = SupabaseAdapter()
+        
+        result = adapter.upsert_credit_usage(
+            user_id=user_id,
+            card_id=card_id,
+            benefit_id=benefit_id,
+            usage_period=period_id,
+            amount_used=float(amount_used),
+            amount_limit=benefit_info["amount_per_period"],
+            currency=benefit_info["currency"],
+            usage_date=usage_date or ref_date.isoformat(),
+            description=description
+        )
+        
+        if result:
+            return {
+                "success": True,
+                "usage": {
+                    "card_id": card_id,
+                    "benefit_id": benefit_id,
+                    "benefit_name": benefit_info["name"],
+                    "period": period_id,
+                    "amount_used": amount_used,
+                    "amount_limit": benefit_info["amount_per_period"],
+                    "currency": benefit_info["currency"],
+                },
+                "message": f"✅ {benefit_info['name']} 사용 기록이 저장되었습니다.\n"
+                          f"   {period_id}: ${amount_used}/${benefit_info['amount_per_period']}"
+            }
+        else:
+            return {
+                "success": False,
+                "error": "사용 기록 저장에 실패했습니다."
+            }
+    except Exception as e:
+        logger.error(f"사용 기록 저장 오류: {e}")
+        return {
+            "success": False,
+            "error": f"사용 기록 저장 중 오류가 발생했습니다: {e}"
+        }
+
+
+async def handle_get_credit_recommendations(
+    arguments: Dict[str, Any], 
+    user_id: str
+) -> Dict[str, Any]:
+    """
+    user_get_credit_recommendations Tool 핸들러.
+    
+    현재 시점에서 사용해야 할 크레딧/혜택 추천.
+    """
+    try:
+        from src.db.supabase_adapter import SupabaseAdapter
+        adapter = SupabaseAdapter()
+        
+        # 1. 사용자 보유 카드 조회
+        cards = adapter.get_user_credit_cards(user_id)
+        
+        if not cards:
+            return {
+                "success": True,
+                "recommendations": [],
+                "message": "등록된 신용카드가 없습니다. user_add_credit_card로 카드를 먼저 등록해주세요."
+            }
+        
+        # 2. 사용 기록 조회
+        usage_records = adapter.get_user_credit_usage(user_id)
+        usage_map = {
+            (u["card_id"], u["benefit_id"], u["usage_period"]): u
+            for u in usage_records
+        }
+        
+        # 3. 현재 날짜 기준 추천 생성
+        today = date.today()
+        recommendations = []
+        
+        for card in cards:
+            card_id = card["card_id"]
+            card_benefits = TRACKABLE_BENEFITS.get(card_id, {})
+            
+            for benefit_id, benefit_info in card_benefits.items():
+                period_type = benefit_info["period_type"]
+                period_ids = get_current_period_ids(period_type, today)
+                
+                for period_id in period_ids:
+                    # 이미 사용한 기록 확인
+                    usage_key = (card_id, benefit_id, period_id)
+                    usage = usage_map.get(usage_key)
+                    
+                    amount_used = usage["amount_used"] if usage else 0
+                    amount_limit = benefit_info["amount_per_period"]
+                    remaining = amount_limit - amount_used
+                    days_left = days_until_deadline(period_type, period_id, today)
+                    
+                    if remaining > 0:
+                        # 긴급도 계산
+                        if days_left <= 7:
+                            urgency = "🔴 긴급"
+                            priority = 1
+                        elif days_left <= 30:
+                            urgency = "🟡 주의"
+                            priority = 2
+                        else:
+                            urgency = "🟢 여유"
+                            priority = 3
+                        
+                        recommendations.append({
+                            "card_id": card_id,
+                            "card_name": card["card_name"],
+                            "benefit_id": benefit_id,
+                            "benefit_name": benefit_info["name"],
+                            "period": period_id,
+                            "period_type": period_type,
+                            "amount_remaining": remaining,
+                            "amount_limit": amount_limit,
+                            "currency": benefit_info["currency"],
+                            "days_until_expiry": days_left,
+                            "urgency": urgency,
+                            "priority": priority,
+                        })
+        
+        # 우선순위 정렬 (긴급도 → 금액)
+        recommendations.sort(key=lambda x: (x["priority"], -x["amount_remaining"]))
+        
+        # 상위 10개만 반환
+        top_recommendations = recommendations[:10]
+        
+        # 메시지 생성
+        if top_recommendations:
+            urgent_count = sum(1 for r in top_recommendations if r["priority"] == 1)
+            message_parts = [f"📋 추천 {len(top_recommendations)}개"]
+            if urgent_count:
+                message_parts.append(f"(긴급 {urgent_count}개!)")
+            message = " ".join(message_parts)
+        else:
+            message = "✅ 현재 사용해야 할 크레딧이 없습니다."
+        
+        return {
+            "success": True,
+            "recommendations": top_recommendations,
+            "total_count": len(recommendations),
+            "message": message,
+            "current_date": today.isoformat()
+        }
+        
+    except Exception as e:
+        logger.error(f"추천 생성 오류: {e}")
+        return {
+            "success": False,
+            "error": f"추천 생성 중 오류가 발생했습니다: {e}"
+        }
+
+
+async def handle_get_credit_usage_summary(
+    arguments: Dict[str, Any], 
+    user_id: str
+) -> Dict[str, Any]:
+    """
+    user_get_credit_usage_summary Tool 핸들러.
+    
+    특정 카드의 크레딧 사용 현황 요약.
+    """
+    card_id = arguments.get("card_id", "").upper()
+    
+    try:
+        from src.db.supabase_adapter import SupabaseAdapter
+        adapter = SupabaseAdapter()
+        
+        # 사용자 보유 카드 확인
+        cards = adapter.get_user_credit_cards(user_id)
+        user_card_ids = [c["card_id"] for c in cards]
+        
+        if card_id and card_id not in user_card_ids:
+            return {
+                "success": False,
+                "error": f"등록되지 않은 카드입니다: {card_id}",
+                "registered_cards": user_card_ids
+            }
+        
+        # 사용 기록 조회
+        usage_records = adapter.get_user_credit_usage(user_id, card_id=card_id if card_id else None)
+        
+        # 카드별로 그룹화
+        today = date.today()
+        summary = {}
+        
+        for card in cards:
+            cid = card["card_id"]
+            if card_id and cid != card_id:
+                continue
+                
+            card_benefits = TRACKABLE_BENEFITS.get(cid, {})
+            card_usage = [u for u in usage_records if u["card_id"] == cid]
+            
+            benefits_summary = []
+            for benefit_id, benefit_info in card_benefits.items():
+                period_type = benefit_info["period_type"]
+                period_ids = get_current_period_ids(period_type, today)
+                period_id = period_ids[0] if period_ids else f"{today.year}"
+                
+                # 해당 기간 사용량
+                usage = next(
+                    (u for u in card_usage 
+                     if u["benefit_id"] == benefit_id and u["usage_period"] == period_id),
+                    None
+                )
+                
+                amount_used = usage["amount_used"] if usage else 0
+                amount_limit = benefit_info["amount_per_period"]
+                
+                benefits_summary.append({
+                    "benefit_id": benefit_id,
+                    "benefit_name": benefit_info["name"],
+                    "current_period": period_id,
+                    "amount_used": amount_used,
+                    "amount_limit": amount_limit,
+                    "percent_used": round(amount_used / amount_limit * 100, 1) if amount_limit else 0,
+                    "currency": benefit_info["currency"],
+                })
+            
+            summary[cid] = {
+                "card_name": card["card_name"],
+                "benefits": benefits_summary,
+            }
+        
+        return {
+            "success": True,
+            "summary": summary,
+            "current_date": today.isoformat()
+        }
+        
+    except Exception as e:
+        logger.error(f"사용 현황 요약 조회 오류: {e}")
+        return {
+            "success": False,
+            "error": f"사용 현황 조회 중 오류가 발생했습니다: {e}"
+        }

src/auth/tool_handlers.py

@@ -27,6 +27,7 @@ async def execute_user_tool(name: str, arguments: Dict[str, Any]) -> Dict[str, A
     Returns:
         Tool 실행 결과
     """
+    # 기존 인증/멤버십 관련 Tool
     if name == "user_get_profile":
         return await handle_get_profile(arguments)
     elif name == "user_update_membership":
@@ -37,10 +38,137 @@ async def execute_user_tool(name: str, arguments: Dict[str, Any]) -> Dict[str, A
         return await handle_request_auth(arguments)
     elif name == "user_verify_code":
         return await handle_verify_code(arguments)
+    
+    # 신용카드 관련 Tool (인증 필요)
+    elif name in [
+        "user_add_credit_card",
+        "user_get_credit_cards", 
+        "user_delete_credit_card",
+        "user_update_credit_usage",
+        "user_get_credit_recommendations",
+        "user_get_credit_usage_summary"
+    ]:
+        return await _handle_credit_card_tool(name, arguments)
+    
+    # 가치 평가 관련 Tool (인증 필요)
+    elif name in [
+        "user_get_asset_valuation",
+        "user_update_valuation_style",
+        "user_get_valuation_styles",
+        "user_parse_asset_text",
+        "calculate_miles_vs_cashback",
+        "generate_award_search_link"
+    ]:
+        return await _handle_valuation_tool(name, arguments)
+    
     else:
         return {"success": False, "error": f"Unknown user tool: {name}"}
 
 
+async def _handle_credit_card_tool(name: str, arguments: Dict[str, Any]) -> Dict[str, Any]:
+    """
+    신용카드 관련 Tool을 위한 공통 래퍼.
+    세션 검증 후 해당 핸들러 호출.
+    """
+    from .credit_card_handlers import (
+        handle_add_credit_card,
+        handle_get_credit_cards,
+        handle_delete_credit_card,
+        handle_update_credit_usage,
+        handle_get_credit_recommendations,
+        handle_get_credit_usage_summary
+    )
+    
+    session_token = arguments.get("session_token")
+    user_session_manager = get_user_session_manager()
+    
+    # 인증 확인
+    if not session_token:
+        return {
+            "success": False,
+            "error": "session_token이 필요합니다. 먼저 user_get_profile을 호출하여 인증 상태를 확인하세요.",
+            "auth_url": f"{SERVER_BASE_URL}/auth/login"
+        }
+    
+    session = user_session_manager.get_session(session_token)
+    if not session:
+        return {
+            "success": False,
+            "error": "세션이 만료되었습니다. 다시 로그인해주세요.",
+            "auth_url": f"{SERVER_BASE_URL}/auth/login"
+        }
+    
+    user_id = session.user_id
+    
+    # 각 핸들러 호출
+    if name == "user_add_credit_card":
+        return await handle_add_credit_card(arguments, user_id)
+    elif name == "user_get_credit_cards":
+        return await handle_get_credit_cards(arguments, user_id)
+    elif name == "user_delete_credit_card":
+        return await handle_delete_credit_card(arguments, user_id)
+    elif name == "user_update_credit_usage":
+        return await handle_update_credit_usage(arguments, user_id)
+    elif name == "user_get_credit_recommendations":
+        return await handle_get_credit_recommendations(arguments, user_id)
+    elif name == "user_get_credit_usage_summary":
+        return await handle_get_credit_usage_summary(arguments, user_id)
+    else:
+        return {"success": False, "error": f"Unknown credit card tool: {name}"}
+
+
+async def _handle_valuation_tool(name: str, arguments: Dict[str, Any]) -> Dict[str, Any]:
+    """
+    가치 평가 관련 Tool을 위한 공통 래퍼.
+    세션 검증 후 해당 핸들러 호출.
+    """
+    from .valuation_handlers import (
+        handle_get_asset_valuation,
+        handle_update_valuation_style,
+        handle_get_valuation_styles,
+        handle_calculate_miles_vs_cashback,
+        handle_generate_award_search_link
+    )
+    from .asset_parser import handle_parse_asset_text
+    
+    session_token = arguments.get("session_token")
+    user_session_manager = get_user_session_manager()
+    
+    # 인증 확인
+    if not session_token:
+        return {
+            "success": False,
+            "error": "session_token이 필요합니다. 먼저 user_get_profile을 호출하여 인증 상태를 확인하세요.",
+            "auth_url": f"{SERVER_BASE_URL}/auth/login"
+        }
+    
+    session = user_session_manager.get_session(session_token)
+    if not session:
+        return {
+            "success": False,
+            "error": "세션이 만료되었습니다. 다시 로그인해주세요.",
+            "auth_url": f"{SERVER_BASE_URL}/auth/login"
+        }
+    
+    user_id = session.user_id
+    
+    # 각 핸들러 호출
+    if name == "user_get_asset_valuation":
+        return await handle_get_asset_valuation(arguments, user_id)
+    elif name == "user_update_valuation_style":
+        return await handle_update_valuation_style(arguments, user_id)
+    elif name == "user_get_valuation_styles":
+        return await handle_get_valuation_styles(arguments, user_id)
+    elif name == "user_parse_asset_text":
+        return await handle_parse_asset_text(arguments, user_id)
+    elif name == "calculate_miles_vs_cashback":
+        return await handle_calculate_miles_vs_cashback(arguments, user_id)
+    elif name == "generate_award_search_link":
+        return await handle_generate_award_search_link(arguments, user_id)
+    else:
+        return {"success": False, "error": f"Unknown valuation tool: {name}"}
+
+
 async def handle_get_profile(arguments: Dict[str, Any]) -> Dict[str, Any]:
     """
     user_get_profile Tool 핸들러.

src/auth/valuation_handlers.py

@@ -0,0 +1,530 @@
+"""
+Shadow Valuation Handlers
+=========================
+
+포인트/마일리지 가치 평가를 위한 MCP Tool 핸들러.
+
+사용자의 여행 스타일에 따라 동일한 포인트도 다른 가치로 평가됩니다:
+- PREMIUM: 비즈니스/퍼스트 발권 목표 → 높은 가치
+- VALUE: 일반 사용 → 표준 가치
+- CASHBACK: 현금성 사용 → 낮은 가치
+"""
+
+from typing import Dict, Any, List, Optional
+from datetime import datetime
+
+from .config import POINT_VALUATIONS, TRAVEL_STYLES
+
+# =============================================================================
+# 유틸리티 함수
+# =============================================================================
+
+def calculate_point_value(
+    program: str,
+    amount: float,
+    style: str = "VALUE",
+    custom_valuation: Optional[float] = None
+) -> Dict[str, Any]:
+    """
+    단일 포인트 프로그램의 가치를 계산합니다.
+    
+    Args:
+        program: 프로그램 ID (예: AMEX_MR, KOREAN_AIR)
+        amount: 포인트/마일 수량
+        style: 여행 스타일 (PREMIUM, VALUE, CASHBACK)
+        custom_valuation: 사용자 정의 가치 (있으면 우선 적용)
+        
+    Returns:
+        계산된 가치 정보
+    """
+    if program not in POINT_VALUATIONS:
+        return {
+            "success": False,
+            "error": f"지원하지 않는 프로그램: {program}",
+            "supported_programs": list(POINT_VALUATIONS.keys())
+        }
+    
+    prog_info = POINT_VALUATIONS[program]
+    currency = prog_info.get("currency", "USD")
+    
+    # 가치 결정: 사용자 정의 > 스타일 기반 > base
+    if custom_valuation is not None:
+        cpp = custom_valuation
+        source = "custom"
+    else:
+        style_info = TRAVEL_STYLES.get(style, TRAVEL_STYLES["VALUE"])
+        multiplier_key = style_info.get("multiplier_key", "base")
+        cpp = prog_info.get(multiplier_key, prog_info.get("base", 1.0))
+        source = f"style:{style}"
+    
+    # 가치 계산
+    if currency == "USD":
+        # CPP (cents per point) → 달러 변환
+        value_usd = (amount * cpp) / 100
+        return {
+            "success": True,
+            "program": program,
+            "program_name": prog_info.get("name", program),
+            "amount": amount,
+            "cpp": cpp,
+            "value": round(value_usd, 2),
+            "currency": "USD",
+            "source": source,
+        }
+    elif currency == "KRW":
+        # 원/마일 → 그대로
+        value_krw = amount * cpp
+        return {
+            "success": True,
+            "program": program,
+            "program_name": prog_info.get("name", program),
+            "amount": amount,
+            "value_per_unit": cpp,
+            "value": round(value_krw, 0),
+            "currency": "KRW",
+            "source": source,
+        }
+    else:
+        return {
+            "success": False,
+            "error": f"지원하지 않는 통화: {currency}"
+        }
+
+
+def calculate_total_value(
+    assets: List[Dict[str, Any]],
+    style: str = "VALUE",
+    custom_valuations: Optional[Dict[str, float]] = None
+) -> Dict[str, Any]:
+    """
+    복수 자산의 총 가치를 계산합니다.
+    
+    Args:
+        assets: [{"program": "AMEX_MR", "amount": 50000}, ...]
+        style: 여행 스타일
+        custom_valuations: 프로그램별 사용자 정의 가치
+        
+    Returns:
+        총 가치 및 개별 상세
+    """
+    if not assets:
+        return {
+            "success": True,
+            "total_usd": 0,
+            "total_krw": 0,
+            "breakdown": [],
+            "message": "평가할 자산이 없습니다."
+        }
+    
+    custom_valuations = custom_valuations or {}
+    breakdown = []
+    total_usd = 0
+    total_krw = 0
+    
+    for asset in assets:
+        program = asset.get("program", "").upper()
+        amount = asset.get("amount", 0)
+        
+        if not program or amount <= 0:
+            continue
+        
+        custom_val = custom_valuations.get(program)
+        result = calculate_point_value(program, amount, style, custom_val)
+        
+        if result.get("success"):
+            breakdown.append(result)
+            if result.get("currency") == "USD":
+                total_usd += result.get("value", 0)
+            elif result.get("currency") == "KRW":
+                total_krw += result.get("value", 0)
+    
+    return {
+        "success": True,
+        "style": style,
+        "style_description": TRAVEL_STYLES.get(style, {}).get("description", ""),
+        "total_usd": round(total_usd, 2),
+        "total_krw": round(total_krw, 0),
+        "breakdown": breakdown,
+        "evaluated_at": datetime.now().isoformat(),
+    }
+
+
+# =============================================================================
+# MCP Tool 핸들러
+# =============================================================================
+
+async def handle_get_asset_valuation(
+    arguments: Dict[str, Any],
+    user_id: str
+) -> Dict[str, Any]:
+    """
+    user_get_asset_valuation Tool 핸들러.
+    
+    사용자의 포인트/마일리지 자산 총 가치를 계산합니다.
+    """
+    from src.db import SupabaseAdapter
+    
+    adapter = SupabaseAdapter()
+    
+    # 1. 사용자 설정 조회
+    prefs = adapter.get_valuation_preferences(user_id)
+    style = prefs.get("travel_style", "VALUE") if prefs else "VALUE"
+    custom_valuations = prefs.get("custom_valuations", {}) if prefs else {}
+    
+    # 2. 입력 자산 파싱
+    # 방법 A: 직접 입력
+    assets = arguments.get("assets", [])
+    
+    # 방법 B: DB에서 조회 (향후 user_mileage_assets 테이블)
+    if not assets and arguments.get("from_db", False):
+        # 아직 구현되지 않음
+        return {
+            "success": False,
+            "error": "DB 자산 조회 기능은 아직 구현되지 않았습니다. assets 파라미터를 직접 입력해주세요.",
+            "example": {
+                "assets": [
+                    {"program": "AMEX_MR", "amount": 50000},
+                    {"program": "KOREAN_AIR", "amount": 45000}
+                ]
+            }
+        }
+    
+    if not assets:
+        return {
+            "success": False,
+            "error": "평가할 자산이 없습니다.",
+            "usage": "assets 파라미터에 [{\"program\": \"AMEX_MR\", \"amount\": 50000}] 형식으로 입력하세요.",
+            "supported_programs": list(POINT_VALUATIONS.keys())
+        }
+    
+    # 3. 스타일 오버라이드 (인자로 전달된 경우)
+    if "style" in arguments:
+        style = arguments["style"].upper()
+        if style not in TRAVEL_STYLES:
+            return {
+                "success": False,
+                "error": f"지원하지 않는 스타일: {style}",
+                "valid_styles": list(TRAVEL_STYLES.keys())
+            }
+    
+    # 4. 가치 계산
+    result = calculate_total_value(assets, style, custom_valuations)
+    
+    # 5. 응답 보강
+    result["user_style"] = style
+    result["tip"] = (
+        "여행 스타일에 따라 같은 포인트도 다르게 평가됩니다. "
+        "user_update_valuation_style로 스타일을 변경할 수 있습니다."
+    )
+    
+    return result
+
+
+async def handle_update_valuation_style(
+    arguments: Dict[str, Any],
+    user_id: str
+) -> Dict[str, Any]:
+    """
+    user_update_valuation_style Tool 핸들러.
+    
+    사용자의 여행 스타일 설정을 변경합니다.
+    """
+    from src.db import SupabaseAdapter
+    
+    style = arguments.get("style", "").upper()
+    custom_valuations = arguments.get("custom_valuations")
+    
+    # 유효성 검사
+    if style and style not in TRAVEL_STYLES:
+        return {
+            "success": False,
+            "error": f"유효하지 않은 스타일: {style}",
+            "valid_styles": {
+                k: v.get("description") for k, v in TRAVEL_STYLES.items()
+            }
+        }
+    
+    adapter = SupabaseAdapter()
+    
+    # 현재 설정 조회
+    current_prefs = adapter.get_valuation_preferences(user_id)
+    
+    # 업데이트할 데이터 구성
+    new_style = style if style else (current_prefs.get("travel_style", "VALUE") if current_prefs else "VALUE")
+    new_custom = custom_valuations if custom_valuations is not None else (
+        current_prefs.get("custom_valuations", {}) if current_prefs else {}
+    )
+    
+    # 저장
+    result = adapter.upsert_valuation_preferences(
+        user_id=user_id,
+        travel_style=new_style,
+        custom_valuations=new_custom
+    )
+    
+    if result:
+        return {
+            "success": True,
+            "message": f"여행 스타일이 '{new_style}'(으)로 설정되었습니다.",
+            "style": new_style,
+            "style_description": TRAVEL_STYLES.get(new_style, {}).get("description", ""),
+            "custom_valuations": new_custom if new_custom else None,
+        }
+    else:
+        return {
+            "success": False,
+            "error": "설정 저장에 실패했습니다."
+        }
+
+
+async def handle_get_valuation_styles(
+    arguments: Dict[str, Any],
+    user_id: str
+) -> Dict[str, Any]:
+    """
+    지원하는 여행 스타일 및 포인트 프로그램 목록 반환.
+    """
+    from src.db import SupabaseAdapter
+    
+    adapter = SupabaseAdapter()
+    
+    # 현재 사용자 설정
+    prefs = adapter.get_valuation_preferences(user_id)
+    current_style = prefs.get("travel_style", "VALUE") if prefs else "VALUE"
+    
+    # 스타일별 예시 가치 (AMEX MR 10,000점 기준)
+    style_examples = {}
+    for style_name, style_info in TRAVEL_STYLES.items():
+        result = calculate_point_value("AMEX_MR", 10000, style_name)
+        if result.get("success"):
+            style_examples[style_name] = {
+                "description": style_info.get("description"),
+                "example_value": f"${result.get('value')} (10,000 MR)"
+            }
+    
+    return {
+        "success": True,
+        "current_style": current_style,
+        "current_description": TRAVEL_STYLES.get(current_style, {}).get("description", ""),
+        "available_styles": style_examples,
+        "supported_programs": {
+            k: v.get("name") for k, v in POINT_VALUATIONS.items()
+        }
+    }
+
+
+# =============================================================================
+# 원-투-마일 계산기
+# =============================================================================
+
+async def handle_calculate_miles_vs_cashback(
+    arguments: Dict[str, Any],
+    user_id: str
+) -> Dict[str, Any]:
+    """
+    calculate_miles_vs_cashback Tool 핸들러.
+    
+    마일리지 적립 카드 vs 현금 할인 카드 비교.
+    """
+    from src.db import SupabaseAdapter
+    
+    # 필수 파라미터
+    amount = arguments.get("amount", 0)
+    
+    # 마일리지 적립 옵션
+    mile_rate = arguments.get("mile_rate", 1)  # 1000원당 마일 수
+    mile_per = arguments.get("mile_per", 1000)  # 기준 금액 (원)
+    mile_program = arguments.get("mile_program", "KOREAN_AIR")
+    
+    # 할인 옵션
+    discount_percent = arguments.get("discount_percent", 1.5)
+    
+    if amount <= 0:
+        return {
+            "success": False,
+            "error": "결제 금액(amount)을 입력해주세요.",
+            "example": {
+                "amount": 100000,
+                "mile_rate": 1,
+                "mile_per": 1000,
+                "discount_percent": 1.5
+            }
+        }
+    
+    # 사용자 스타일 조회
+    adapter = SupabaseAdapter()
+    prefs = adapter.get_valuation_preferences(user_id)
+    style = prefs.get("travel_style", "VALUE") if prefs else "VALUE"
+    
+    # 마일리지 계산
+    earned_miles = (amount / mile_per) * mile_rate
+    
+    # 마일 가치 계산
+    mile_value_result = calculate_point_value(mile_program, earned_miles, style)
+    if not mile_value_result.get("success"):
+        return mile_value_result
+    
+    # 통화 변환 (USD → KRW 근사: 1 USD = 1350 KRW)
+    if mile_value_result.get("currency") == "USD":
+        mile_value_krw = mile_value_result.get("value", 0) * 1350
+    else:
+        mile_value_krw = mile_value_result.get("value", 0)
+    
+    # 할인 금액 계산
+    discount_value_krw = amount * (discount_percent / 100)
+    
+    # 비교
+    difference = mile_value_krw - discount_value_krw
+    winner = "마일리지" if difference > 0 else ("할인" if difference < 0 else "동등")
+    
+    return {
+        "success": True,
+        "amount": amount,
+        "comparison": {
+            "mileage": {
+                "earned_miles": round(earned_miles, 0),
+                "program": mile_program,
+                "program_name": mile_value_result.get("program_name"),
+                "value_krw": round(mile_value_krw, 0),
+                "rate_description": f"{mile_rate}마일/{mile_per}원"
+            },
+            "cashback": {
+                "discount_percent": discount_percent,
+                "value_krw": round(discount_value_krw, 0)
+            }
+        },
+        "result": {
+            "winner": winner,
+            "difference_krw": round(abs(difference), 0),
+            "recommendation": (
+                f"마일리지 카드가 {round(abs(difference), 0):,}원 더 유리합니다."
+                if difference > 0 else
+                f"할인 카드가 {round(abs(difference), 0):,}원 더 유리합니다."
+                if difference < 0 else
+                "두 옵션이 동등합니다."
+            )
+        },
+        "style": style,
+        "note": f"'{style}' 스타일 기준으로 계산됨. 스타일에 따라 마일 가치가 달라집니다."
+    }
+
+
+# =============================================================================
+# 딥링크 빌더 (Award Search)
+# =============================================================================
+
+# 주요 공항 코드
+AIRPORT_CODES = {
+    # 한국
+    "서울": "ICN", "인천": "ICN", "김포": "GMP",
+    "부산": "PUS", "제주": "CJU",
+    # 일본
+    "도쿄": "NRT", "나리타": "NRT", "하네다": "HND",
+    "오사카": "KIX", "간사이": "KIX",
+    "후쿠오카": "FUK", "삿포로": "CTS",
+    # 동남아
+    "방콕": "BKK", "싱가포르": "SIN",
+    "호치민": "SGN", "다낭": "DAD", "하노이": "HAN",
+    "발리": "DPS", "마닐라": "MNL",
+    # 중국/홍콩
+    "홍콩": "HKG", "베이징": "PEK", "상하이": "PVG",
+    # 유럽
+    "런던": "LHR", "파리": "CDG",
+    "프랑크푸르트": "FRA", "암스테르담": "AMS",
+    "로마": "FCO", "밀라노": "MXP",
+    "바르셀로나": "BCN", "마드리드": "MAD",
+    # 미국
+    "뉴욕": "JFK", "로스앤젤레스": "LAX", "la": "LAX",
+    "샌프란시스코": "SFO", "시카고": "ORD",
+    "시애틀": "SEA", "달라스": "DFW",
+    "마이애미": "MIA", "하와이": "HNL", "호놀룰루": "HNL",
+    # 호주
+    "시드니": "SYD", "멜버른": "MEL",
+}
+
+# 좌석 클래스
+CABIN_CLASSES = {
+    "이코노미": "Y", "economy": "Y",
+    "프리미엄 이코노미": "W", "premium economy": "W", "프리이코": "W",
+    "비즈니스": "J", "business": "J", "비지니스": "J",
+    "퍼스트": "F", "first": "F", "일등석": "F",
+}
+
+
+async def handle_generate_award_search_link(
+    arguments: Dict[str, Any],
+    user_id: str
+) -> Dict[str, Any]:
+    """
+    generate_award_search_link Tool 핸들러.
+    
+    자연어 입력을 based on Seats.aero/Point.me 검색 URL로 변환합니다.
+    """
+    # 파라미터 추출
+    origin = arguments.get("origin", "ICN")
+    destination = arguments.get("destination", "")
+    date = arguments.get("date", "")  # YYYY-MM 또는 YYYY-MM-DD
+    cabin_class = arguments.get("cabin_class", "J")  # 기본 비즈니스
+    
+    # 도시명 → 공항 코드 변환
+    if origin.lower() in AIRPORT_CODES:
+        origin = AIRPORT_CODES[origin.lower()]
+    if destination.lower() in AIRPORT_CODES:
+        destination = AIRPORT_CODES[destination.lower()]
+    
+    # 좌석 클래스 변환
+    if cabin_class.lower() in CABIN_CLASSES:
+        cabin_class = CABIN_CLASSES[cabin_class.lower()]
+    
+    if not destination:
+        return {
+            "success": False,
+            "error": "목적지(destination)를 입력해주세요.",
+            "supported_cities": list(AIRPORT_CODES.keys())[:20],
+            "example": {
+                "origin": "서울",
+                "destination": "파리",
+                "date": "2026-03",
+                "cabin_class": "비즈니스"
+            }
+        }
+    
+    # URL 생성
+    origin = origin.upper()
+    destination = destination.upper()
+    cabin_class = cabin_class.upper()
+    
+    # Seats.aero URL
+    seats_aero_url = f"https://seats.aero/search?origin={origin}&destination={destination}"
+    if date:
+        seats_aero_url += f"&date={date}"
+    if cabin_class:
+        seats_aero_url += f"&class={cabin_class}"
+    
+    # Point.me URL (다른 포맷)
+    point_me_url = f"https://point.me/search/{origin}-{destination}"
+    if date:
+        point_me_url += f"?date={date}"
+    
+    return {
+        "success": True,
+        "search_params": {
+            "origin": origin,
+            "destination": destination,
+            "date": date or "flexible",
+            "cabin_class": cabin_class,
+            "cabin_class_name": {
+                "Y": "이코노미", "W": "프리미엄 이코노미",
+                "J": "비즈니스", "F": "퍼스트"
+            }.get(cabin_class, cabin_class)
+        },
+        "links": {
+            "seats_aero": seats_aero_url,
+            "point_me": point_me_url,
+        },
+        "tip": (
+            "Seats.aero는 특가 알림과 상세 검색에, "
+            "Point.me는 다양한 마일리지 프로그램 비교에 적합합니다."
+        )
+    }
+

src/db/supabase_adapter.py

@@ -204,13 +204,46 @@ class SupabaseAdapter:
             
             records.append(record)
         
+        # 배치 처리 (Supabase timeout 방지)
+        BATCH_SIZE = 30  # 50 → 30으로 줄여 안정성 향상
+        MAX_RETRIES = 3
+        BATCH_DELAY = 0.5  # 배치 간 0.5초 딜레이
+        total_saved = 0
+        
+        import time
+        
         try:
-            result = self.client.table("kb_chunks").upsert(
-                records,
-                on_conflict="chunk_id"
-            ).execute()
-            
-            return len(result.data) if result.data else len(records)
+            for i in range(0, len(records), BATCH_SIZE):
+                batch = records[i:i + BATCH_SIZE]
+                
+                # 재시도 로직
+                for attempt in range(MAX_RETRIES):
+                    try:
+                        result = self.client.table("kb_chunks").upsert(
+                            batch,
+                            on_conflict="chunk_id"
+                        ).execute()
+                        
+                        batch_saved = len(result.data) if result.data else len(batch)
+                        total_saved += batch_saved
+                        break  # 성공 시 재시도 루프 종료
+                        
+                    except Exception as e:
+                        if attempt < MAX_RETRIES - 1:
+                            print(f"   ⚠️ 배치 저장 실패 (시도 {attempt + 1}/{MAX_RETRIES}), 재시도 중...")
+                            time.sleep(2)  # 재시도 전 2초 대기
+                        else:
+                            raise  # 마지막 시도 실패 시 예외 전파
+                
+                # 진행 상황 출력 (100개마다)
+                if (i + BATCH_SIZE) % 100 == 0 or i + BATCH_SIZE >= len(records):
+                    print(f"   💾 {min(i + BATCH_SIZE, len(records))}/{len(records)} 청크 저장 완료")
+                
+                # 배치 간 딜레이 (서버 연결 유지)
+                if i + BATCH_SIZE < len(records):
+                    time.sleep(BATCH_DELAY)
+            
+            return total_saved
             
         except Exception as e:
             raise RuntimeError(f"청크 저장 실패: {e}") from e
@@ -455,6 +488,314 @@ class SupabaseAdapter:
         except Exception as e:
             print(f"⚠️ 멤버십 삭제 실패 ({user_id}, {chain}): {e}")
             return False
+    
+    # =========================================================================
+    # 신용카드 (Credit Cards)
+    # =========================================================================
+    
+    def get_user_credit_cards(self, user_id: str) -> List[Dict[str, Any]]:
+        """
+        사용자의 보유 신용카드 목록 조회.
+        
+        Args:
+            user_id: Supabase Auth UUID
+            
+        Returns:
+            신용카드 리스트
+        """
+        try:
+            result = self.client.table("user_credit_cards")\
+                .select("*")\
+                .eq("user_id", user_id)\
+                .eq("is_active", True)\
+                .order("created_at")\
+                .execute()
+            
+            return result.data or []
+        except Exception as e:
+            print(f"⚠️ 신용카드 조회 실패 ({user_id}): {e}")
+            return []
+    
+    def upsert_credit_card(
+        self,
+        user_id: str,
+        card_id: str,
+        card_name: str,
+        issuer_code: str,
+        region: str = "USA",
+        card_open_date: str = None,
+        anniversary_month: int = None,
+        annual_fee: float = None
+    ) -> Optional[Dict[str, Any]]:
+        """
+        신용카드 등록/수정.
+        
+        Args:
+            user_id: Supabase Auth UUID
+            card_id: 카드 고유 ID (AMEX_PLATINUM_US 등)
+            card_name: 카드 이름
+            issuer_code: 발급사 코드
+            region: 발급 국가
+            card_open_date: 카드 개설일 (YYYY-MM-DD)
+            anniversary_month: 연회비 갱신 월 (1-12)
+            annual_fee: 연회비
+            
+        Returns:
+            저장된 카드 정보 또는 None
+        """
+        try:
+            data = {
+                "user_id": user_id,
+                "card_id": card_id.upper(),
+                "card_name": card_name,
+                "issuer_code": issuer_code.upper(),
+                "region": region.upper(),
+                "is_active": True
+            }
+            
+            if card_open_date:
+                data["card_open_date"] = card_open_date
+            if anniversary_month:
+                data["anniversary_month"] = anniversary_month
+            if annual_fee is not None:
+                data["annual_fee_amount"] = annual_fee
+            
+            # user_id + card_id 복합키로 upsert
+            self.client.table("user_credit_cards")\
+                .delete()\
+                .eq("user_id", user_id)\
+                .eq("card_id", card_id.upper())\
+                .execute()
+            
+            result = self.client.table("user_credit_cards")\
+                .insert(data)\
+                .execute()
+            
+            return result.data[0] if result.data else None
+        except Exception as e:
+            print(f"⚠️ 신용카드 저장 실패 ({user_id}, {card_id}): {e}")
+            return None
+    
+    def delete_credit_card(self, user_id: str, card_id: str) -> bool:
+        """
+        신용카드 삭제 (soft delete - is_active = False).
+        
+        Args:
+            user_id: Supabase Auth UUID
+            card_id: 카드 고유 ID
+            
+        Returns:
+            삭제 성공 여부
+        """
+        try:
+            self.client.table("user_credit_cards")\
+                .update({"is_active": False})\
+                .eq("user_id", user_id)\
+                .eq("card_id", card_id.upper())\
+                .execute()
+            
+            return True
+        except Exception as e:
+            print(f"⚠️ 신용카드 삭제 실패 ({user_id}, {card_id}): {e}")
+            return False
+    
+    # =========================================================================
+    # 크레딧 사용 추적 (Credit Usage Tracking)
+    # =========================================================================
+    
+    def get_user_credit_usage(
+        self, 
+        user_id: str, 
+        card_id: str = None,
+        benefit_id: str = None
+    ) -> List[Dict[str, Any]]:
+        """
+        사용자의 크레딧 사용 기록 조회.
+        
+        Args:
+            user_id: Supabase Auth UUID
+            card_id: 특정 카드로 필터링 (선택)
+            benefit_id: 특정 혜택으로 필터링 (선택)
+            
+        Returns:
+            사용 기록 리스트
+        """
+        try:
+            query = self.client.table("user_credit_usage")\
+                .select("*")\
+                .eq("user_id", user_id)
+            
+            if card_id:
+                query = query.eq("card_id", card_id.upper())
+            if benefit_id:
+                query = query.eq("benefit_id", benefit_id.lower())
+            
+            result = query.order("usage_period", desc=True).execute()
+            
+            return result.data or []
+        except Exception as e:
+            print(f"⚠️ 크레딧 사용 조회 실패 ({user_id}): {e}")
+            return []
+    
+    def upsert_credit_usage(
+        self,
+        user_id: str,
+        card_id: str,
+        benefit_id: str,
+        usage_period: str,
+        amount_used: float,
+        amount_limit: float,
+        currency: str = "USD",
+        usage_date: str = None,
+        description: str = None
+    ) -> Optional[Dict[str, Any]]:
+        """
+        크레딧 사용 기록 저장/수정.
+        
+        Args:
+            user_id: Supabase Auth UUID
+            card_id: 카드 ID
+            benefit_id: 혜택 ID
+            usage_period: 사용 기간 (2026-H1, 2026-Q1, 2026-01 등)
+            amount_used: 사용 금액
+            amount_limit: 한도 금액
+            currency: 통화
+            usage_date: 실제 사용일 (YYYY-MM-DD)
+            description: 사용 내역
+            
+        Returns:
+            저장된 기록 또는 None
+        """
+        try:
+            data = {
+                "user_id": user_id,
+                "card_id": card_id.upper(),
+                "benefit_id": benefit_id.lower(),
+                "usage_period": usage_period,
+                "amount_used": amount_used,
+                "amount_limit": amount_limit,
+                "currency": currency
+            }
+            
+            if usage_date:
+                data["usage_date"] = usage_date
+            if description:
+                data["description"] = description
+            
+            # user_id + card_id + benefit_id + usage_period 복합키로 upsert
+            self.client.table("user_credit_usage")\
+                .delete()\
+                .eq("user_id", user_id)\
+                .eq("card_id", card_id.upper())\
+                .eq("benefit_id", benefit_id.lower())\
+                .eq("usage_period", usage_period)\
+                .execute()
+            
+            result = self.client.table("user_credit_usage")\
+                .insert(data)\
+                .execute()
+            
+            return result.data[0] if result.data else None
+        except Exception as e:
+            print(f"⚠️ 크레딧 사용 저장 실패 ({user_id}, {card_id}, {benefit_id}): {e}")
+            return None
+    
+    def delete_credit_usage(
+        self, 
+        user_id: str, 
+        card_id: str, 
+        benefit_id: str, 
+        usage_period: str
+    ) -> bool:
+        """
+        크레딧 사용 기록 삭제.
+        
+        Args:
+            user_id: Supabase Auth UUID
+            card_id: 카드 ID
+            benefit_id: 혜택 ID
+            usage_period: 사용 기간
+            
+        Returns:
+            삭제 성공 여부
+        """
+        try:
+            self.client.table("user_credit_usage")\
+                .delete()\
+                .eq("user_id", user_id)\
+                .eq("card_id", card_id.upper())\
+                .eq("benefit_id", benefit_id.lower())\
+                .eq("usage_period", usage_period)\
+                .execute()
+            
+            return True
+        except Exception as e:
+            print(f"⚠️ 크레딧 사용 삭제 실패: {e}")
+            return False
+
+    # =========================================================================
+    # Valuation Preferences (가치 평가 설정)
+    # =========================================================================
+    
+    def get_valuation_preferences(self, user_id: str) -> Optional[Dict[str, Any]]:
+        """
+        사용자의 가치 평가 설정 조회.
+        
+        Args:
+            user_id: Supabase Auth UUID
+            
+        Returns:
+            설정 정보 또는 None
+        """
+        try:
+            result = self.client.table("user_valuation_preferences")\
+                .select("*")\
+                .eq("user_id", user_id)\
+                .execute()
+            
+            return result.data[0] if result.data else None
+        except Exception as e:
+            print(f"⚠️ 가치 평가 설정 조회 실패 ({user_id}): {e}")
+            return None
+    
+    def upsert_valuation_preferences(
+        self,
+        user_id: str,
+        travel_style: str = "VALUE",
+        custom_valuations: Optional[Dict[str, float]] = None
+    ) -> Optional[Dict[str, Any]]:
+        """
+        사용자의 가치 평가 설정 저장 (Upsert).
+        
+        Args:
+            user_id: Supabase Auth UUID
+            travel_style: 여행 스타일 (PREMIUM, VALUE, CASHBACK)
+            custom_valuations: 개별 프로그램 가치 오버라이드
+            
+        Returns:
+            저장된 설정 또는 None
+        """
+        try:
+            data = {
+                "user_id": user_id,
+                "travel_style": travel_style.upper(),
+                "custom_valuations": custom_valuations or {}
+            }
+            
+            # user_id UNIQUE 제약으로 upsert
+            self.client.table("user_valuation_preferences")\
+                .delete()\
+                .eq("user_id", user_id)\
+                .execute()
+            
+            result = self.client.table("user_valuation_preferences")\
+                .insert(data)\
+                .execute()
+            
+            return result.data[0] if result.data else None
+        except Exception as e:
+            print(f"⚠️ 가치 평가 설정 저장 실패 ({user_id}): {e}")
+            return None
 
 
 # =============================================================================

src/mcp/server_streamable.py

@@ -499,6 +499,373 @@ TOOLS = [
             },
             "required": ["code"]
         }
+    },
+    # ============================================================
+    # Credit Card Tools (신용카드 관리/혜택 추천)
+    # ============================================================
+    {
+        "name": "user_add_credit_card",
+        "description": (
+            "보유 신용카드를 등록합니다. "
+            "등록된 카드를 바탕으로 사용 가능한 크레딧/혜택을 추적하고 추천받을 수 있습니다."
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "card_id": {
+                    "type": "string",
+                    "description": (
+                        "카드 고유 ID. 예: AMEX_PLATINUM_US, CHASE_SAPPHIRE_RESERVE. "
+                        "지원 발급사: AMEX, CHASE, CITI, CAPITAL_ONE"
+                    )
+                },
+                "card_name": {
+                    "type": "string",
+                    "description": "카드 이름 (선택, card_id로 자동 추론 가능)"
+                },
+                "issuer_code": {
+                    "type": "string",
+                    "description": "발급사 코드 (선택, card_id로 자동 추론 가능)"
+                },
+                "region": {
+                    "type": "string",
+                    "default": "USA",
+                    "description": "발급 국가 (기본: USA)"
+                },
+                "card_open_date": {
+                    "type": "string",
+                    "description": "카드 개설일 (선택, YYYY-MM-DD)"
+                },
+                "anniversary_month": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 12,
+                    "description": "연회비 갱신/청구 월 (선택, 1-12)"
+                },
+                "annual_fee": {
+                    "type": "number",
+                    "description": "연회비 금액 (선택)"
+                },
+                "session_token": {
+                    "type": "string",
+                    "description": "인증 세션 토큰"
+                }
+            },
+            "required": ["card_id", "session_token"]
+        }
+    },
+    {
+        "name": "user_get_credit_cards",
+        "description": "등록된 보유 신용카드 목록을 조회합니다.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "session_token": {
+                    "type": "string",
+                    "description": "인증 세션 토큰"
+                }
+            },
+            "required": ["session_token"]
+        }
+    },
+    {
+        "name": "user_delete_credit_card",
+        "description": "등록된 신용카드를 삭제합니다.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "card_id": {
+                    "type": "string",
+                    "description": "삭제할 카드 ID"
+                },
+                "session_token": {
+                    "type": "string",
+                    "description": "인증 세션 토큰"
+                }
+            },
+            "required": ["card_id", "session_token"]
+        }
+    },
+    {
+        "name": "user_update_credit_usage",
+        "description": (
+            "신용카드 크레딧/혜택 사용 기록을 업데이트합니다. "
+            "예: AMEX Platinum FHR 크레딧 $300 사용 완료"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "card_id": {
+                    "type": "string",
+                    "description": "카드 ID (예: AMEX_PLATINUM_US)"
+                },
+                "benefit_id": {
+                    "type": "string",
+                    "description": (
+                        "혜택 ID. 예: amex_plat_hotel_credit (FHR), "
+                        "amex_plat_saks_credit, amex_plat_uber_cash, "
+                        "amex_plat_digital_entertainment, amex_plat_resy_credit"
+                    )
+                },
+                "amount_used": {
+                    "type": "number",
+                    "description": "사용 금액 (선택, 미입력 시 전체 한도로 기록)"
+                },
+                "usage_date": {
+                    "type": "string",
+                    "description": "사용일 (선택, YYYY-MM-DD, 미입력 시 오늘)"
+                },
+                "description": {
+                    "type": "string",
+                    "description": "사용 내역 메모 (선택)"
+                },
+                "session_token": {
+                    "type": "string",
+                    "description": "인증 세션 토큰"
+                }
+            },
+            "required": ["card_id", "benefit_id", "session_token"]
+        }
+    },
+    {
+        "name": "user_get_credit_recommendations",
+        "description": (
+            "현재 시점에서 사용해야 할 크레딧/혜택을 추천합니다. "
+            "기간별 마감일이 임박한 혜택을 우선순위로 보여줍니다. "
+            "예: 'AMEX Platinum FHR 상반기 크레딧 $300 - 6월 30일 마감'"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "session_token": {
+                    "type": "string",
+                    "description": "인증 세션 토큰"
+                }
+            },
+            "required": ["session_token"]
+        }
+    },
+    {
+        "name": "user_get_credit_usage_summary",
+        "description": (
+            "특정 카드 또는 전체 카드의 크레딧 사용 현황 요약을 조회합니다. "
+            "각 혜택별 사용/잔여 금액과 비율을 보여줍니다."
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "card_id": {
+                    "type": "string",
+                    "description": "특정 카드 ID로 필터링 (선택, 미입력 시 전체 카드)"
+                },
+                "session_token": {
+                    "type": "string",
+                    "description": "인증 세션 토큰"
+                }
+            },
+            "required": ["session_token"]
+        }
+    },
+    # ============================================================
+    # Shadow Valuation Tools (포인트/마일리지 가치 평가)
+    # ============================================================
+    {
+        "name": "user_get_asset_valuation",
+        "description": (
+            "보유 포인트/마일리지의 현재 가치를 계산합니다. "
+            "사용자의 여행 스타일(PREMIUM/VALUE/CASHBACK)에 따라 동일한 포인트도 다른 가치로 평가됩니다. "
+            "예: AMEX MR 50,000점은 PREMIUM 스타일에서 $1,100, CASHBACK 스타일에서 $300로 평가됩니다."
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "assets": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "program": {
+                                "type": "string",
+                                "description": "프로그램 ID (예: AMEX_MR, CHASE_UR, KOREAN_AIR, MARRIOTT_BONVOY)"
+                            },
+                            "amount": {
+                                "type": "number",
+                                "description": "포인트/마일 수량"
+                            }
+                        },
+                        "required": ["program", "amount"]
+                    },
+                    "description": "평가할 자산 목록"
+                },
+                "style": {
+                    "type": "string",
+                    "enum": ["PREMIUM", "VALUE", "CASHBACK"],
+                    "description": "이번 계산에 사용할 스타일 (선택, 미입력 시 저장된 사용자 스타일 사용)"
+                },
+                "session_token": {
+                    "type": "string",
+                    "description": "인증 세션 토큰"
+                }
+            },
+            "required": ["assets", "session_token"]
+        }
+    },
+    {
+        "name": "user_update_valuation_style",
+        "description": (
+            "포인트 가치 평가에 사용할 여행 스타일을 설정합니다. "
+            "PREMIUM: 비즈니스/퍼스트 발권 목표 (높은 가치), "
+            "VALUE: 일반 사용 (표준 가치), "
+            "CASHBACK: 현금성 사용 선호 (낮은 가치)"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "style": {
+                    "type": "string",
+                    "enum": ["PREMIUM", "VALUE", "CASHBACK"],
+                    "description": "설정할 여행 스타일"
+                },
+                "custom_valuations": {
+                    "type": "object",
+                    "description": (
+                        "개별 프로그램 가치 오버라이드 (선택). "
+                        "예: {\"AMEX_MR\": 2.5, \"KOREAN_AIR\": 20}"
+                    )
+                },
+                "session_token": {
+                    "type": "string",
+                    "description": "인증 세션 토큰"
+                }
+            },
+            "required": ["session_token"]
+        }
+    },
+    {
+        "name": "user_get_valuation_styles",
+        "description": (
+            "지원하는 여행 스타일과 포인트 프로그램 목록을 조회합니다. "
+            "각 스타일별 예시 가치와 현재 사용자 설정을 확인할 수 있습니다."
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "session_token": {
+                    "type": "string",
+                    "description": "인증 세션 토큰"
+                }
+            },
+            "required": ["session_token"]
+        }
+    },
+    # ============================================================
+    # Asset Parser / Calculator / Deeplink Tools
+    # ============================================================
+    {
+        "name": "user_parse_asset_text",
+        "description": (
+            "사용자가 입력한 텍스트에서 포인트/마일리지 정보를 자동으로 추출합니다. "
+            "예: '대한항공 45000 마일, AMEX MR 50000점' → 구조화된 자산 목록으로 변환"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "text": {
+                    "type": "string",
+                    "description": (
+                        "파싱할 텍스트. 프로그램명과 숫자를 포함해주세요. "
+                        "예: '대한항공 45000\\n아시아나 12000\\nAMEX MR 50000'"
+                    )
+                },
+                "save_to_profile": {
+                    "type": "boolean",
+                    "default": False,
+                    "description": "파싱된 자산을 프로필에 저장할지 여부 (향후 기능)"
+                },
+                "session_token": {
+                    "type": "string",
+                    "description": "인증 세션 토큰"
+                }
+            },
+            "required": ["text", "session_token"]
+        }
+    },
+    {
+        "name": "calculate_miles_vs_cashback",
+        "description": (
+            "마일리지 적립 카드 vs 현금 할인 카드 중 어느 것이 더 유리한지 계산합니다. "
+            "예: 10만원 결제 시 '1000원당 1마일' vs '1.5% 할인' 비교"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "amount": {
+                    "type": "number",
+                    "description": "결제 금액 (원)"
+                },
+                "mile_rate": {
+                    "type": "number",
+                    "default": 1,
+                    "description": "적립 마일 수 (기본: 1)"
+                },
+                "mile_per": {
+                    "type": "number",
+                    "default": 1000,
+                    "description": "마일 적립 기준 금액 (원, 기본: 1000)"
+                },
+                "mile_program": {
+                    "type": "string",
+                    "default": "KOREAN_AIR",
+                    "description": "마일리지 프로그램 (기본: KOREAN_AIR)"
+                },
+                "discount_percent": {
+                    "type": "number",
+                    "default": 1.5,
+                    "description": "할인율 (%, 기본: 1.5)"
+                },
+                "session_token": {
+                    "type": "string",
+                    "description": "인증 세션 토큰"
+                }
+            },
+            "required": ["amount", "session_token"]
+        }
+    },
+    {
+        "name": "generate_award_search_link",
+        "description": (
+            "특가석 검색을 위한 Seats.aero/Point.me URL을 생성합니다. "
+            "도시명(한글/영문)을 공항 코드로 자동 변환합니다. "
+            "예: '서울 → 파리 비즈니스' → 검색 URL 생성"
+        ),
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "origin": {
+                    "type": "string",
+                    "default": "ICN",
+                    "description": "출발지 (도시명 또는 공항 코드, 기본: ICN)"
+                },
+                "destination": {
+                    "type": "string",
+                    "description": "목적지 (도시명 또는 공항 코드)"
+                },
+                "date": {
+                    "type": "string",
+                    "description": "날짜 (YYYY-MM 또는 YYYY-MM-DD 형식, 미입력 시 유연 검색)"
+                },
+                "cabin_class": {
+                    "type": "string",
+                    "default": "J",
+                    "description": "좌석 클래스 (Y/W/J/F 또는 이코노미/비즈니스/퍼스트)"
+                },
+                "session_token": {
+                    "type": "string",
+                    "description": "인증 세션 토큰"
+                }
+            },
+            "required": ["destination", "session_token"]
+        }
     }
 ]