Taiwan Weather

taiwan-weather

用 Open-Meteo 的免費 API 查台灣各地天氣。免 API 金鑰、免登入，curl 即可。

定位:免金鑰的立即備援。 有 CWA 授權碼時，正式預報請優先用 cwa-weather 技能（官方資料）;本技能適合手邊沒有金鑰、只要快速概況時使用。

資料來源是 Open-Meteo 的國際氣象模式，不是中央氣象署（CWA）。 颱風動態、豪雨特報、各種警報與正式預報，請一律以中央氣象署 https://www.cwa.gov.tw 為準。

基本流程

1. 決定地點的經緯度
2. 呼叫 forecast API
3. 解讀天氣代碼與數值

1. 全台 22 縣市座標

2026-09-09 以 Open-Meteo 地理編碼 API 逐一確認（注意:該 API 只認英文/拼音地名，中文地名查不到;下表座標是用英文名稱查得）:

表裡沒有的地點，用免金鑰的地理編碼 API 查，name 請用英文或拼音（例:Hengchun、Lugang）:

curl -sm 30 'https://geocoding-api.open-meteo.com/v1/search?name=<英文地名>&count=5&country_code=TW'

2026-09-09 實測:中文地名（「台北市」「嘉義」「墾丁」等）在此 API 一律查無結果;英文地名也要注意同名地點（Nantou 會先命中中國廣東，Kenting 不在庫），務必確認回傳的 country_code 是 TW、admin1 合理再使用。查不到或對不上時，不要猜座標，改用 cwa-weather（需金鑰）或請使用者確認中央氣象署預報。

2. 查詢

# 現在天氣(以台北市為例)
curl -sm 30 'https://api.open-meteo.com/v1/forecast?latitude=25.053&longitude=121.526&current=temperature_2m,relative_humidity_2m,precipitation,weather_code,wind_speed_10m&timezone=Asia%2FTaipei'

# 未來 3 天預報
curl -sm 30 'https://api.open-meteo.com/v1/forecast?latitude=25.053&longitude=121.526&daily=weather_code,temperature_2m_max,temperature_2m_min,precipitation_probability_max&forecast_days=3&timezone=Asia%2FTaipei'

2026-09-09 實測:HTTP 200,current 回傳溫度、濕度、降水量、天氣代碼，時間為 Asia/Taipei 當地時間。回報時附上回傳的 time 欄位。

3. 天氣代碼（WMO）對照

錯誤與失敗時的處理

• 連線逾時 / 5xx:curl 一律加 -m 30，重試 1~2 次;仍失敗就告知 Open-Meteo 暫時異常，正式預報請看中央氣象署。不要編造天氣。
• 回傳不是 JSON 或缺 current/daily:視為失敗，不要用舊資料冒充。
• 座標不在台灣:確認 country_code=TW 的地理編碼結果，回傳的 name 與使用者問的地點不符時，先回報找到的地名再給天氣。中文地名在地理編碼 API 查不到是已知限制，改用英文/拼音，仍查不到就照上一節指示降級，不要自行估座標。
• 颱風、警報相關問題:本技能不提供。直接請使用者看中央氣象署或下載中央氣象署 App。

災害警報與速報（NCDR CAP,免金鑰）

Open-Meteo 本身沒有警報資料。台灣的颱風、地震、海嘯等災害警報可以用國家災害防救科技中心（NCDR）的 CAP 公開 feed 查,官方來源、免金鑰、免登入:

curl -sm 30 'https://alerts.ncdr.nat.gov.tw/RssAtomFeed.ashx?AlertType=5' -o /tmp/typhoon.xml

URL 形式為 https://alerts.ncdr.nat.gov.tw/RssAtomFeed.ashx?AlertType=<類型代碼>。類型代碼（2026-09-09 逐一實測）:

1~4 回「存取檔案有誤」（不存在或未開放）。feed 是 Atom + CAP 格式:每則 entry 有 <title>（類型）、<updated>、<summary>（警報全文）、<cap:expires> 等;無有效警報時 feed 仍在但筆數少,近期已解除的警報也會留著,回報前先確認發布時間與 expires,過期的警報不要當現況。

# 列出颱風 feed 裡每則警報的標題與更新時間
python3 - <<'PY2'
import re
h = open('/tmp/typhoon.xml', encoding='utf-8').read()
for e in re.findall(r'<entry>(.*?)</entry>', h, re.S):
    t = re.search(r'<title>([^<]*)</title>', e)
    u = re.search(r'<updated>([^<]*)</updated>', e)
    x = re.search(r'<cap:expires>([^<]*)</cap:expires>', e)
    print(t.group(1) if t else '?', '|', u.group(1) if u else '?', '| expires:', x.group(1) if x else '-')
PY2

速率限制:連續請求間隔至少 3 秒,否則回 429 限制存取間隔時間為3秒（2026-09-09 實測）。一次查多種類型時逐個加 sleep。正式警報內容仍以中央氣象署公告為準;這個 feed 是 NCDR 彙整各機關（氣象署、水利署等）的 CAP 警報。

Open-Meteo（本技能）vs CWA（cwa-weather）怎麼選

English summary

Current weather and forecasts for 22 Taiwan counties via the keyless Open-Meteo API (curl only) - the fallback when no CWA API key is at hand; for official forecasts prefer cwa-weather. Disaster alerts (typhoon, earthquake, tsunami, flood, debris flow, rainfall, high river levels) are available keyless via the NCDR CAP Atom feeds at alerts.ncdr.nat.gov.tw - AlertType 5/6/7/8/9/10/11 respectively (types 1-4 do not exist); respect the 3-second rate limit (429 otherwise) and always check each entry's updated/expires before reporting an alert as current. The geocoding API only accepts English/pinyin names; verify country_code=TW before using coordinates.