feat(skill): add rvv-regensburg skill with real-time EFA API support

2026-02-22 11:35:27 +01:00
parent a83139acef
commit 214a950ac2
3 changed files with 175 additions and 0 deletions
@@ -0,0 +1,45 @@
+---
+name: rvv-regensburg
+description: Real-time public transport information for Regensburg (RVV). Provides departures, stop finding, and journey planning via direct API access. Use when the user asks for bus/train departures in Regensburg or needs to find a connection within the city.
+---
+
+# 🚌 RVV Regensburg
+
+Access real-time public transport data for the Regensburg transport network (RVV) using the Mentz EFA API.
+
+## 🚀 Quick Usage
+
+Use the provided `scripts/rvv_query.py` to interact with the API. Always try to find the correct Stop ID first if you don't have it.
+
+### 1. Find a Stop ID
+If you only have a name like "Hauptbahnhof", find its global Stop ID (e.g., `de:09362:11000`):
+```bash
+./scripts/rvv_query.py stop "Hauptbahnhof"
+```
+
+### 2. Get Next Departures
+To see what's leaving a stop soon (using its Stop ID):
+```bash
+./scripts/rvv_query.py departures "de:09362:11010" --count 5
+```
+
+### 3. Plan a Journey
+To find connections between two Stop IDs:
+```bash
+./scripts/rvv_query.py trip "de:09362:11010" "de:09362:11000"
+```
+
+## 🛠️ API Details (Advanced)
+If `rvv_query.py` is not sufficient, you can use `curl` directly. The base URL is `https://efa.rvv.de/efa/`.
+
+**Endpoints:**
+- `XML_STOPFINDER_REQUEST`: Resolve names to IDs.
+- `XML_DM_REQUEST`: Departure board.
+- `XML_TRIP_REQUEST2`: Connection search.
+
+Always include `outputFormat=rapidJSON` and `version=10.5.17.3` in your requests for the best experience.
+
+## 💡 Tips
+- **Real-time:** The API provides real-time data by default (`useRealtime=1`). Look for `rt_time` in the script output.
+- **Global IDs:** Prefer the global ID format (e.g., `de:09362:XXXXX`) for better accuracy.
+- **Regensburg Focus:** When searching for stops, include "Regensburg" in the name to avoid matches in other cities (e.g., "Hauptbahnhof" -> "Regensburg, Hauptbahnhof").