fine-dust-location

依位置查詢粉塵資訊

此技能的功能

預設向 https://k-skill-proxy.nomadamas.org/v1/fine-dust/report 發送請求，取得 PM10 / PM2.5 / 綜合空氣品質指數的摘要。

使用時機

• 「現在我這裡的空氣品質如何？」
• 「告訴我江南區的超細粉塵數值」
• 「這裡的空氣好嗎？」

輸入

• 一般輸入：地區名稱/行政區提示
• 重新查詢輸入：精確的測站名稱

地區命名慣例

地區名稱優先使用接近測站名稱的韓文行政區名稱，如下所示：

• 明確：강남구、서울 강남구、종로구、수원시
• 模糊：강남、서울 남쪽、코엑스 근처

若輸入多個 token，helper / proxy 通常優先處理最具體的 token。例如：서울 강남구 → 강남구。

預設路徑

不需要額外的 client API 層，直接向代理伺服器發送 HTTP 請求即可。

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

腳本 helper 也使用相同的 report endpoint 作為預設路徑。

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

模糊位置

若輸入的地區名稱無法直接確定為單一測站，proxy 會回傳 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=우산동(광주)'

詳細 API 路徑

類似原始 AirKorea 的直通路徑（/B552584/...）或直接 fallback 的詳細資訊，請參考以下文件：

• docs/features/fine-dust-location.md
• docs/features/k-skill-proxy.md

保持回答簡潔

回應中優先整理以下資訊：

• 測站
• 查詢時間
• PM10 數值與等級
• PM2.5 數值與等級
• 綜合空氣品質指數
• 查詢方式（fallback）

失敗模式

• regionHint 過於廣泛或無法確定單一測站
• 代理伺服器關閉或 upstream key 為空
• 測站名稱與地區名稱不同，需要直接 fallback

備註

• 預設路徑始終為 k-skill-proxy.nomadamas.org 的 report endpoint。
• 地區名稱查詢先取得候選，必要時以精確測站名稱重新查詢。
• 直通 / 直接 AirKorea 的實作細節不在技能本文中重複。
• 免費 API 代理預設使用公開 endpoint。