Hong Kong Urbix Events
Fetches and returns detailed Hong Kong URBTIX event performances by parsing natural language questions with date, venue, and event filters.
HK URBTIX Events Skill
Fetches upcoming event data from URBTIX (Hong Kong) and detects changes, filtering out noise.
Tools
queryEvents
Answers natural language questions about URBTIX events by parsing the query, fetching the appropriate batch XML, and returning matching performances. Handles date parsing (HK time), venue/name extraction, and validation.
Parameters:
question(required): Natural language question about events, e.g., "When is Medea showing?", "Where is 美狄亞 on April 8?", "What performances are on 2026-04-10?"force_refresh(optional): If true, ignore cached XML and re-download. Default: false.language(optional): Response language - "en" for English, "zh" for Traditional Chinese. Default: "en".
Returns: A dictionary with:
answer: Human-readable answer in markdown table format (Time | Event | Venue | Ticket Link) or clarification message in the requested languagematches: List of matching events (each with event_name_en, event_name_tc, venue, venue_tc, date, time, reference_link)clarification_needed: If unable to match, what additional info is needed
See README.md for full details.
Installation
Place the skill directory under your OpenClaw workspace skills/ and add "hk-urbtix-events" to the desired agent's skills array.
Notes
- Fetches from the official URBTIX cloud distribution endpoint (Tencent COS). The XML includes a
<SYSTEM>URBTIX</SYSTEM>marker that is verified upon download to ensure authenticity. - Respectful polling: Do not call more than once per hour without
force_refresh. - Caches daily batches in
$OPENCLAW_WORKSPACE/urbtix_cache/to reduce load. - No external dependencies (Python standard library only).
- Security: Downloads are validated with XML structure verification, source authenticity checks (SYSTEM tag), SEND_DATE matching, and TOTAL count verification. Rate limiting enforced per HK day. Temporary files used for atomic writes. Cache purging with optional verbose notification.
Version
1.0.4 — Security hardening: fixed dead code in download validation, corrected rate-limit logic, added language parameter (en/zh), cache purge notifications, timezone-aware datetime handling, atomic file writes.
Related skills
- Downloads
- 1.2kAll time
- Security audit
- Pass
- Last updated
- 2mo ago
- Current version
- v1.0.4
- License
- MIT-0
