Fine Dust By Location

What this skill does

https://k-skill-proxy.nomadamas.org/v1/fine-dust/report

When to use

• "지금 내 위치 미세먼지 어때?"
• "강남 쪽 초미세먼지 수치 알려줘"
• "여기 공기질 괜찮아?"

Inputs

• 일반 입력: 지역명/행정구역 힌트
• 재조회 입력: 정확한 측정소명

Region naming convention

• 좋음:

  강남구

  ,

  서울 강남구

  ,

  종로구

  ,

  수원시

• 애매함:

  강남

  ,

  서울 남쪽

  ,

  코엑스 근처

서울 강남구

강남구

Default path

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \
  --data-urlencode 'regionHint=서울 강남구'

python3 scripts/fine_dust.py report --region-hint '서울 강남구' --json

Ambiguous locations

ambiguous_location

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \
  --data-urlencode 'regionHint=광주 광산구'

candidate_stations

stationName

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \
  --data-urlencode 'stationName=우산동(광주)'

Detailed API paths

/B552584/...

• docs/features/fine-dust-location.md

• docs/features/k-skill-proxy.md

Keep the answer compact

• 측정소
• 조회 시각
• PM10 값과 등급
• PM2.5 값과 등급
• 통합대기등급
• 조회 방식(

  fallback

  )

Failure modes

• regionHint 가 너무 넓거나 단일 측정소를 확정할 수 없는 경우
• 프록시 서버가 내려가 있거나 upstream key가 비어 있는 경우
• 측정소명과 지역명이 달라 직접 fallback 이 필요한 경우

Notes

• 기본 경로는 항상

  k-skill-proxy.nomadamas.org

  의 report endpoint 다.
• 지역명 조회는 먼저 후보를 얻고, 필요하면 정확한 측정소명으로 재조회한다.
• passthrough / direct AirKorea 구현 세부는 스킬 본문에 길게 반복하지 않는다.
• free API 프록시는 공개 endpoint 를 기본으로 둔다.