KMB and LWB Bus Arrivals

Get real-time KMB bus arrival times by route, direction, and stop using the official API for accurate next bus ETAs.

Security Scan

The skill's code, instructions, and requirements are consistent with a simple KMB arrivals client that calls the official data.etabus.gov.hk API and does not request credentials or persistent privileges.

Purpose & Capability

Name/description (KMB bus arrivals) match what the code and SKILL.md do: they call the official Hong Kong Data Hub endpoints to list routes, stops, and ETAs. No unrelated credentials, binaries, or config paths are requested.

Instruction Scope

Runtime instructions simply invoke the bundled Python script with explicit arguments. The script only performs network calls to data.etabus.gov.hk and does not read credentials, arbitrary files, or send data to other endpoints. Error handling and timeouts are present.

Install Mechanism

No install spec — instruction-only skill with a pure-Python script (standard library). Nothing is downloaded or extracted at install time.

Credentials

No environment variables or secrets are required. The network access requested (the official KMB data API host) is proportional to the stated purpose.

Persistence & Privilege

always is false and the skill does not request system-wide configuration changes or persistent credentials. It does not modify other skills or agent settings.

Assessment

This package appears coherent and limited to fetching KMB data from the official data.etabus.gov.hk API. Before installing, confirm you trust the included code (kmb_bus.py) and the publisher since the registry metadata lacks a homepage; review the rest of the script (the file was truncated in the provided bundle summary) to be certain there are no unexpected network calls or file operations. Also ensure your environment allows outbound HTTPS to data.etabus.gov.hk and be aware this version intentionally removes caching (it will make fresh API calls each invocation).

---

name: kmb-bus-arrival description: Retrieve real-time KMB bus arrival information. getNextArrivals returns plain text; other tools return JSON. version: 1.1.7 author: Steven Ho repository: https://github.com/StevenHo1394/kmb-bus-arrival tools:

• name: getRouteDirection description: List available travel directions for a KMB route. Returns JSON. command: python3 kmb_bus.py getRouteDirection {route} inputSchema: type: object required: [route] properties: route: type: string output: format: json

• name: getRouteInfo description: Get the list of stops for a route with sequence numbers. Returns JSON. command: python3 kmb_bus.py getRouteInfo {route} {direction} inputSchema: type: object required: [route, direction] properties: route: type: string direction: type: string enum: ["outbound", "inbound"] output: format: json

• name: getBusStopID description: Find bus stop ID(s) by name (Chinese or English). Returns JSON. command: python3 kmb_bus.py getBusStopID {name} inputSchema: type: object required: [name] properties: name: type: string output: format: json

• name: getNextArrivals description: Get the next bus arrival times for a specific route/direction/stop. Returns plain text. command: python3 kmb_bus.py getNextArrivals {route} {direction} {stopId} inputSchema: type: object required: [route, direction, stopId] properties: route: type: string direction: type: string enum: ["outbound", "inbound", "auto"] stopId: type: string output: format: text

Implementation:

• getNextArrivals output:

  *Route (To Destination)*
  
  Stop: *Human Readable Stop Name*
  
  Next arrivals:
  - HH:MM HKT
  - HH:MM HKT
  

  If direction="auto" and the stop is served in both directions, multiple blocks are printed.

• Auto-direction: direction="auto" tries both inbound and outbound; reports whichever has the stop. If both, both are shown.

• Alternate stop ID fallback: If the given stop ID is not found on the route, the skill searches the route's stop list for a stop whose Chinese or English name matches the intended location and uses that stop's ID instead.

• All tools except getNextArrivals return JSON.

• Errors: getNextArrivals prints human-readable messages; other tools return JSON with an error field.

version: 1.1.7 changes:

• Full removal of caching — all API calls are fresh
• Plain-text errors for getNextArrivals; JSON errors for other tools
• Auto-direction and alternate stop ID fallback retained
• Docs aligned with code