---
id: daily-fine-dust-location
name: "fine-dust-location"
url: https://skills.yangsir.net/skill/daily-fine-dust-location
author: nomadamas
domain: lifestyle
tags: ["air-quality", "environment", "korea", "health"]
install_count: 2200
rating: 4.30 (10 reviews)
github: https://github.com/nomadamas/k-skill
---

# fine-dust-location

> 查询韩国特定地区的实时空气质量指数，包括 PM10、PM2.5 浓度和综合大气等级

**Stats**: 2,200 installs · 4.3/5 (10 reviews)

## Before / After 对比

### 空气质量查询

**Before**:

访问韩国空气质量官网或APP，手动搜索地区名称，查找最近的监测站数据，理解 PM10/PM2.5 数值的含义，需要 3-5 分钟

**After**:

直接询问地区空气质量，5 秒返回当前位置的 PM2.5/PM10 浓度、综合等级和健康建议

| Metric | Before | After | Change |
|---|---|---|---|
| 查询时间 | 240秒 | 5秒 | -98% |

## Readme

# fine-dust-location

# 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 요청만 넣으면 된다.

```
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

```

## Ambiguous locations

입력한 지역명이 단일 측정소로 바로 확정되지 않으면 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=우산동(광주)'

```

## Detailed API paths

원본 AirKorea와 비슷한 passthrough 경로(`/B552584/...`)나 direct fallback 상세는 아래 문서만 참고한다.

- `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 를 기본으로 둔다.

Weekly Installs787Repository[nomadamas/k-skill](https://github.com/nomadamas/k-skill)GitHub Stars3.0KFirst SeenMar 28, 2026Security Audits[Gen Agent Trust HubPass](/nomadamas/k-skill/fine-dust-location/security/agent-trust-hub)[SocketWarn](/nomadamas/k-skill/fine-dust-location/security/socket)[SnykPass](/nomadamas/k-skill/fine-dust-location/security/snyk)Installed oncodex781antigravity780opencode778github-copilot778kimi-cli778amp778

---
*Source: https://skills.yangsir.net/skill/daily-fine-dust-location*
*Markdown mirror: https://skills.yangsir.net/api/skill/daily-fine-dust-location/markdown*