Seoul Subway Crowd (SK Open API)
Inputs to collect
- Station name (required)
- Line name/number (optional but recommended)
- Direction (optional): up/down or inbound/outbound
- Time mode (optional): now/forecast
Workflow
- Ensure
SK_OPENAPI_KEYexists in environment. - Read endpoint and parameter mapping from
references/api-map.md. - Run
scripts/fetch_crowd.pywith station/line/time arguments. - Return a short Korean summary:
- 혼잡도 등급
- 핵심 수치(있으면)
- 한 줄 코멘트(이동 추천/회피 시간)
- If API fails, return clear fallback with reason and next action.
CLI usage
python3 scripts/fetch_crowd.py --station "강남역" --line "2호선" --mode train
python3 scripts/fetch_crowd.py --station "홍대입구역" --line "2호선" --mode car --dow MON --hh 08
Output style
- Keep it short and practical.
- Prefer bullet list over tables on Discord.
- Include raw response path when debugging (
--save-json).
Notes
- Do not hardcode API key.
- Normalize common line variants ("2", "2호선", "Line 2").
- If API schema changes, update
references/api-map.mdfirst.