Hong Kong Weather (v1.0.0)#

Get real-time weather, warnings, and forecasts from the Hong Kong Observatory (HKO) official open data API. Zero dependencies, zero API keys.

Output Policy (Safe & ClawHub-friendly)#

• Prefer script output as reply basis.
• Allow minimal formatting cleanup for readability.
• Never fabricate weather data. If API fails, show exact error.
• Keep output concise. No lengthy explanations.

Safety & Scope (for Security Scan)#

• Allowed commands only:

  • python3 scripts/hk_weather.py current [tc|en]
  • python3 scripts/hk_weather.py warning [tc|en]
  • python3 scripts/hk_weather.py forecast [tc|en]
  • python3 scripts/hk_weather.py all [tc|en]

• Network scope (allowlist):

  • https://data.weather.gov.hk/*

• Write scope (skill-local only):

  • scripts/__pycache__/

• No secrets. No credentials. No config files.

Language Handling#

• Chinese query → tc: When user asks in Chinese/Cantonese, use python3 scripts/hk_weather.py current tc
• English/non-Chinese query → en: When user asks in English, use python3 scripts/hk_weather.py current en
• Default to tc if language is unclear (Hong Kong primary language)

Usage#

Current Weather#

Real-time temperature, humidity, rainfall, UV index, and conditions.

bash

# Chinese output (default for HK)
python3 scripts/hk_weather.py current tc

# English output
python3 scripts/hk_weather.py current en

Weather Warnings#

Check active warnings (typhoon, rainstorm, thunderstorm, etc.).

bash

python3 scripts/hk_weather.py warning tc
python3 scripts/hk_weather.py warning en

9-Day Forecast#

Extended forecast with temperature range, humidity, and rain probability.

bash

python3 scripts/hk_weather.py forecast tc
python3 scripts/hk_weather.py forecast en

All-in-One#

Combined current + warnings + forecast (first 3 days).

bash

python3 scripts/hk_weather.py all tc
python3 scripts/hk_weather.py all en

Examples#

"今天香港天氣點？"

bash

python3 scripts/hk_weather.py current tc

"What's the weather in Hong Kong?"

bash

python3 scripts/hk_weather.py current en

"有冇暴雨警告？"

bash

python3 scripts/hk_weather.py warning tc

"Forecast for the week"

bash

python3 scripts/hk_weather.py forecast en

"香港天氣點？有冇警告？未來幾日預報？"

bash

python3 scripts/hk_weather.py all tc

Notes#

• Data source: Hong Kong Observatory Open Data API (data.weather.gov.hk)
• No API key required
• Response time: typically 2-5 seconds
• When no warnings are active, the warning command returns "No active weather warnings" / "現時無生效天氣警告"