io.github.lovelyquality/korail-mcp

역별 선로·시설 상세 정보 조회 (공통기준 역상세, 로컬 CSV, 2025.06.18 기준, 5161행). 구내유효장·선로길이·지선·전용선 거리, 총선수, 분기역여부, 입환시작여부 등 현장 운영에 필요한 역 선로 제원 정보 제공. - station_name: 역이름 부분일치 (예: '서울', '부산', '대전'). 미입력 시 전체. - current_only: True(기본)이면 현재 유효한 이력만 반환 (역이력적용종료일자 빈 값). False이면 이력 전체(동일 역의 이력 변경 포함) 반환. 주요 컬럼: 구내유효장(m), 구내선로길이(m), 지선유효장(m), 지선선로거리(m), 전용선유효장(m), 전용선선로거리(m), 총선수, 분기역여부(Y/N), 입환시작여부(Y/N)

역별 타 교통수단과 환승현황 조회 (odcloud, 2024.12.31 기준, 93개 역). 노선별·역별 KTX·광역철도·도시철도 역수 및 환승주차장 면수 포함. station_name: 역명 부분일치 (예: '서울', '동대구'). line_name: 노선명 부분일치 (예: '경부고속', '호남선'). 미입력 시 전체 반환. (EN: transfer info to other transit modes by station. JA: 駅別の他交通手段への乗換現況)

업무지원 부서별 직위·직급 인원 현황 조회 (10,015건). 부서명, 직위명, 직급명, 인원수를 제공한다. 조직 내 인력 배분 및 직무 구조 파악에 활용. ※ 전체 조회 시 최대 200건 반환. 필터 사용 권장. dept_name: 부서명 부분일치 필터 (예: "서울역", "AI전략본부", "차량사업소") position: 직위명 부분일치 필터 (예: "역장", "팀장", "기술원") grade: 직급명 부분일치 필터 (예: "사무영업3급", "운전4급", "토목5급")

사옥 내 부대시설 목록 조회 (29건). 본사 사옥 내 부대시설(카페·어린이집·회의실·스포츠센터·편의점 등)의 시설명, 생성일시, 수정일시, 비고를 제공한다. ※ 최신성 주의: 2025.08.20 기준 데이터로 현재와 다를 수 있음.

열차운행 코드정보 조회. 최소 하나 이상의 파라미터 필요. code_type=코드유형(예:stn_cd,mrnt_cd), code=코드값(정확일치), value=코드명(부분일치) 주요 code_type: stn_cd(역코드), mrnt_cd(주운행선코드)

차종별 연간 운행실적 조회 (로컬 CSV, 2025.08.31 기준, 2019~2025년). 디젤기관차·전기기관차·전동차(수도권) 등 KORAIL 보유 차종별 연간 운행 횟수. 2025년은 8월까지의 통계. - year: 특정 연도 (예: 2024). 0이면 전체(2019~2025). - train_type: 차종명 부분일치 필터 (예: 'KTX', 'ITX', '디젤기관차', '전기기관차'). 미입력 시 전체 차종 컬럼 반환. 주요 차종: 디젤기관차(4400·7300·7400·7500호대), 전기기관차(8200·8500호대), KTX, ITX-새마을, ITX-청춘, 누리로, 수도권전동차 각 계열

차세대예약발매 열차 운행내역 조회 (2024-01-01 단일 일자 100건 스냅샷). ※ 데이터 한계 (반드시 참고): - 이 데이터는 2024-01-01 하루치만 존재. 다른 날짜 필터 시 0건 반환. - 실제 하루 운행 열차는 수백 편이나, 이 스냅샷은 일부 열차·역 포함. - 동일 (열차번호, 역)이 2건씩 중복 등장하는 경우 있음 (경유 처리 방식). - 정차 순번 필드 없음 → 정확한 정차 순서는 get_train_run_info 또는 get_train_run_plan으로 교차 확인 필요. - 역코드 상세 정보(영문명·지역본부 등)는 korail-codebook의 decode_station_code 도구로 조회 가능. 파라미터: - run_dt: 운행일자 (YYYY-MM-DD, 예: '2024-01-01') - trn_no: 열차번호 (예: '6' 또는 '00006', 숫자 자동 변환) - stn_nm: 한글역명 부분일치 (예: '서울', '부산') - stn_cd: 역코드 정확일치 (예: '3900023') - dedupe: True 시 동일 (열차번호+역코드) 중복 레코드 제거 (기본 False) 반환 필드: 운행일자(RUN_DT), 열차번호(TRN_NO), 역코드(STN_CD), 한글역명(KOR_STN_NM)

여객열차 실제 운행정보 조회 (운행일자·역별 실제 출발/도착시각·정차구분). run_ymd=특정일자(YYYYMMDD), run_ymd_gte/lte=기간 범위, stn_nm=역명(예:서울), mrnt_nm=주운행선명(예:경부선)

여객열차 운행계획 조회 (열차번호·출발/도착역·계획출발/도착시각). run_ymd=특정일자(YYYYMMDD), run_ymd_gte/lte=기간 범위, dptre_stn_nm=출발역명(예:서울), arvl_stn_nm=도착역명(예:부산)

동력차 형별제원 조회 (2024.12.31 기준, 47개 차종). KTX·KTX-산천·KTX-이음·디젤기관차·전기기관차·디젤동차·전기동차·ITX 등 각 차종의 마력(HP)·보유대수·자중(톤)·내용연수 포함. train_type: 형별명 부분일치 (예: 'KTX', '디젤기관차', '전기기관차', 'ITX'). 미입력 시 전체 47개 반환.

수송실적 통계 코드정보 조회. 간선·광역·화물 수송실적에서 사용되는 코드를 조회합니다. (구 get_carriage_codes — carriageStatistics/codes) 최소 하나 이상의 파라미터를 입력해야 결과가 반환됩니다. Args: code_type: 코드유형 (예: "stn_cd"=역코드, "mrnt_cd"=주운행선코드, "sbwy_ln_cd"=전철선코드) code: 코드값 정확일치 (예: "3900023") value: 코드명 부분일치 (예: "서울", "경부") 주의: 파라미터 없이 호출하면 0건 반환될 수 있습니다. code_type 지정을 권장합니다.

도시철도 역사 접근성 시설 조회 (교통약자). facility_type: elevator 엘리베이터 현황 elevator_route 엘리베이터 이동동선 elevator_route_detail 엘리베이터 상세 이동동선(경로 텍스트) escalator 에스컬레이터 현황 wheelchair_route 휠체어리프트 이동동선 wheelchair_lift_loc 휠체어리프트 설치 위치(치수·한계중량) safety_step 승강장 안전발판 설치유무 platform_gap 승강장-차량 이격거리 braille 점자표시 유무 disabled_toilet 장애인화장실 위치 adjacent_elevator 인접 승강기 차량번호 stair_car 인접 계단 차량번호(휠체어 하차위치) all 위 전체 (역이 1~3개로 특정될 때만) station_name: 역명. operator: 운영기관 코드/명(선택). [답변 지침] _meta의 '데이터수정일'(KRIC 데이터 최종수정 시점, 측정성 데이터는 '측정시점')을 근거로 데이터 시점을 알리되, 수정일에 따라 톤을 달리하라. - 최근(약 2년 이내, 예 2025~2026): 답변 끝에 '데이터는 OOOO년 기준'을 간결히 한 줄만. 경고 문구나 고객센터 전화번호를 따로 나열하지 마라. - 오래됨(2019~2021 등): 한 줄 고지에 더해 '최신 현황과 다를 수 있어 운영기관 확인 권장'을 딱 한 번만 덧붙여라. 전화번호는 사용자가 묻거나 응급·안전 관련일 때만. 여러 데이터셋을 함께 보여줄 땐 가장 오래된 수정일 기준으로 한 번만 고지하면 된다. 시점 고지·주의 문구를 답변 안에서 반복하지 마라. 결과가 비어 있으면 지어내지 말고 '해당 데이터 없음'을 분명히 알려라.

도시철도 역사 편의시설 조회. amenity_type: toilet(화장실) / nursing_room(수유실) / locker(물품보관함) / atm(ATM) / lost_found(유실물센터) / wifi(무선인터넷) / all(전체) station_name: 역명. operator: 운영기관 코드/명(선택). [답변 지침] _meta의 '데이터수정일'(KRIC 데이터 최종수정 시점, 측정성 데이터는 '측정시점')을 근거로 데이터 시점을 알리되, 수정일에 따라 톤을 달리하라. - 최근(약 2년 이내, 예 2025~2026): 답변 끝에 '데이터는 OOOO년 기준'을 간결히 한 줄만. 경고 문구나 고객센터 전화번호를 따로 나열하지 마라. - 오래됨(2019~2021 등): 한 줄 고지에 더해 '최신 현황과 다를 수 있어 운영기관 확인 권장'을 딱 한 번만 덧붙여라. 전화번호는 사용자가 묻거나 응급·안전 관련일 때만. 여러 데이터셋을 함께 보여줄 땐 가장 오래된 수정일 기준으로 한 번만 고지하면 된다. 시점 고지·주의 문구를 답변 안에서 반복하지 마라. 결과가 비어 있으면 지어내지 말고 '해당 데이터 없음'을 분명히 알려라.

도시철도 역사 환경측정 정보 조회 (공기질·온도·습도·소음). measure: air_quality(공기질·미세먼지·CO2) / temperature(온도) / humidity(습도) / noise(소음도) / all(전체) station_name: 역명. operator: 운영기관 코드/명(선택). 주의: 환경측정기는 일부 운영기관·역에만 설치되어 데이터가 없을 수 있다 (특히 소음도). 측정값에는 측정일시(msmtDttm)가 함께 온다. [답변 지침] _meta의 '데이터수정일'(KRIC 데이터 최종수정 시점, 측정성 데이터는 '측정시점')을 근거로 데이터 시점을 알리되, 수정일에 따라 톤을 달리하라. - 최근(약 2년 이내, 예 2025~2026): 답변 끝에 '데이터는 OOOO년 기준'을 간결히 한 줄만. 경고 문구나 고객센터 전화번호를 따로 나열하지 마라. - 오래됨(2019~2021 등): 한 줄 고지에 더해 '최신 현황과 다를 수 있어 운영기관 확인 권장'을 딱 한 번만 덧붙여라. 전화번호는 사용자가 묻거나 응급·안전 관련일 때만. 여러 데이터셋을 함께 보여줄 땐 가장 오래된 수정일 기준으로 한 번만 고지하면 된다. 시점 고지·주의 문구를 답변 안에서 반복하지 마라. 결과가 비어 있으면 지어내지 말고 '해당 데이터 없음'을 분명히 알려라.

도시철도 역사 출구정보 조회 (출구번호·주변시설·거리). station_name: 역명. operator: 운영기관 코드/명(선택). [답변 지침] _meta의 '데이터수정일'(KRIC 데이터 최종수정 시점, 측정성 데이터는 '측정시점')을 근거로 데이터 시점을 알리되, 수정일에 따라 톤을 달리하라. - 최근(약 2년 이내, 예 2025~2026): 답변 끝에 '데이터는 OOOO년 기준'을 간결히 한 줄만. 경고 문구나 고객센터 전화번호를 따로 나열하지 마라. - 오래됨(2019~2021 등): 한 줄 고지에 더해 '최신 현황과 다를 수 있어 운영기관 확인 권장'을 딱 한 번만 덧붙여라. 전화번호는 사용자가 묻거나 응급·안전 관련일 때만. 여러 데이터셋을 함께 보여줄 땐 가장 오래된 수정일 기준으로 한 번만 고지하면 된다. 시점 고지·주의 문구를 답변 안에서 반복하지 마라. 결과가 비어 있으면 지어내지 말고 '해당 데이터 없음'을 분명히 알려라.

도시철도 교통약자 출입구→승강장 이동경로(동선) 조회. 엘리베이터 등 무장애 경로를 출입구부터 승강장까지 단계별 텍스트(mvContDtl)와 안내 이미지(imgPath)로 제공한다. station_name: 역명. operator: 운영기관 코드/명(선택). line: 노선(선택). next_station: 열차 진행방면의 '다음 역명'(승강장 방향 특정에 사용). 같은 노선의 다음 역명을 넣는다. 미입력 시 방면 구분 없이 조회. 참고: 역 내 엘리베이터 상세 동선은 get_urban_accessibility(elevator_route_detail)도 있다. [답변 지침] _meta의 '데이터수정일'(KRIC 데이터 최종수정 시점, 측정성 데이터는 '측정시점')을 근거로 데이터 시점을 알리되, 수정일에 따라 톤을 달리하라. - 최���(약 2년 이내, 예 2025~2026): 답변 끝에 '데이터는 OOOO년 기준'을 간결히 한 줄만. 경고 문구나 고객센터 전화번호를 따로 나열하지 마라. - 오래됨(2019~2021 등): 한 줄 고지에 더해 '최신 현황과 다를 수 있어 운영기관 확인 권장'을 딱 한 번만 덧붙여라. 전화번호는 사용자가 묻거나 응급·안전 관련일 때만. 여러 데이터셋을 함께 보여줄 땐 가장 오래된 수정일 기준으로 한 번만 고지하면 된다. 시점 고지·주의 문구를 답변 안에서 반복하지 마라. 결과가 비어 있으면 지어내지 말고 '해당 데이터 없음'을 분명히 알려라.

도시철도 역사 승강장 정보 조회 (승강장 유형·복합여부·안전발판 등). station_name: 역명. operator: 운영기관 코드/명(선택). [답변 지침] _meta의 '데이터수정일'(KRIC 데이터 최종수정 시점, 측정성 데이터는 '측정시점')을 근거로 데이터 시점을 알리되, 수정일에 따라 톤을 달리하라. - 최근(약 2년 이내, 예 2025~2026): 답변 끝에 '데이터는 OOOO년 기준'을 간결히 한 줄만. 경고 문구나 고객센터 전화번호를 따로 나열하지 마라. - 오래됨(2019~2021 등): 한 줄 고지에 더해 '최신 현황과 다를 수 있어 운영기관 확인 권장'을 딱 한 번만 덧붙여라. 전화번호는 사용자가 묻거나 응급·안전 관련일 때만. 여러 데이터셋을 함께 보여줄 땐 가장 오래된 수정일 기준으로 한 번만 고지하면 된다. 시점 고지·주의 문구를 답변 안에서 반복하지 마라. 결과가 비어 있으면 지어내지 말고 '해당 데이터 없음'을 분명히 알려라.

도시철도 노선 전체 역 구성(상행~하행 순서) 조회. 역 무관, 노선 단위. line: 선코드(예 '1','A1','I1') 또는 노선명 일부(예 '1호선','경의중앙'). region: 권역 — 수도권/부산/대구/광주/대전 (또는 코드 01~05). 수도권 노선은 region을 함께 주면 정확하다. [답변 지침] _meta의 '데이터수정일'(KRIC 데이터 최종수정 시점, 측정성 데이터는 '측정시점')을 근거로 데이터 시점을 알리되, 수정일에 따라 톤을 달리하라. - 최근(약 2년 이내, 예 2025~2026): 답변 끝에 '데이터는 OOOO년 기준'을 간결히 한 줄만. 경고 문구나 고객센터 전화번호를 따로 나열하지 마라. - 오래됨(2019~2021 등): 한 줄 고지에 더해 '최신 현황과 다를 수 있어 운영기관 확인 권장'을 딱 한 번만 덧붙여라. 전화번호는 사용자가 묻거나 응급·안전 관련일 때만. 여러 데이터셋을 함께 보여줄 땐 가장 오래된 수정일 기준으로 한 번만 고지하면 된다. 시점 고지·주의 문구를 답변 안에서 반복하지 마라. 결과가 비어 있으면 지어내지 말고 '해당 데이터 없음'을 분명히 알려라.

도시철도 역사 안전시설 조회. safety_type: defibrillator(제세동기) / fire_extinguish(소화설비) / emergency_phone(비상콜폰) / air_respirator(공기호흡기) / screen_door(스크린도어) / safety_fence(승강장 안전펜스) / all(전체) station_name: 역명. operator: 운영기관 코드/명(선택). [답변 지침] _meta의 '데이터수정일'(KRIC 데이터 최종수정 시점, 측정성 데이터는 '측정시점')을 근거로 데이터 시점을 알리되, 수정일에 따라 톤을 달리하라. - 최근(약 2년 이내, 예 2025~2026): 답변 끝에 '데이터는 OOOO년 기준'을 간결히 한 줄만. 경고 문구나 고객센터 전화번호를 따로 나열하지 마라. - 오래됨(2019~2021 등): 한 줄 고지에 더해 '최신 현황과 다를 수 있어 운영기관 확인 권장'을 딱 한 번만 덧붙여라. 전화번호는 사용자가 묻거나 응급·안전 관련일 때만. 여러 데이터셋을 함께 보여줄 땐 가장 오래된 수정일 기준으로 한 번만 고지하면 된다. 시점 고지·주의 문구를 답변 안에서 반복하지 마라. 결과가 비어 있으면 지어내지 말고 '해당 데이터 없음'을 분명히 알려라.

도시철도 역사 기본정보 조회 (주소·좌표·다국어 역명). station_name: 역명. operator: 환승역 구분용 운영기관 코드/명(선택). [답변 지침] _meta의 '데이터수정일'(KRIC 데이터 최종수정 시점, 측정성 데이터는 '측정시점')을 근거로 데이터 시점을 알리되, 수정일에 따라 톤을 달리하라. - 최근(약 2년 이내, 예 2025~2026): 답변 끝에 '데이터는 OOOO년 기준'을 간결히 한 줄만. 경고 문구나 고객센터 전화번호를 따로 나열하지 마라. - 오래됨(2019~2021 등): 한 줄 고지에 더해 '최신 현황과 다를 수 있어 운영기관 확인 권장'을 딱 한 번만 덧붙여라. 전화번호는 사용자가 묻거나 응급·안전 관련일 때만. 여러 데이터셋을 함께 보여줄 땐 가장 오래된 수정일 기준으로 한 번만 고지하면 된다. 시점 고지·주의 문구를 답변 안에서 반복하지 마라. 결과가 비어 있으면 지어내지 말고 '해당 데이터 없음'을 분명히 알려라.

도시철도 역 주변 시설 조회 (대중교통·주차장·자전거). kind: public_transport(주변 버스 등 대중교통) / parking(주변 주차장) / bike_parking(자전거 주차시설) / bike_rental(자전거 대여) / all(전체) station_name: 역명. operator: 운영기관 코드/명(선택). [답변 지침] _meta의 '데이터수정일'(KRIC 데이터 최종수정 시점, 측정성 데이터는 '측정시점')을 근거로 데이터 시점을 알리되, 수정일에 따라 톤을 달리하라. - 최근(약 2년 이내, 예 2025~2026): 답변 끝에 '데이터는 OOOO년 기준'을 간결히 한 줄만. 경고 문구나 고객센터 전화번호를 따로 나열하지 마라. - 오래됨(2019~2021 등): 한 줄 고지에 더해 '최신 현황과 다를 수 있어 운영기관 확인 권장'을 딱 한 번만 덧붙여라. 전화번호는 사용자가 묻거나 응급·안전 관련일 때만. 여러 데이터셋을 함께 보여줄 땐 가장 오래된 수정일 기준으로 한 번만 고지하면 된다. 시점 고지·주의 문구를 답변 안에서 반복하지 마라. 결과가 비어 있으면 지어내지 말고 '해당 데이터 없음'을 분명히 알려라.

도시철도 역사별 운행시각표(열차 도착·출발시각) 조회. station_name: 역명. operator: 운영기관 코드/명(선택). day: 요일 — 평일/휴일/토/일/월~금 또는 전요일. (기본 평일) express: True면 급행 시각표(운영기관에 따라 미제공일 수 있음). [답변 지침] _meta의 '데이터수정일'(KRIC 데이터 최종수정 시점, 측정성 데이터는 '측정시점')을 근거로 데이터 시점을 알리되, 수정일에 따라 톤을 달리하라. - 최근(약 2년 이내, 예 2025~2026): 답변 끝에 '데이터는 OOOO년 기준'을 간결히 한 줄만. 경고 문구나 고객센터 전화번호를 따로 나열하지 마라. - 오래됨(2019~2021 등): 한 줄 고지에 더해 '최신 현황과 다를 수 있어 운영기관 확인 권장'을 딱 한 번만 덧붙여라. 전화번호는 사용자가 묻거나 응급·안전 관련일 때만. 여러 데이터셋을 함께 보여줄 땐 가장 오래된 수정일 기준으로 한 번만 고지하면 된다. 시점 고지·주의 문구를 답변 안에서 반복하지 마라. 결과가 비어 있으면 지어내지 말고 '해당 데이터 없음'을 분명히 알려라.

도시철도 운영기관별 열차 편성종류 조회 (역 무관). 편성유형코드(cpsTpCd)·편성명·호차별 좌석/출입문수/교통약자석 등을 준다. 이 도구로 얻은 cpsTpCd와 호차(scarNo)를 get_urban_train_facility의 composition_type·scar_seq 인자로 넘겨 차량별 시설을 조회한다. operator: 운영기관 코드(예 'BS') 또는 명(예 '부산교통공사'). 참고: 서울교통공사(S1)·한국철도공사(KR)·공항철도(AR)는 편성데이터 미제공. 부산(BS)·대구(DG)·인천(IC)·대전(DJ)·광주(GJ) 등은 제공. [답변 지침] _meta의 '데이터수정일'(KRIC 데이터 최종수정 시점, 측정성 데이터는 '측정시점')을 근거로 데이터 시점을 알리되, 수정일에 따라 톤을 달리하라. - 최근(약 2년 이내, 예 2025~2026): 답변 끝에 '데이터는 OOOO년 기준'을 간결히 한 줄만. 경고 문구나 고객센터 전화번호를 따로 나열하지 마라. - 오래됨(2019~2021 등): 한 줄 고지에 더해 '최신 현황과 다를 수 있어 운영기관 확인 권장'을 딱 한 번만 덧붙여라. 전화번호는 사용자가 묻거나 응급·안전 관련일 때만. 여러 데이터셋을 함께 보여줄 땐 가장 오래된 수정일 기준으로 한 번만 고지하면 된다. 시점 고지·주의 문구를 답변 안에서 반복하지 마라. 결과가 비어 있으면 지어내지 말고 '해당 데이터 없음'을 분명히 알려라.

도시철도 열차 차내 환경정보 조회 (CO2·미세먼지·온도·습도·소음 등, 역 무관). operator: 운영기관 코드(예 'S1') 또는 명(예 '서울교통공사'). train_no: 열차번호(선택). 미입력 시 해당 운영기관 전체 측정 데이터를 반환한다 (사용자가 열차번호를 모를 때가 많으므로 보통 생략). measure: 환경측정 항목코드(envrMsmtDvCd) — 1 미세먼지(PM10), 2 CO2, 21 온도, 22 습도, 23 소음 등. 미입력 시 전체 항목. 참고: 차내 환경 데이터는 서울교통공사(S1)·부산(BS)·대구(DG) 등 일부 기관만 제공. 한국철도공사(KR)·공항철도(AR) 등은 미제공. [답변 지침] _meta의 '데이터수정일'(KRIC 데이터 최종수정 시점, 측정성 데이터는 '측정시점')을 근거로 데이터 시점을 알리되, 수정일에 따라 톤을 달리하라. - 최근(약 2년 이내, 예 2025~2026): 답변 끝에 '데이터는 OOOO년 기준'을 간결히 한 줄만. 경고 문구나 고객센터 전화번호를 따로 나열하지 마라. - 오래됨(2019~2021 등): 한 줄 고지에 더해 '최신 현황과 다를 수 있어 운영기관 확인 권장'을 딱 한 번만 덧붙여라. 전화번호는 사용자가 묻거나 응급·안전 관련일 때만. 여러 데이터셋을 함께 보여줄 땐 가장 오래된 수정일 기준으로 한 번만 고지하면 된다. 시점 고지·주의 문구를 답변 안에서 반복하지 마라. 결과가 비어 있으면 지어내지 말고 '해당 데이터 없음'을 분명히 알려라.

도시철도 차량(호차)별 시설 조회 (역 무관). facility_type: fire_extinguisher(소화기) / emergency_phone(비상콜폰) / crush_hammer(비상탈출망치) / door_manual(출입문 수동설정) / defibrillator(제세동기) / pregnant_seat(임산부 배려석) / priority_seat(노약자석) / wheelchair_board(휠체어 승차가능) / wheelchair_belt(휠체어 안전벨트) / all(전체) operator: 운영기관 코드/명. scar_seq: 호차일련번호(scarSqno, 예 '1'). composition_type: 편성유형코드(cpsTpCd). get_urban_train_composition으로 먼저 확인한다. 주의: 운영기관마다 보유 항목이 달라 일부 종류는 빈 결과일 수 있다. [답변 지침] _meta의 '데이터수정일'(KRIC 데이터 최종수정 시점, 측정성 데이터는 '측정시점')을 근거로 데이터 시점을 알리되, 수정일에 따라 톤을 달리하라. - 최근(약 2년 이내, 예 2025~2026): 답변 끝에 '데이터는 OOOO년 기준'을 간결히 한 줄만. 경고 문구나 고객센터 전화번호를 따로 나열하지 마라. - 오래됨(2019~2021 등): 한 줄 고지에 더해 '최신 현황과 다를 수 있어 운영기관 확인 권장'을 딱 한 번만 덧붙여라. 전화번호는 사용자가 묻거나 응급·안전 관련일 때만. 여러 데이터셋을 함께 보여줄 땐 가장 오래된 수정일 기준으로 한 번만 고지하면 된다. 시점 고지·주의 문구를 답변 안에서 반복하지 마라. 결과가 비어 있으면 지어내지 말고 '해당 데이터 없음'을 분명히 알려라.

도시철도 역사 환승정보 조회 (환승노선·환승거리·동선). station_name: 역명. operator: 운영기관 코드/명(선택). [답변 지침] _meta의 '데이터수정일'(KRIC 데이터 최종수정 시점, 측정성 데이터는 '측정시점')을 근거로 데이터 시점을 알리되, 수정일에 따라 톤을 달리하라. - 최근(약 2년 이내, 예 2025~2026): 답변 끝에 '데이터는 OOOO년 기준'을 간결히 한 줄만. 경고 문구나 고객센터 전화번호를 따로 나열하지 마라. - 오래됨(2019~2021 등): 한 줄 고지에 더해 '최신 현황과 다를 수 있어 운영기관 확인 권장'을 딱 한 번만 덧붙여라. 전화번호는 사용자가 묻거나 응급·안전 관련일 때만. 여러 데이터셋을 함께 보여줄 땐 가장 오래된 수정일 기준으로 한 번만 고지하면 된다. 시점 고지·주의 문구를 답변 안에서 반복하지 마라. 결과가 비어 있으면 지어내지 말고 '해당 데이터 없음'을 분명히 알려라.

화차 적재하중별 보유현황 조회 (2024.12.31 기준, 27개 하중 등급). 적재하중(화물 최대 적재 중량) 등급별 유개차·무개차·평판차·소화물·유조차·차장차·침식차 보유 대수. 필드명 주의: '유 개 차', '무 개 차', '평 판 차' 등 띄어쓰기 포함. wagon_type: 차종 (예: '유 개 차', '무 개 차', '평 판 차', '유 조 차'). 해당 차종 보유량 > 0 인 행만 반환. min_load: 최소 적재하중 (예: '40'). max_load: 최대 적재하중 (예: '60'). 미입력 시 전체 27개 행 반환.

화차 자중별 보유현황 조회 (2024.12.31 기준, 70개 자중 구간). 자중(톤) 구간별 유개차·유조차·무개차·평판차·소화물·차장차·침식차 보유 대수. wagon_type: 차종 필터 (예: '유개차', '유조차', '무개차', '평판차'). 해당 차종 보유량 > 0 인 행만 반환. min_weight: 최소 자중(톤, 예: '20'). max_weight: 최대 자중(톤, 예: '25'). 미입력 시 전체 70개 행 반환.

광역 여객열차 수송실적 조회. 전철역별 시간대별 승하차 인원수를 제공합니다. 광역철도(수도권 전철 등) 이용 통계 조회에 사용. Args: run_ymd: 특정 운행일자 (YYYYMMDD). 입력 시 해당 날짜만 조회. run_ymd_gte: 운행일자 시작 (YYYYMMDD, 이후) run_ymd_lte: 운행일자 종료 (YYYYMMDD, 이전) sbwy_ln_cd: 전철선코드 (예: "101") sbwy_ln_nm: 전철선명 (예: "경부선") sbwy_stn_cd: 전철역코드 (예: "010000") sbwy_stn_nm: 전철역명 (예: "서울") tmwd_se_cd: 시간대구분코드 (예: "01")

광역철도 노선별 이용인원 통계 (갱신: 매월 26일, M-1). run_ym=운행연월(YYYYMM), sbwy_ln_nm=전철선명

광역철도 역별 승하차 통계 (갱신: 매월 26일, M-1). run_ym=운행연월(YYYYMM), stn_nm=역명

화물적하작업 - 전용 작업선 정보 (총 424건, odcloud, 전체 캐시). 역명 부분일치 필터 가능. 작업선 길이·작업거리·운임계산거리·할인할증 등 포함.

표준 적하시간 마스터 (총 11건, odcloud, 전체 반환). ⚠️ 명칭 주의: data.go.kr 등록명은 '적하시간'이지만 실제 데이터는 화물 유형별 표준 작업시간 마스터(일반 보통품·화약류·컨테이너 등 11건). 조정 이력은 search_loading_time_adjustment 사용.

지역본부명(부분일치)으로 관할 역 목록 조회. 주요 지역본부: 서울본부, 수도권동부본부, 충청본부, 전라본부, 대구본부, 부산경남본부, 강원본부 예: region='서울', region='부산경남'

엘리베이터가 설치된 역 목록 전체 조회 (B551457 실시간 API). (EN: list of stations with elevators. JA: エレベーターが設置された駅の一覧) ※ 데이터기준일: 실시간 API. 현장 변경이 즉시 반영되지 않을 수 있음.

수탁변경요금 검색 (총 4,015건, 로컬 CSV). 화물 운송장 접수 후 발생한 착역 변경·화물 지시 변경 등 수탁 조건 변경 건별 요금 이력. 필터: 제요금입력역명(station), 운송장번호(waybill_no), 화물지시종류(change_type).

수탁변경요금 화차별 (총 6,681건, 로컬 CSV). 개별 화차 단위 지시번호·운송장번호·화통번호 매핑 및 화차요금 산출 근거. 필터: 화차차량번호(wagon_number), 운송장번호(waybill_no).

컨테이너 적재 이력 페이지 조회 (총 166,275건, odcloud). 대용량이라 매 호출 시 odcloud에 페이지 단위로 요청. 필터(컨테이너번호/화차차량번호/화물수탁일자/품목명)가 주어지면 받은 페이지 내에서 부분일치로 후필터링. per_page 최대 1000.

내적화물코드 검색 (총 961건). 분류코드(예: 7404), 한글명, 영문명에 대한 부분일치 검색. 빈 query시 limit만큼 앞에서부터 반환.

G2B(나라장터) 분류번호·품명 검색 (총 13,400건, 로컬 CSV). G2B분류번호(8자리) 또는 G2B품명(한글·영문)으로 부분일치 검색. 품명해설 포함. active_only=True 시 사용 코드만 반환.

적하시간 조정 이력 페이지 조회 (총 35,967건, odcloud). ⚠️ 명칭 주의: data.go.kr 등록명은 '표준적하시간'이지만 실제 데이터는 표준 대비 조정된 이력. 마스터는 list_standard_loading_time 사용. 필터: 조정역(station), 조정사유(reason, 예: '천재지변등 악조건', '작업능력초과'), 조정지역본부(region). 받은 페이지 내 부분일치 필터링. per_page 최대 1000.

자재속성정보 조회 (총 34,630건, 로컬 CSV). 자재번호·G2B분류번호·속성코드로 조회. 자재별 속성값(규격·재질·치수 등) 확인. 최소 1개 필터 권장 (미지정 시 앞에서 limit건 반환).

자재대상장비 조회 (총 24,258건, 로컬 CSV). 특정 자재번호가 사용되는 장비 코드 조회, 또는 장비코드로 해당 자재 역검색.

자재그룹코드 검색 (총 999건, 로컬 CSV). 그룹코드(예: BB1300) 또는 그룹명칭(예: EMU용품)으로 부분일치 검색. active_only=True 시 사용 중(Y)인 코드만 반환.

전국 철도 노선 정보를 검색합니다. (총 2,146개) ⚠️ 여기서 "노선"은 물리적 선로(경부선·호남선 등)가 아니라 열차 운행계통 코드입니다. 경부선 선로 하나에도 다양한 경유 패턴의 운행계통이 수백 개 존재합니다. "비전기 노선이 몇 개냐" 같은 인프라 기준 질문에는 수치가 과대 계산됩니다. Args: query: 노선코드(ROUT_CD) 또는 노선명(ROUT_NM) 검색어 (부분 일치). 없으면 전체 반환. ※ 노선명에 "KTX" 문자열 없음. 고속선은 "고속", "경부고속" 등으로 표기됨. electric_only: True면 전기동력차 운행 노선만, False면 비전기 노선만. None이면 전체. Returns: 노선코드(ROUT_CD), 노선명(ROUT_NM), 전기동력차운행여부(ELC_LCM_RUN_FLG) 목록.

노선명(부분일치)으로 노선코드를 조회. name 미입력 시 전체 노선 목록 반환. 예: name='경부', name='호남', name='KTX'

역명(부분일치)으로 역코드·영문명·지역본부를 통합 조회. 차세대예약발매 역코드(75역, 영문명 포함)와 철도운영정보 역코드(1255역) 두 시스템을 함께 검색. 예: name='서울', name='수서', name='광명'

전국 도시철도 역명으로 운영기관·선·역코드를 검색한다 (다른 조회의 선행 단계). KRIC API는 운영기관·선·역코드가 필요하므로, 먼저 이 도구로 역을 특정하면 환승역 등 동일 역명의 운영기관 구분을 확인할 수 있다. station_name: 역명 부분일치 (예: '서울역', '강남'). 미입력 시 operator 기준 전체. operator: 운영기관 코드(예: 'S1') 또는 명(예: '서울교통공사') 부분일치로 좁힘. [답변 지침] _meta의 '데이터수정일'(KRIC 데이터 최종수정 시점, 측정성 데이터는 '측정시점')을 근거로 데이터 시점을 알리되, 수정일에 따라 톤을 달리하라. - 최근(약 2년 이내, 예 2025~2026): 답변 끝에 '데이터는 OOOO년 기준'을 간결히 한 줄만. 경고 문구나 고객센터 전화번호를 따로 나열하지 마라. - 오래됨(2019~2021 등): 한 줄 고지에 더해 '최신 현황과 다를 수 있어 운영기관 확인 권장'을 딱 한 번만 덧붙여라. 전화번호는 사용자가 묻거나 응급·안전 관련일 때만. 여러 데이터셋을 함께 보여줄 땐 가장 오래된 수정일 기준으로 한 번만 고지하면 된다. 시점 고지·주의 문구를 답변 안에서 반복하지 마라. 결과가 비어 있으면 지어내지 말고 '해당 데이터 없음'을 분명히 알려라.