A specialized transit skill for real-time and scheduled TPER bus arrival data in Bologna and Ferrara.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tper-hellobus-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tper-hellobus-skill 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 TPER Hellobus?
This skill integrates the TPER Hellobus API into your AI workflow, allowing for instant retrieval of bus schedules and live GPS tracking for public transit in Bologna and Ferrara, Italy. By leveraging Openclaw Skills, developers and users can automate transit queries using stop codes and line numbers to receive precise arrival predictions and accessibility information. It acts as a bridge between the official TPER infrastructure and AI agents, providing a seamless way to navigate Italian city transit through natural language.
TPER Hellobus Use Cases
- Checking real-time bus arrivals at a specific stop in Bologna or Ferrara using Openclaw Skills.
- Planning departures by querying scheduled bus times for a specific time of day.
- Verifying if upcoming buses are equipped with wheelchair-accessible platforms (CON PEDANA).
- Tracking specific bus lines across the TPER network to optimize daily commutes.
- Automating travel alerts by monitoring stop codes like 4476 or 8001.
How TPER Hellobus Works
- The agent identifies TPER-related queries containing numeric stop codes and line numbers.
- It parses natural language time inputs (e.g., "3 PM") and converts them into the required HHmm format using the Europe/Rome timezone.
- The skill executes a curl command via the bash tool to the TPER Hellobus API endpoint, as standard web fetch tools may have URL restrictions.
- If the time parameter is empty, the API provides DaSatellite real-time GPS data; otherwise, it returns scheduled times from the static timetable.
- The raw text response is parsed into a structured, readable bulleted list for the user, highlighting bus variants and arrival times.
TPER Hellobus Setup
To use this within your Openclaw Skills environment, ensure your agent has access to the bash tool for making external API requests. No API keys are required for the public Hellobus endpoint. You can test the connection manually using the following command structure:
curl "https://hellobuswsweb.tper.it/web-services/hellobus.asmx/QueryHellobus?fermata=4476&linea=11&oraHHMM="
TPER Hellobus Data Schema & Taxonomy
The skill processes simple numeric inputs and returns semi-structured text. Data is organized as follows:
| Field | Type | Description |
|---|---|---|
| fermata | String (Numeric) | 4 or 5-digit bus stop code required by the TPER network. |
| linea | String (Numeric) | Bus line number (e.g., 11, 27, 101). |
| oraHHMM | String (Optional) | 24-hour time format without colons for scheduled queries. |
| Response | Text | Contains line variant, arrival time, and bus ID (e.g., Bus1634). |
TPER Hellobus Advanced Features
- Support for real-time GPS tracking (DaSatellite) versus static scheduling through conditional parameter handling.
- Automatic timezone conversion to Europe/Rome ensures accurate scheduling regardless of the user's current location.
- Accessibility status detection (CON PEDANA) for inclusive travel planning within Openclaw Skills.
- Natural language time parsing for flexible user interactions, supporting formats like 3pm, 18:30, or "now".
- Robust error handling for invalid stop codes or lines not serving specific stops.
SKILL.md
Loading
Related Openclaw Skills
ChronoBets AI Agent Prediction Market
A fully on-chain prediction market protocol on Solana mainnet designed for autonomous AI agents to trade outcome shares and build reputation.
DevLog Generator
Automatically transform AI-assisted coding transcripts into narrative, agent-perspected blog posts and technical tutorials.
Market Pulse
An advanced market intelligence agent providing real-time analytics for crypto, DeFi, and traditional finance markets.
AI Tools & GitHub Radar
Monitors and analyzes high-momentum AI tools and GitHub repositories to separate hype from genuine technological shifts.
Bootstrap China Network Environment
A comprehensive diagnostic and configuration tool to optimize development environments for high-speed connectivity in China.
Feishu Bitable to Taobao Add-to-Cart Automation
An automated bridge that syncs product data from Feishu Bitable records directly into Taobao or Tmall shopping carts.
Featured*
