核心功能
IQAir Air Quality Checker 是一款基于 IQAir 官方 API 的空气质量查询工具，支持通过城市名、地理坐标或 IP 定位三种方式获取实时 AQI（空气质量指数）数据。工具返回格式化的输出结果，包含彩色 emoji 指示器、具体 AQI 数值、质量等级及地理位置信息，便于用户快速理解当前空气状况。
显著优点
1. 多维度查询能力：支持城市名（如 Riga Latvia）、精确坐标（--lat/--lon）以及基于 IP 的最近城市定位（--nearest），覆盖全球绝大多数地区
2. 直观的健康指引：输出附带 WHO 标准 AQI 分级（🟢 Good 至 🟤 Hazardous）及对应的健康建议，帮助不同敏感人群（儿童、呼吸道疾病患者等）做出合理的户外活动决策
3. 零成本接入：基于 IQAir 免费 Community 计划，个人用户无需付费即可使用
4. 响应式交互设计：针对用户自然语言查询（如"北京今天能出门吗"）提供结构化响应流程，降低使用门槛
潜在局限
1. 严格的调用限制：免费套餐仅支持 5 次/分钟、500 次/天、10,000 次/月，高频场景（如自动化监测）需升级付费计划
2. 地理位置歧义：部分城市名称需精确匹配 IQAir 数据库格式，同名城市或行政区划复杂地区（如纽约州纽约市）需要额外指定州/省参数
3. 依赖外部 API：实时数据完全依赖 IQAir 服务端，网络波动或服务中断将影响可用性
4. 环境变量配置门槛：需用户自行注册获取 API Key 并配置环境变量，对非技术用户存在学习成本
适合人群
- 敏感体质人群（哮喘、过敏患者）及儿童家长
- 户外运动爱好者、马拉松/骑行等群体
- 跨国差旅人士、数字游民
- 对空气质量有基础关注的一般用户
常规风险
- API Key 泄露风险：若
IQAIR_API_KEY暴露在公共代码仓库或共享环境中，可能被恶意盗用导致配额耗尽 - 数据时效性：AQI 为实时监测值，突发污染事件（如沙尘暴、工业泄漏）可能存在 30 分钟至数小时的滞后
- 健康建议局限性：AQI 为综合指数，未细分具体污染物（PM2.5/PM10/O₃ 等）浓度，特殊健康需求者建议结合专业医疗建议