iqair-airvisual-automation

IQAir AirVisual 自动化技能

技能概述

通过 Rube MCP 和 Composio 工具包自动化 IQAir AirVisual 操作，轻松集成空气质量数据到你的项目中。

适用场景

空气质量监控项目集成

需要在应用或网站中展示实时空气质量数据时，使用此技能可以自动获取 PM2.5、PM10、AQI 等关键指标，无需手动调用 API。

环境数据自动化采集

定期批量获取多个城市的空气质量监测数据，用于数据分析、报表生成或历史趋势追踪，支持会话复用和分页处理。

智能硬件与环境系统集成

在智能家居或环境监测系统中集成空气质量数据，当污染超标时自动触发预警或联动其他设备。

核心功能

动态工具发现与 Schema 获取

通过 RUBE_SEARCH_TOOLS 实时获取当前可用的 IQAir 工具列表和参数规范，避免硬编码过期的 API 定义，确保与最新的工具集兼容。

连接管理与状态监控

使用 RUBE_MANAGE_CONNECTIONS 管理 IQAir AirVisual 连接状态，自动检测连接是否激活，并在连接失效时提供重新认证指引。

灵活工具执行与会话管理

通过 RUBE_MULTI_EXECUTE_TOOL 执行单个或批量空气质量查询操作，支持会话 ID 复用、分页数据获取和 memory 参数传递。

常见问题

如何开始使用这个技能？

首先需要将 https://rube.app/mcp 添加为 MCP 服务器。然后调用 RUBE_SEARCH_TOOLS 确认服务可用，再通过 RUBE_MANAGE_CONNECTIONS 激活 iqair_airvisual 工具包连接。完成连接激活后即可执行具体的空气质量查询任务。

为什么要先调用 RUBE_SEARCH_TOOLS 而不是直接执行工具？

IQAir AirVisual 的工具 schema 会随时更新。如果硬编码工具 slug 和参数，可能导致调用失败。RUBE_SEARCH_TOOLS 会返回当前最新的可用工具列表、输入 schema 和推荐的执行计划，避免因 schema 变化导致的错误。

如何验证 IQAir 连接是否成功？

调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit 为 iqair_airvisual，检查返回的连接状态。如果状态不是 ACTIVE，需要按照返回的认证链接完成授权流程，直到状态显示为 ACTIVE 后才能正常执行工具操作。