fine-dust-locationlisted

# Fine Dust By Location ## What this skill does 기본적으로 `https://k-skill-proxy.nomadamas.org/v1/fine-dust/report` 로 요청해서 PM10 / PM2.5 / 통합대기등급을 요약한다. ## When to use - "지금 내 위치 미세먼지 어때?" - "강남 쪽 초미세먼지 수치 알려줘" - "여기 공기질 괜찮아?" ## Inputs - 일반 입력: 지역명/행정구역 힌트 - 재조회 입력: 정확한 측정소명 ## Region naming convention 지역명은 아래처럼 **측정소명에 가까운 한국어 행정구역 이름**을 우선 사용한다. - 좋음: `강남구`, `서울 강남구`, `종로구`, `수원시` - 애매함: `강남`, `서울 남쪽`, `코엑스 근처` 여러 토큰이 들어오면 helper / proxy 는 보통 **가장 구체적인 토큰**을 우선 본다. 예: `서울 강남구` → `강남구`. ## Default path 추가 client API 레이어는 불필요하다. 그냥 프록시 서버에 HTTP 요청만 넣으면 된다. ```bash curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \ --data-urlencode 'regionHint=서울 강남구' ``` 스크립트 helper 도 같은 report endpoint 를 기본 경로로 사용한다. ```bash python3 scripts/fine_dust.py report --region-hint '서울 강남구' --json ``` ## Ambiguous locations 입력한 지역명이 단일 측정소로 바로 확정되지 않으면 proxy 는 `ambiguous_location` 과 함께 후보 측정소 목록을 돌려준다. 예: ```bash curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \ --data-urlencode 'regionHint=광주 광산구' ``` 이때 응답의 `candidate_stations` 중 하나를 골라 다시 `stationName` 으로 조회한다. ```bash curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \ --data-urlencode 'stationName=우산동(광주)' ``` ## Detailed API paths 원본 AirKorea와 비슷한 passthrough 경로(`/B552584/...`)나 direct fallback 상세는 아래 문서만 참고한다. - `docs/features/fine-dust-location.md` - `docs/features/k-skill-proxy.md` ## Keep the answer compact 응답에는 아래만 먼저 정리한다. - 측정소 - 조회 시