A comprehensive CLI wrapper for the official Korean AirKorea OpenAPI, providing real-time air quality metrics and 1-3 day forecasts.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install airkorea-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install airkorea-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is airkorea-cli?
airkorea-cli is a specialized command-line tool designed to interface with the Korea Environment Corporation's first-party air-quality system. As a key component of the Openclaw Skills library, it provides developers with direct access to the same regulator-curated data that powers major Korean weather applications and emergency alert systems. It abstracts the complexity of the data.go.kr OpenAPI, offering a suite of scripts to query pollutants like PM2.5, PM10, O3, NO2, CO, and SO2.
This skill is built for developers who need to ground their AI agents or applications in factual environmental data. By using these Openclaw Skills, you can programmatically retrieve hourly measurements, provincial snapshots, and geographic station information. The tool is particularly valuable for building localized services within South Korea, ensuring that air quality information is retrieved from official, high-fidelity monitoring stations rather than estimated global models.
airkorea-cli Use Cases
- Creating real-time AQI dashboards using province-wide snapshots.
- Implementing location-based health alerts and runner notifications based on specific station grades.
- Grounding AI agents with real-time Korean air quality data to prevent hallucinations in regional queries.
- Automating school outdoor-activity advisories using official 1-3 day forecasts.
- Performing environmental research by backfilling 90 days of station history for trend analysis.
How airkorea-cli Works
- The skill utilizes a user-provided API key from the Korean OpenData portal to authenticate requests.
- Subcommands map to specific endpoints such as realtime measurements, province-wide data, or weather forecasts.
- Geographic utilities allow for the conversion of administrative district names into TM coordinates.
- These coordinates are used to identify the nearest monitoring station for hyper-local accuracy.
- The skill processes the API response and emits JSONL data, making it ready for piping into other Openclaw Skills or data visualization tools.
airkorea-cli Setup
To use this skill, first register at data.go.kr and apply for the AirKorea services. Once approved, obtain your Decoding service key and configure your environment:
export AIRKOREA_SERVICE_KEY='your_decoded_key_here'
You can then run specific scripts to fetch data:
# Fetch latest reading for a specific station
scripts/realtime.sh --station 강남구 --period HOUR --num 1
airkorea-cli Data Schema & Taxonomy
The skill returns data in JSONL format, providing a structured approach to environmental metrics.
| Field | Description |
|---|---|
dataTime |
The timestamp of the measurement (hourly granularity) |
pm10Value / pm25Value |
Concentration of particulate matter (µg/m³) |
pm10Grade / pm25Grade |
Categorical grade from 1 (Good) to 4 (Very Bad) |
khaiValue |
Integrated Korea Air Quality Index value |
stationName |
The name of the specific monitoring station |
airkorea-cli Advanced Features
- Support for nationwide snapshots using the
--sido 전국parameter to get data from all stations in one call. - Proximity-based station discovery using TM coordinates for precise location mapping.
- Historical data retrieval capabilities allowing for up to 1000 records (approx. 90 days) per station.
- Seamless composability with other Openclaw Skills like juso-address-cli for address resolution and naver-papago-translate for localizing forecast strings.
SKILL.md
Loading
Related Openclaw Skills
Windows WeChat MCP
A robust UI automation skill for controlling the Windows desktop version of WeChat via AI agents.
Termux Persistent Gateway
A specialized persistence layer for running AI agent gateways on Android via Termux using tmux and wake-locks.
Gemini Browser Image
A browser-based automation skill that leverages your local Chrome session and Gemini AI to generate, manage, and download high-quality images via Openclaw Skills.
Auto-Reply - Multi-Platform Automation
A comprehensive automation skill for multi-platform auto-responses using keyword matching and AI-powered content generation.
OpenClaw Add Agent Skill
A specialized workflow for adding and configuring new Telegram bot agents to expand your agent ecosystem.
Wake-on-LAN (WOL)
A robust network utility for waking sleeping or suspended devices using magic packets and alias management via Openclaw Skills.
Featured*
