zkl2333/skills · Archived

caiyun-weather

Get weather data via Caiyun (彩云天气) API through MCP.

First seen Mar 3, 2026

Installation

$ npx skills add zkl2333/skills --skill caiyun-weather

Summary

  • 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).

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from zkl2333/skills.

npx skills add zkl2333/skills

Browse all from zkl2333/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1
License LICENSE.txt
Default branch main
Open issues 0
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,825 B
  • docs SUMMARY.md 419 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 32 installs

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": { "CAIYUNWEATHERAPITOKEN": "YOURCAIYUNAPITOKEN" } } ``

  • 需要彩云天气 API token(环境变量 CAIYUNWEATHERAPI_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 晴
PARTLYCLOUDYDAY/NIGHT 多云
CLOUDY 阴
LIGHT_RAIN 小雨
MODERATE_RAIN 中雨
HEAVY_RAIN 大雨
STORM_RAIN 暴雨
LIGHT_SNOW 小雪
MODERATE_SNOW 中雪
HEAVY_SNOW 大雪
STORM_SNOW 暴雪
FOG 雾
DUST/SAND/WIND 浮尘/沙尘/大风
HAZE 霾

使用建议

  • 心跳天气检查优先用 getrealtimeweather(一次调用,数据全面)
  • 需要判断是否带伞时用 gethourlyforecast 看未来几小时降水概率
  • 天气预警用 getweatheralerts,有预警时主动提醒用户
  • 彩云 API 有调用频率限制,避免短时间内重复请求