mop-skills/skills/rvv-regensburg/SKILL.md

name	description
rvv-regensburg	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):

./scripts/rvv_query.py stop "Hauptbahnhof"

2. Get Next Departures

To see what's leaving a stop soon (using its Stop ID):

./scripts/rvv_query.py departures "de:09362:11010" --count 5

3. Plan a Journey

To find connections between two Stop IDs:

./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").