菜单
서울 주요 121개 핫스팟 장소의 실시간 혼잡도와 인구 현황을 조회한다. 지금 강남역이 얼마나 붐비는지, 홍대 인파가 얼마나 되는지 물어볼 때 사용한다.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | seoul-density |
| description | 서울 주요 121개 핫스팟 장소의 실시간 혼잡도와 인구 현황을 조회한다. 지금 강남역이 얼마나 붐비는지, 홍대 인파가 얼마나 되는지 물어볼 때 사용한다. |
| license | MIT |
| metadata | {"category":"utility","locale":"ko-KR","phase":"v1"} |
서울 실시간 도시데이터 API(data.seoul.go.kr)를 호출해 121개 핫스팟의 현재 혼잡도 단계(여유 / 보통 / 약간 붐빔 / 붐빔)와 추정 인구 범위를 반환한다.
데이터는 KT·SKT 통신 신호 기반 추계치이며, 5분 주기로 갱신되나 호출 시점 기준 약 15분 전 값이다.
별도 API 키 발급 없이 그대로 쓸 수 있다. 모든 호출은 k-skill-proxy 경유다.
https://k-skill-proxy.nomadamas.org — 프록시 서버가 SEOUL_OPEN_API_KEY를 보유하고 있어 사용자는 키 없이 호출만 하면 된다.KSKILL_PROXY_BASE_URL 환경변수로 프록시 주소를 바꿀 수 있다(예: 로컬 개발용 http://127.0.0.1:4020).이 스킬의 모든 동작은 단일 진입점을 통한다. OS·CWD에 관계없이 동일하게 동작하도록 절대 경로 + Python launcher fallback을 사용한다:
# macOS / Linux / Git-bash
python3 "$SKILL_DIR/scripts/seoul_density.py" <subcommand> [args]
# Windows (PowerShell): py 런처 또는 python
py -3 "$env:SKILL_DIR\scripts\seoul_density.py" <subcommand> [args]
$SKILL_DIR은 이 SKILL.md가 위치한 디렉토리다(~/.claude/skills/seoul-density 또는 레포의 seoul-density/). 호출 예시는 아래 Workflow 참조.
첫 사용 시 Bash(python3 *seoul_density.py:*) (또는 PowerShell 환경에서 PowerShell(py -3 *seoul_density.py*)) 패턴 한 번만 승인하면 이후 호출은 모두 자동 허용된다. 외부 dependency는 없고 Python 표준 라이브러리만 사용한다.
| 명령 | 설명 |
|---|---|
list [--json] | 지원 121개 장소 목록 (카테고리별) |
match <키워드> [--limit N] [--json] | 사용자 입력 → 지원 장소명 매칭 |
query <장소명> [--json] | 실시간 혼잡도/인구 조회 (사람이 읽는 요약 또는 JSON) |
사용자가 "홍대 인파"처럼 모호하게 말하면 먼저 후보를 확인한다.
python3 "$SKILL_DIR/scripts/seoul_density.py" match "홍대" --json
# → ["홍대 관광특구", "홍대입구역(2호선)"]
후보가 1개면 바로 query로 넘어가도 되고(스크립트가 자동 매칭), 여러 개면 어느 쪽인지 사용자에게 확인한다.
키워드 1개만 매칭되면 자동으로 보정한다.
# macOS / Linux / Git-bash
python3 "$SKILL_DIR/scripts/seoul_density.py" query "강남역"
# Windows PowerShell
py -3 "$env:SKILL_DIR\scripts\seoul_density.py" query "강남역"
출력 예시:
장소: 강남역
혼잡도: 약간 붐빔
인구 추정: 24000~26000명
기준 시각: 2026-05-14 09:30
상황: 사람이 몰려있을 수 있어요
기계적 후처리가 필요하면 --json 플래그를 쓴다:
python3 "$SKILL_DIR/scripts/seoul_density.py" query "강남역" --json
자동 매칭을 끄고 싶으면 --no-auto를 쓴다.
| 상황 | 동작 |
|---|---|
| 프록시 정상 응답 | 별도 키 불필요, 즉시 결과 반환 |
지원하지 않는 장소명 (exit 1) | match 결과로 후보 제안 |
프록시 HTTP/네트워크 오류 (exit 1) | stderr에 사유 출력, KSKILL_PROXY_BASE_URL 점검 또는 5분 후 재시도 안내 |
| 새벽 01~05시 빈 응답 | 실시간 데이터 미제공 시간대임을 안내 |
| 일일 할당량 초과 | 다음 날 재시도 안내 |
curl, python3 -c, source 같은 inline 명령을 직접 실행하지 말 것. 그렇게 하면 사용자가 매번 별도 승인을 받아야 한다.seoul-density/scripts/seoul_density.py의 AREAS 딕셔너리만 갱신한다.법원 전자소송 지급명령 신청을 위해 채권자·채무자·청구금액·청구원인·증빙 정보를 인터뷰하고, 신청서 초안과 공식 전자소송 브라우저 입력 handoff를 준비한다.
국방전자조달시스템(D2B) 공개 입찰공고 검색 화면에서 공고건명·공고구분·공고/개찰일·G2B공고번호·발주기관 조건으로 공고를 조회한다.
S2B 학교장터 공개 고객 공고/견적요청 목록을 브라우저 우선으로 조회하고 fixture HTML을 파싱해 공고 메타데이터를 정리한다.
사용자가 직접 로그인한 예비군 홈페이지(yebigun1.mil.kr) Chrome 세션을 재사용해 이번 훈련 일정/장소를 조회하고, 작년 이전 기록과 비교해 무엇이 달라졌는지 알려준다. 조회 전용이며 로그인이나 연기·보류 신청은 절대 자동화하지 않는다.
조달청 나라장터 발주계획현황서비스로 물품·공사·용역·외자 발주계획 목록을 검색한다.
당근부동산(realty.daangn.com) 공개 웹 데이터로 지역 기반 부동산 매물 검색과 상세 확인을 수행한다. 문의/예약/계약 자동화는 제외한다.