1
---
2
name: weather-skill
3
description: 通过高德地图 API 查询指定城市的实时天气信息
4
license: Apache-2.0
5
metadata:
6
  author: zhoupb
7
  version: "1.0.0"
8
---
9

10
# 城市天气查询技能
11

12
## 功能描述
13

14
查询指定城市的实时天气信息，包括温度、天气状况、风力风向等。
15

16
## 使用方式
17

18
直接描述你要查询的天气，例如：
19
- "[城市]天气怎么样"
20
- "[城市]今天的天气"
21
- "[城市]现在多少度"
22

23
## 环境变量
24

25
使用前请设置高德 API Key：
26

27
​```bash
28
export AMAP_MAPS_API_KEY=your_api_key
29
​```
30

31
## 安装依赖
32

33
​```bash
34
pip install -r requirements.txt
35
​```
36

37
## 使用方法
38

39
​```bash
40
python weather.py [城市]
41
​```
42

43
## 示例输出
44

45
​```
46
北京天气：晴
47
温度：15°C
48
风力：3 级 北风
49
湿度：45%
50
发布时间：2026-03-03 10:00:00
51
​```
52

53
## API 说明
54

55
使用高德地图天气 API：
56
- **城市查询 API**: `https://restapi.amap.com/v3/config/district`
57
- **天气查询 API**: `https://restapi.amap.com/v3/weather/weatherInfo`
58

59
## 获取 API Key
60

61
访问 [高德开放平台](https://console.amap.com/dev/index) 申请 Web 服务 API Key。

1
#!/usr/bin/env python3
2
"""城市天气查询 - 使用高德 API"""
3

4
import os
5
import sys
6
import requests
7

8

9
def get_city_code(city_name: str, api_key: str) -> str | None:
10
    """根据城市名获取城市 code"""
11
    url = "https://restapi.amap.com/v3/config/district"
12
    params = {
13
        "key": api_key,
14
        "keywords": city_name,
15
        "subdistrict": 0,
16
    }
17
    resp = requests.get(url, params=params, timeout=5)
18
    resp.raise_for_status()
19
    data = resp.json()
20

21
    if data.get("status") == "1" and data.get("districts"):
22
        return data["districts"][0]["adcode"]
23
    return None
24

25

26
def query_weather(city_code: str, api_key: str) -> dict | None:
27
    """查询城市天气"""
28
    url = "https://restapi.amap.com/v3/weather/weatherInfo"
29
    params = {
30
        "key": api_key,
31
        "city": city_code,
32
        "extensions": "base",
33
    }
34
    resp = requests.get(url, params=params, timeout=5)
35
    resp.raise_for_status()
36
    data = resp.json()
37

38
    if data.get("status") == "1" and data.get("lives"):
39
        return data["lives"][0]
40
    return None
41

42

43
def main():
44
    if len(sys.argv) < 2:
45
        print("用法：python weather.py <城市名>")
46
        print("示例：python weather.py 北京")
47
        sys.exit(1)
48

49
    city_name = sys.argv[1]
50
    api_key = os.environ.get("AMAP_MAPS_API_KEY")
51

52
    if not api_key:
53
        print("错误：请设置环境变量 AMAP_MAPS_API_KEY")
54
        sys.exit(1)
55

56
    city_code = get_city_code(city_name, api_key)
57
    if not city_code:
58
        print(f"未找到城市：{city_name}")
59
        sys.exit(1)
60

61
    weather = query_weather(city_code, api_key)
62
    if not weather:
63
        print(f"无法获取 {city_name} 的天气信息")
64
        sys.exit(1)
65

66
    print(f"{weather['city']}天气：{weather['weather']}")
67
    print(f"温度：{weather['temperature']}°C")
68
    print(f"风力：{weather['windpower']} {weather['winddirection']}风")
69
    print(f"湿度：{weather['humidity']}%")
70
    print(f"发布时间：{weather['reporttime']}")
71

72

73
if __name__ == "__main__":
74
    main()