Agent skill
caiyun-weather
Get weather data via Caiyun (彩云天气) API through MCP. Use when: user asks about weather, temperature, forecasts, air quality, or weather alerts for any location in China. Supports realtime, hourly (72h), daily (7d), historical (24h), and alerts. Triggers: '天气', 'weather', '气温', '空气质量', 'AQI', '降水', '预报'. NOT for: locations outside China (use weather skill instead).
Install this agent skill to your Project
npx add-skill https://github.com/zkl2333/skills/tree/main/skills/caiyun-weather
SKILL.md
彩云天气 Skill
通过 MCP server (caiyun-weather) 调用彩云天气 v2.6 API,获取高精度天气数据(1km 分辨率,分钟级降水预报)。
前置条件
-
在你的
mcporter.json里加入 server 配置(合并到mcpServers下即可):json"caiyun-weather": { "command": "uvx", "args": ["mcp-caiyun-weather"], "env": { "CAIYUN_WEATHER_API_TOKEN": "YOUR_CAIYUN_API_TOKEN" } } -
需要彩云天气 API token(环境变量
CAIYUN_WEATHER_API_TOKEN)
常用坐标
- 杭州萧山:
lng=120.26 lat=30.27
如需其他城市坐标,用 web_search 查询或从用户获取。
可用工具
通过 mcporter call 调用,所有工具参数均为 lng(经度)和 lat(纬度):
实时天气
mcporter call caiyun-weather.get_realtime_weather lng=120.26 lat=30.27
返回:温度、湿度、风速风向、降水强度、空气质量(PM2.5/PM10/O3/AQI)、生活指数(紫外线/舒适度)。
小时级预报(72h)
mcporter call caiyun-weather.get_hourly_forecast lng=120.26 lat=30.27
返回:逐小时温度、天气现象、降水概率、风速风向。
天级预报(7天)
mcporter call caiyun-weather.get_weekly_forecast lng=120.26 lat=30.27
返回:每日温度范围、天气现象、降水概率。
历史天气(24h)
mcporter call caiyun-weather.get_historical_weather lng=120.26 lat=30.27
天气预警
mcporter call caiyun-weather.get_weather_alerts lng=120.26 lat=30.27
返回:预警标题、代码、状态、描述。
天气现象代码(skycon)
| 代码 | 含义 |
|---|---|
| CLEAR_DAY/NIGHT | 晴 |
| PARTLY_CLOUDY_DAY/NIGHT | 多云 |
| CLOUDY | 阴 |
| LIGHT_RAIN | 小雨 |
| MODERATE_RAIN | 中雨 |
| HEAVY_RAIN | 大雨 |
| STORM_RAIN | 暴雨 |
| LIGHT_SNOW | 小雪 |
| MODERATE_SNOW | 中雪 |
| HEAVY_SNOW | 大雪 |
| STORM_SNOW | 暴雪 |
| FOG | 雾 |
| DUST/SAND/WIND | 浮尘/沙尘/大风 |
| HAZE | 霾 |
使用建议
- 心跳天气检查优先用
get_realtime_weather(一次调用,数据全面) - 需要判断是否带伞时用
get_hourly_forecast看未来几小时降水概率 - 天气预警用
get_weather_alerts,有预警时主动提醒用户 - 彩云 API 有调用频率限制,避免短时间内重复请求
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
zread
Search and read GitHub repository docs via the Zhipu CodePlan MCP zread server. Use when you need quick repo structure lookup or documentation search without cloning. Triggers: zread, search_doc, repo structure, read_file, GitHub docs search.
commit
Generate conventional commit messages following git-cz style by default (emoji between type and subject). Automatically detects project configuration when present. Use when creating git commit messages with Conventional Commits specification. See references/config-detection.md for supported configurations.
bark
Send Bark (day.app) push notifications via HTTP. Use when asked to push a short message/alert to iPhone/iPad via Bark/day.app, including scheduled digests and quick “push to phone” actions.
zai-mcp-server
Use Zhipu CodePlan MCP vision server for screenshot/UI understanding: OCR, error screenshot diagnosis, and UI→artifact conversion. Use when you need to analyze images, extract text, or turn UI into code/spec. Triggers: OCR, screenshot, 识图, 提取文字, diagnose error screenshot, ui_to_artifact.
amap-maps
高德地图 API(通过 MCP)。地理编码(地址↔坐标)、IP 定位、天气、POI 搜索、路线规划(骑行/步行/驾车/公交)、距离测量。Triggers: '高德', 'amap', '地理编码', 'geocoding', '经纬度', 'POI', '路线规划', '导航'. NOT for: 高德 JSAPI 前端开发(用 AMap-Web/amap-skills).
web-reader
Read and extract readable content from a URL via the Zhipu CodePlan MCP web-reader server. Use when you need to fetch and parse a web page into clean text/markdown, especially when browser automation is unnecessary. Triggers: web-reader, webReader, read webpage, extract article, fetch url.
Didn't find tool you were looking for?