사용자가 "기준금리 알려줘", "최근 성장률", "물가상승률 추이" 등을 물을 때
통계표코드나 항목코드를 검색할 필요 없이 즉각적으로 시계열 데이터를 반환합니다.

지원하는 지표 키워드:
- 기준금리 ("기준금리", "금리", "정책금리") — 변경 시점만 반환(changes_only 기본 True)
- 경제성장률 ("경제성장률", "성장률", "GDP성장률") — 실질 GDP 전기비 %
- 국내총생산 ("GDP", "실질GDP", "국내총생산") — 실질 GDP 수준(십억원)
- 소비자물가상승률 ("물가상승률", "인플레이션") — CPI 전년동월비 %(yoy_pct)
- 소비자물가지수 ("CPI", "소비자물가", "물가") — 지수 수준(2020=100)
- 원/달러 환율 ("환율", "원달러", "달러", "USD") — 일별 / ("월평균환율") — 월평균
- 본원통화 ("본원통화", "중앙은행부채")
- M2 광의통화 ("M2", "통화량", "광의통화")
- 국고채 3년 ("국고채", "국고채3년", "채권금리") — 일별 / ("국고채월평균") — 월평균
- 생산자물가지수 ("PPI", "생산자물가")

Args:
    indicator: 조회할 지표명 또는 키워드 (예: "기준금리", "물가상승률", "성장률", "환율")
    recent_years: start_date 미지정 시 최근 몇 년치를 조회할지 (기본: 일별 지표 최근 3개월, 그 외 2년)
    start_date: 검색 시작일 (주기에 맞는 포맷. 미입력 시 자동 계산)
    end_date: 검색 종료일 (미입력 시 현재 시점)
    output_format: "compact"(기본값, 계열별 [시점, 값] 배열), "csv", "json"(ECOS 원본 행)
    transform: "yoy"(전년동기대비 %), "pop"(직전 관측치 대비 %), "none". 미지정 시 지표 기본값 사용
    changes_only: True면 값이 바뀐 시점만 반환. 미지정 시 지표 기본값 사용

Returns:
    핵심 경제지표 시계열 데이터. 결과가 한 번에 다 담기지 않으면 최신 구간을 우선 반환합니다.

★ 스마트 날짜: start_date, end_date를 생략하면 일간(D)은 최근 3개월, 그 외 주기는 최근 2년이 자동 설정됩니다.
★ 최신 우선: 결과가 end_count를 넘으면 가장 최근 구간을 반환하고 truncated=true와 안내를 붙입니다.
★ 증감률: transform="yoy"(전년동기대비 %) 또는 "pop"(직전 관측치 대비 %)를 지정하면 계산 열이 추가됩니다.
★ 포맷: "compact"(기본값, 계열별 [시점, 값] 배열), "csv", "json"(ECOS 원본 행)

★ 주기(cycle) 및 날짜 포맷 규칙:
- 연간(A): YYYY (예: "2024")
- 반기(S): YYYYS1, YYYYS2 (예: "2023S1")
- 분기(Q): YYYYQ1 ~ YYYYQ4 (예: "2024Q3")
- 월간(M): YYYYMM (예: "202401")
- 반월(SM): YYYYMMS1, YYYYMMS2 (예: "202401S1")
- 일간(D): YYYYMMDD (예: "20240315")

Args:
    stat_code: 통계표코드 (필수). 예: "722Y001"(기준금리), "901Y009"(소비자물가)
    cycle: 주기 (필수). A(연), S(반기), Q(분기), M(월), SM(반월), D(일)
    start_date: 검색 시작일 (선택)
    end_date: 검색 종료일 (선택)
    item_code1~4: 통계항목코드 (선택. 미지정 시 전체 세부항목 조회 — 결과가 매우 커질 수 있음)
    output_format: "compact"(기본값), "csv", "json"
    transform: "yoy", "pop", "none"(기본값)
    changes_only: True면 값이 바뀐 시점만 반환 (금리처럼 드물게 변하는 일별 지표에 유용)
    prefer_latest: 결과가 잘릴 때 최신 구간을 우선 반환 (기본값 True)
    start_count: 조회 시작 순번 (기본값: 1)
    end_count: 조회 끝 순번 (기본값: 1000)
    language: 응답 언어 — "kr" 또는 "en"

Returns:
    시계열 데이터 (지정된 포맷)

ECOS 통계표 전체의 로컬 인덱스를 사용하므로 API 호출 없이 즉시 응답합니다.
- keyword 지정: 이름 검색. 띄어쓰기로 나눈 단어가 모두 포함된 통계표를 관련도 순으로 반환
  ("소비자 물가" → "소비자물가지수"). parent_code를 함께 주면 그 분류 아래에서만 검색합니다.
- keyword 없이 parent_code 지정: 해당 분류의 직속 하위 항목 반환 (분류 노드 포함)
- 둘 다 없음: 최상위 분류 목록 반환

Args:
    keyword: 검색할 통계명 또는 키워드 (예: "물가", "금리", "환율", "경상수지")
    parent_code: 상위 분류 STAT_CODE (예: "0000000001")
    searchable_only: keyword 검색 시 실제 데이터 조회가 가능한 통계표(SRCH_YN='Y')만 반환 (기본값: True)
    limit: keyword 검색 시 최대 반환 개수 (기본값: 20)

Returns:
    통계표 목록 (STAT_CODE, STAT_NAME, CYCLE, SRCH_YN 등)

GDP 성장률, 기준금리, 소비자물가 상승률, 실업률, M1/M2 통화량 등
한국 경제의 핵심 지표를 한 번에 확인할 수 있습니다.

Args:
    start_count: 조회 시작 순번 (기본값: 1)
    end_count: 조회 끝 순번 (기본값: 100, sample 키는 최대 10건으로 자동 제한)
    language: 응답 언어 — "kr"(한국어) 또는 "en"(영어)

Returns:
    주요 경제지표 목록

한국은행 통계용어사전에서 용어의 상세 설명을 조회합니다.
예: "기준금리", "GDP", "소비자물가지수", "통화승수" 등
(ECOS 방화벽 제약으로 '/'는 공백으로 바뀌어 검색됩니다.)

Args:
    word: 검색할 통계/경제 용어
    start_count: 조회 시작 순번 (기본값: 1)
    end_count: 조회 끝 순번 (기본값: 10)
    language: 응답 언어 — "kr" 또는 "en"

Returns:
    용어 정의 목록

Args:
    stat_code: 통계표코드 (필수). search_statistic_tables에서 찾은 코드 입력.
    start_count: 조회 시작 순번 (기본값: 1)
    end_count: 조회 끝 순번 (기본값: 500)
    language: 응답 언어 — "kr" 또는 "en"

Returns:
    세부항목 목록 (has_more=true면 start_count를 늘려 다음 페이지 조회)

Args:
    data_name: 데이터셋 이름 (필수). 예: "경제심리지수", "소비자물가지수"
    start_count: 조회 시작 순번 (기본값: 1)
    end_count: 조회 끝 순번 (기본값: 100)
    language: 응답 언어 — "kr" 또는 "en"

Returns:
    메타데이터