fine-dust-location

按位置查询细颗粒物

技能功能

默认向 https://k-skill-proxy.nomadamas.org/v1/fine-dust/report 发送请求，汇总PM10 / PM2.5 / 综合空气质量等级。

使用场景

• "现在我的位置空气质量怎么样？"
• "告诉我江南那边的超细颗粒物数值。"
• "这里的空气质量好吗？"

输入

• 常规输入：区域名称/行政区划提示
• 重新查询输入：准确的监测站名称

区域命名规范

区域名称优先使用接近监测站名称的韩语行政区划名称，如下所示。

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

当输入多个令牌时，helper/proxy通常优先考虑最具体的令牌。例如：서울 강남구 → 강남구。

默认路径

无需额外的客户端API层。只需向代理服务器发送HTTP请求即可。

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

脚本helper也使用相同的report端点作为默认路径。

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

模糊位置

如果输入的区域名称无法直接确定单个监测站，代理将返回 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/...）或直接回退的详细信息，请参考以下文档。

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

保持回答简洁

响应中首先整理以下内容。

• 监测站
• 查询时间
• PM10数值和等级
• PM2.5数值和等级
• 综合空气质量等级
• 查询方式（fallback）

失败模式

• regionHint过于宽泛或无法确定单个监测站
• 代理服务器宕机或上游密钥为空
• 监测站名称与区域名称不同，需要直接回退

备注

• 默认路径始终是 k-skill-proxy.nomadamas.org 的report端点。
• 区域名称查询首先获取候选，必要时使用准确的监测站名称重新查询。
• 直通/直接AirKorea实现细节不在技能正文中重复。
• 免费API代理默认使用公共端点。