highway-traffic-status

Query real-time Korean highway traffic speeds, congestion grades, and CCTV stream metadata via public APIs.

7.4k|904|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill highway-traffic-status
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: highway-traffic-status
Source: https://github.com/NomaDamas/k-skill/tree/main/highway-traffic-status
Command: npx skills add https://github.com/NomaDamas/k-skill --skill highway-traffic-status

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes scripts (resource) components.

What problem does it solve?

Checking Korean highway congestion before a trip usually means opening multiple apps or websites. This Skill lets an AI agent directly query live highway traffic conditions and CCTV locations from official public APIs, so you get segment-level speed, traffic volume, and congestion status in one answer.

Core Features & Use Cases

  • Real-time traffic lookup: Query nationwide highway segments (conzones) by route name or number via the Korea Expressway Corporation open API, returning speed, traffic volume, travel time, and congestion grade (์›ํ™œ/์„œํ–‰/์ •์ฒด).
  • CCTV metadata search: Find highway CCTV cameras within a coordinate bounding box via the National Transport Information Center (ITS) API, including HLS stream URLs.
  • No user API key required: Both upstream APIs work with public demo keys, with optional personal key overrides via environment variables.
  • Use Case: Before driving from Seoul to Busan, ask the agent "์ง€๊ธˆ ๊ฒฝ๋ถ€๊ณ ์†๋„๋กœ ๋ง‰ํ˜€?" and receive a segment-by-segment congestion summary with observation timestamps.

Quick Start

Ask the agent to check current congestion on the Gyeongbu Expressway and summarize which segments are slow right now.

Frequently Asked Questions about highway-traffic-status

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check real-time Korean highway traffic conditions?โ–ผ

Run the traffic subcommand with a route name like ๊ฒฝ๋ถ€ or a route number like 0010 to get per-segment speed, traffic volume, and congestion grade from the Korea Expressway Corporation real-time API. Results include the observation timestamp since data is a live snapshot.

How to find highway CCTV cameras near a location in Korea?โ–ผ

Use the cctv subcommand with a coordinate bounding box (min/max longitude and latitude) around the area of interest. The ITS API returns camera names, coordinates, and HLS stream URLs, which you can open in any compatible player.

Does the Korea Expressway traffic API require an API key?โ–ผ

No user key is required because the public demo key works for both the data.ex.co.kr traffic API and the ITS CCTV API. You can optionally set KSKILL_EXDATA_API_KEY or KSKILL_ITS_API_KEY environment variables for a personal key with higher quota.

Can this skill provide driving directions or navigation?โ–ผ

No, it is read-only traffic and CCTV lookup only. For public transit routing use a transit route skill, and for car navigation or toll estimates use a Kakao Map-based routing skill instead.

Why does the traffic query return an authentication key error?โ–ผ

The upstream demo key may have been revoked or rate-limited. Register at data.ex.co.kr or its.go.kr to obtain a personal API key, then set it via the corresponding environment variable or the secrets.env file.