- name
- hk-weather
- description
- Hong Kong weather information from the Hong Kong Observatory (HKO) official open data API. Use when: user asks about Hong Kong weather, temperature, rainfall, UV index, weather warnings (typhoon, rainstorm, thunderstorm), or 9-day forecast. NOT for: global weather, historical climate data, or non-HK locations. Supports Traditional Chinese and English output. No API key needed.
- metadata
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, usepython3 scripts/hk_weather.py current tc - English/non-Chinese query →
en: When user asks in English, usepython3 scripts/hk_weather.py current en - Default to
tcif language is unclear (Hong Kong primary language)
Usage
Current Weather
Real-time temperature, humidity, rainfall, UV index, and conditions.
# Chinese output (default for HK)
python3 scripts/hk_weather.py current tc
# English output
python3 scripts/hk_weather.py current enWeather Warnings
Check active warnings (typhoon, rainstorm, thunderstorm, etc.).
python3 scripts/hk_weather.py warning tc
python3 scripts/hk_weather.py warning en9-Day Forecast
Extended forecast with temperature range, humidity, and rain probability.
python3 scripts/hk_weather.py forecast tc
python3 scripts/hk_weather.py forecast enAll-in-One
Combined current + warnings + forecast (first 3 days).
python3 scripts/hk_weather.py all tc
python3 scripts/hk_weather.py all enExamples
"今天香港天氣點？"
python3 scripts/hk_weather.py current tc"What's the weather in Hong Kong?"
python3 scripts/hk_weather.py current en"有冇暴雨警告？"
python3 scripts/hk_weather.py warning tc"Forecast for the week"
python3 scripts/hk_weather.py forecast en"香港天氣點？有冇警告？未來幾日預報？"
python3 scripts/hk_weather.py all tcNotes
- 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" / "現時無生效天氣警告"