China Travel Group Bus Query for Openclaw

A cross-border bus schedule and ticket status querying agent skill tailored for the China Travel Group (hkctgbus) network.

porridgec
v1.0.0
May 30, 2026
0
664
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install ctg-bus

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install ctg-bus using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is China Travel Group Bus Query?

The ctg-bus skill is an advanced automation tool designed to interact directly with the China Travel Group (hkctgbus) web interface to check route availability, ticket prices, and seating capacity in real-time. As part of the Openclaw Skills ecosystem, it seamlessly parses natural language inputs in Chinese to extract relative dates, departure and arrival locations, and specific boarding terminals across major cities in the Greater Bay Area, including Hong Kong, Macau, Shenzhen, Guangzhou, and Zhuhai.

By leveraging this integration, users can instantly determine optimal routes and schedule departures without manual form-filling on mobile portals. Integrating Openclaw Skills like ctg-bus empowers local commuters and cross-border business travelers to receive immediate, structured schedules directly inside their AI agent workflow.

China Travel Group Bus Query Use Cases

  • Plan daily or weekly cross-border commutes between Hong Kong and mainland China cities with real-time seat tracking.
  • Check next-day or weekend departures dynamically using relative dates like 'tomorrow' or 'day after tomorrow' in natural conversations.
  • Inspect specific terminal options such as Mong Kok Metropark Hotel, Prince Edward, or Shenzhen Bay Port to select the most convenient boarding and drop-off points.

How China Travel Group Bus Query Works

  1. The user inputs a query in natural language containing keywords like '中旅', 'hkctgbus', or '跨境巴士' (e.g., 'Check CTG bus to Zhuhai tomorrow').
  2. The skill parses the text to identify key parameters: target date, origin city, destination city, and optional specific bus stations.
  3. It resolves the natural language dates (e.g., 'tomorrow' becomes a YYYY-MM-DD string) and maps city names to official geographic system codes and CityNo values.
  4. The integrated Node.js script issues a query to the official hkctgbus WeChat mini-program endpoint (wechat.hkctgbus.com/ctb) without requiring user credentials.
  5. The skill processes the raw JSON response containing routes, prices in HKD/RMB, and seat availability, and formats them into a clean, easy-to-read list for the user.

China Travel Group Bus Query Setup

To install and configure this skill within your Openclaw Skills workspace, follow these steps:

  1. Ensure you have Node.js installed in your execution environment.
  2. Navigate to your skill directory and locate the Node.js querying script:
# Navigate to your skill path
cd path/to/openclaw/skills/ctg-bus

# Run the query script manually to verify setup
node scripts/ctg_bus_query.js 2026-05-30 "香港" "深圳" "旺角维景酒店" "深圳湾口岸"
  1. Ensure your AI agent environment has outbound network access to the API target host.

China Travel Group Bus Query Data Schema & Taxonomy

Supported Cities & Mapping Taxonomy

City (Chinese) Code CityNo
香港 (Hong Kong) 810000 G1095
澳門 (Macau) 820000 K1146
深圳 (Shenzhen) 440300 K1096
廣州 (Guangzhou) 440100 N1097
珠海 (Zhuhai) 440400 K1121
佛山 (Foshan) 440600 N1131
江門 (Jiangmen) 440700 N1133
中山 (Zhongshan) 442000 N1135
東莞 (Dongguan) 441900 N1105
肇慶 (Zhaoqing) 441200 N1137

Formatted Execution Schema

The query results returned by the script organize ticket details, price currencies, and terminal route lists according to the following layout:

  • Header: Departure & arrival terminals, target date, and ticket prices (HKD & RMB).
  • Grid Data: Departure time, transit/via terminals, remaining seats, and bus schedule identifiers.

China Travel Group Bus Query Advanced Features

  • Dynamic Station Resolution: If a user enters a station not specified in the static list, the skill performs a real-time API query to dynamically identify matching bus terminals.
  • Bilingual Station Mapping: Supports robust keyword matching across simplified and traditional Chinese characters to accommodate variations in terminal naming.
  • Route Transit Breakdown: Extracts complete stop details via the ViaStations data field to show all intermediate stops of the bus journey.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*