메뉴
한국도로공사·국가교통정보센터 공개 API로 고속도로 실시간 소통(구간별 속도/교통량/정체 등급)과 CCTV 스트림 메타데이터를 조회한다. Use when the user asks 고속도로 정체, 교통 상황, 노선/구간 소통, 고속도로 CCTV. Not for 대중교통 길찾기 or 자동차 경로 안내.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Korean apartment and individual-house official price lookup through the public realtyprice.kr web data surface. Use when the user asks for 공동주택가격, 개별주택가격, 아파트 공시가격, 단독주택 공시가격, or housing official price history. This is not land official price, transaction price, or building register metadata.
한국은행 ECOS Open API로 기준금리, 환율, 소비자물가지수, 통화량 등 중앙은행 경제통계 시계열과 100대 핵심지표를 조회한다. Use when the user asks 기준금리, 환율 추이, 물가지수, M2, 국고채 금리, 거시경제 통계. Not for 주식 시세(korean-stock-search) or KOSIS 일반 통계(kosis-stats).
After installing the full k-skill bundle, configure and verify the shared cross-platform setup, then optionally wire update checks and GitHub starring with explicit user consent.
국가데이터처가 운영하는 KOSIS(국가통계포털, kosis.kr) Open API로 한국 공식 통계표를 검색하고 메타데이터·데이터·대용량 자료를 조회한다. Use when the user asks for 한국 공식 통계 (인구, 가구, 물가, 고용 등) 수치 조회, not for analysis or visualization.
Search, reserve, inspect, and cancel KTX or Korail tickets in Korea with the korail2 + pycryptodome Python packages. Use when the user asks for KTX seats, Korail bookings, train changes, reservation status, remaining seat numbers, car-by-car seats, or power-outlet/good-seat tips.
Use when the user asks to search Korean theses, academic articles, research reports, journals, or university-library catalog metadata through KERIS RISS.
| name | highway-traffic-status |
| description | 한국도로공사·국가교통정보센터 공개 API로 고속도로 실시간 소통(구간별 속도/교통량/정체 등급)과 CCTV 스트림 메타데이터를 조회한다. Use when the user asks 고속도로 정체, 교통 상황, 노선/구간 소통, 고속도로 CCTV. Not for 대중교통 길찾기 or 자동차 경로 안내. |
| license | MIT |
| metadata | {"category":"transit","locale":"ko-KR","phase":"v1"} |
data.ex.co.kr)의 실시간 교통량 API로 전국 고속도로 콘존(구간)별 속도, 교통량, 소통등급(원활/서행/정체)을 조회한다.openapi.its.go.kr)의 CCTV 정보 API로 좌표 범위 내 고속도로 CCTV 이름·좌표·HLS 스트림 URL을 조회한다.이 스킬은 조회 전용이다. 경로 안내, 내비게이션, 통행료 계산은 범위 밖이다.
korean-transit-routekakao-maptest)로 동작함을 확인했다 (2026-07-21). 공개 엔드포인트이므로 k-skill-proxy를 경유하지 않고 직접 호출한다.선택 환경변수 (데모 키 회수/쿼터 대비):
KSKILL_EXDATA_API_KEY — data.ex.co.kr 개인 인증키 (https://data.ex.co.kr 회원가입 후 발급)KSKILL_ITS_API_KEY — openapi.its.go.kr 개인 인증키 (https://www.its.go.kr/opendata)~/.config/k-skill/secrets.env 의 같은 이름 키도 읽는다.
python3 highway-traffic-status/scripts/highway_traffic.py traffic --route 경부 --text
--route: 노선명 일부(경부, 서해안) 또는 노선번호(0010)--keyword: 구간(콘존) 이름 키워드 (예: 서울TG, 양재)--limit N: 출력 행 수 (기본 30)--text 없이 실행하면 구조화 JSON을 출력한다.JSON 출력 필드: route_name, route_no, conzone_name, direction(상행/하행), speed_kmh, traffic_volume, travel_time_sec, congestion(원활/서행/정체), observed_at.
좌표 범위(경도 --min-x/--max-x, 위도 --min-y/--max-y)가 필수다. 사용자가 지명을 말하면 대략적인 bounding box로 변환해 호출한다.
python3 highway-traffic-status/scripts/highway_traffic.py cctv \
--min-x 126.9 --max-x 127.2 --min-y 37.3 --max-y 37.6 --text
url은 HLS 스트림 주소다. 스트림 재생은 사용자 환경(브라우저/플레이어) 몫이며 스킬은 메타데이터만 제공한다.--road-type: ex(고속도로, 기본) / its(국도) / allgrade를 그대로 원활/서행/정체로 표시하고, 자체 판단을 덧붙이지 않는다.observed_at 기준 시각을 함께 알려준다 (실시간 스냅샷임을 명시).https://data.ex.co.kr/openapi/odtraffic/trafficAmountByRealtime?key=<key>&type=json — 전국 VDS 실시간 스냅샷. 필터(노선/구간)는 helper가 클라이언트 측에서 수행한다.https://openapi.its.go.kr:9443/cctvInfo?apiKey=<key>&type=ex&cctvType=1&minX=..&getType=json — 성공 응답은 XML(문서와 달리 getType=json이어도 XML)이며 helper가 XML을 파싱한다.두 표면 모두 데모 키 test가 유효하다. 개인 키가 환경변수에 있으면 그것을 우선 사용한다.
| 상황 | 동작 |
|---|---|
빈 결과 (result: "empty") | 조건에 맞는 구간/CCTV 없음 — 노선명·좌표 범위를 넓혀 재시도 안내 |
인증키 오류 (인증키가 유효하지 않습니다 / ITS 401 resultCode 4005) | 데모 키 회수 가능성 안내, 개인 키 발급 후 환경변수 지정 안내 |
| upstream HTTP 오류/타임아웃 | 잠시 후 재시도 안내, 점검 가능성 언급 |
| JSON/XML 파싱 실패 | 차단 또는 형식 변경 가능성 — 이슈 보고 안내 |
| 좌표 범위 오류 | 한국 범위(경도 124 |