Fine Dust Location
Query Korean AirKorea-backed PM10, PM2.5, and air grade summaries by region hint or station name through the k-skill-proxy report API.
Overview
fine-dust-location is an agent skill for the Build phase that fetches PM10, PM2.5, and integrated air grades for Korean regions via the k-skill-proxy report endpoint.
Install
npx skills add https://github.com/nomadamas/k-skill --skill fine-dust-locationWhat is this skill?
- Default HTTP path to k-skill-proxy /v1/fine-dust/report with regionHint or stationName parameters
- Korean administrative naming guidance (e.g., 강남구, 서울 강남구) with most-specific token preference
- Handles ambiguous_location responses with candidate_stations and follow-up stationName queries
- Optional python3 scripts/fine_dust.py helper mirroring the same report endpoint with --json output
Adoption & trust: 2.6k installs on skills.sh; 5.4k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You want live fine-dust answers for Korean locations but do not know the proxy URL, region naming rules, or how to resolve ambiguous station matches.
Who is it for?
Indie builders shipping Korean-language agents, automations, or scripts that need quick PM10/PM2.5 lookups without building AirKorea plumbing.
Skip if: Global air-quality products, offline-only workflows, or teams that cannot send region hints to a third-party proxy endpoint.
When should I use this skill?
User asks about current fine dust or ultrafine dust for a Korean region, location hint, or named measurement station.
What do I get? / Deliverables
You get a summarized air-quality report for a resolved station or a structured candidate list to complete a second precise query.
- PM10/PM2.5 and integrated grade summary JSON from report endpoint
- Disambiguation steps with chosen stationName when location is ambiguous
Recommended Skills
Journey fit
Canonical placement is Build because the skill wires HTTP integration patterns agents copy into automations and assistants. Integrations reflects external API calls, curl examples, and disambiguation flows for location-based environmental data.
How it compares
Thin HTTP integration skill—not an MCP server—optimized for curl and a small Python helper over one report route.
Common Questions / FAQ
Who is fine-dust-location for?
Solo builders and agent authors targeting Korea who need 미세먼지/초미세먼지 answers tied to 행정구역 or station names.
When should I use fine-dust-location?
During Build when wiring assistant or automation integrations for prompts like current location air quality, Gangnam PM2.5, or whether the air is okay here.
Is fine-dust-location safe to install?
Review Security Audits on this page; the skill calls an external proxy and sends location hints, so confirm trust and data handling before production use.
SKILL.md
READMESKILL.md - 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 요청만 넣으면 된다. ```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 응답에는 아래만 먼저 정리한다. - 측정소 - 조회 시각 - PM10 값과 등급 - PM2.5 값과 등급 - 통합대기등급 - 조회 방식(`fallback`) ## Failure modes - regionHint 가 너무 넓거나 단일 측정소를 확정할 수 없는 경우 - 프록시 서버가 내려가 있거나 upstream key가 비어 있는 경우 - 측정소명과 지역명이 달라 직접 fallback 이 필요한 경우 ## Notes - 기본 경로는 항상 `k-skill-proxy.nomadamas.org` 의 report endpoint 다. - 지역명 조회는 먼저 후보를 얻고, 필요하면 정확한 측정소명으로 재조회한다. - passthrough / direct AirKorea 구현 세부는 스킬 본문에 길게 반복하지 않는다. - free API 프록시는 공개 endpoint 를 기본으로 둔다.