🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Hong Kong Urbix Events
πŸ¦€ ClawHub

Hong Kong Urbix Events

by @stevenho1394

Fetches and returns detailed Hong Kong URBTIX event performances by parsing natural language questions with date, venue, and event filters.

Versionv1.0.3
Downloads412
#clawhub
TERMINAL
clawhub install hk-urbtix-events

πŸ“– About This Skill

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.

    • Returns: A dictionary with:

  • answer: Human-readable answer in markdown table format (Time | Event | Venue | Ticket Link) or clarification message
  • matches: 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 URBTIX 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).

    • Version

    1.0.3 β€” Improved date filtering (performance-level), markdown table output format with ticket links, expanded stop words (events/event), bug fixes.

    πŸ“‹ Tips & Best Practices

  • Fetches from the official URBTIX cloud distribution endpoint (Tencent COS). The XML includes a URBTIX 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).