Caiyun Weather

通过彩云天气 API 查询天气数据 — 实时天气、逐小时/一周预报、历史天气和天气预警。当用户询问任何城市的天气、温度、空气质量、天气预报、降雨概率、历史天气或天气预警时使用此技能。需要设置 CAIYUN_WEATHER_API_TOKEN 环境变量。Use when: user asks about curre...

Security Scan

The skill's requirements, instructions, and code align with a simple Caiyun weather client: it needs a Caiyun API token and python3 and makes network calls to Caiyun and a geocoding fallback (OpenStreetMap).

Purpose & Capability

Name/description (Caiyun weather) match the actual behavior. Requested binary (python3) and required env var (CAIYUN_WEATHER_API_TOKEN) are appropriate and expected for calling the Caiyun Weather API. No unrelated credentials, binaries, or config paths are requested.

Instruction Scope

SKILL.md directs the agent to run the included Python script which performs only weather-related operations. The script makes outbound HTTPS requests to Caiyun (API_BASE) and uses Nominatim/OpenStreetMap as a geocoding fallback; this is expected but means user queries and coordinates will be sent to those external services. The instructions do not attempt to read local files or other env vars beyond the declared token.

Install Mechanism

No install spec — instruction-only with an included Python script. No external installers or downloads are performed. This has minimal install risk; the only runtime requirement is python3 being present.

Credentials

Only CAIYUN_WEATHER_API_TOKEN is required and is used as the primary credential. That is proportionate for this skill. Note: the token is included in request URLs to the Caiyun API and will be sent over the network to the Caiyun service.

Persistence & Privilege

The skill does not request permanent/always presence and does not modify other skills or system-wide settings. Autonomous invocation is allowed (platform default) but not combined with any elevated privileges.

Assessment

This skill appears to do what it says: it runs a bundled Python script that calls Caiyun's API and, if needed, OpenStreetMap's Nominatim for geocoding. Before installing: (1) Be aware your queries/coordinates and the CAIYUN_WEATHER_API_TOKEN will be sent to Caiyun (token appears in the request URL) and geocoding queries go to OpenStreetMap—only install if you trust those services. (2) Store a token with least privilege and consider rotating it if leaked. (3) Watch rate limits and avoid frequent automated requests. (4) You can inspect the included script (scripts/caiyun_weather.py) — it contains no obfuscated code or hidden endpoints. If you need stronger privacy, avoid supplying precise coordinates or use a local/geolocation service you control.

彩云天气 (Caiyun Weather)

通过彩云天气 API 查询天气数据。支持直接使用城市名称（中文或英文），无需提供经纬度。

前置条件

使用前需设置环境变量：

export CAIYUN_WEATHER_API_TOKEN="你的API密钥"

免费申请 API 密钥：https://docs.caiyunapp.com/weather-api/

何时使用

✅ 使用此技能：

• "北京现在天气怎么样？"
• "上海明天会下雨吗？"
• "深圳未来一周天气预报"
• "广州空气质量如何？"
• "杭州过去24小时的天气"
• "成都有没有天气预警？"
• "What's the weather in Beijing?"
• 用户询问任何城市的天气、温度、空气质量、预报或预警

❌ 不要使用此技能：

• 气候趋势分析或长期历史数据
• 航空/航海专业气象（METAR、TAF）
• 用户未配置彩云天气 API Token

命令

使用 --city 加城市名称（中文或英文）。如需精确定位，可使用 --lng 和 --lat。

实时天气

python3 "{{skill_path}}/scripts/caiyun_weather.py" realtime --city "北京"

逐小时预报（72小时）

python3 "{{skill_path}}/scripts/caiyun_weather.py" hourly --city "上海"

一周预报（7天）

python3 "{{skill_path}}/scripts/caiyun_weather.py" weekly --city "深圳"

历史天气（过去24小时）

python3 "{{skill_path}}/scripts/caiyun_weather.py" history --city "杭州"

天气预警

python3 "{{skill_path}}/scripts/caiyun_weather.py" alerts --city "成都"

使用坐标（可选）

对于无法通过城市名识别的地点：

python3 "{{skill_path}}/scripts/caiyun_weather.py" realtime --lng 116.4074 --lat 39.9042

内置城市（即时查询）

北京、上海、广州、深圳、杭州、成都、武汉、南京、重庆、西安、天津、苏州、郑州、长沙、青岛、大连、厦门、昆明、贵阳、哈尔滨、沈阳、长春、福州、合肥、济南、南昌、石家庄、太原、呼和浩特、南宁、海口、三亚、拉萨、乌鲁木齐、兰州、西宁、银川、香港、澳门、台北、珠海、东莞、佛山、无锡、宁波、温州

英文名和其他全球城市通过在线地理编码自动解析。

说明

• 脚本仅使用 Python 标准库，无需 pip 安装
• 内置城市即时解析，其他城市通过 OpenStreetMap 地理编码
• API 对中国地区数据最为精准
• 有频率限制，请避免短时间内频繁请求