mvg

# MVG Skill 🚇 Munich public transport departures, schedules, and alerts. ## 1. Departures by Location When user shares location or asks about nearby transport: ```bash python3 mvg-departures.py <lat> <lng> # With options python3 mvg-departures.py <lat> <lng> --limit 5 --offset 3 --compact ``` ### Options | Flag | Description | |------|-------------| | `--limit N` | Max departures (default: 8) | | `--offset MIN` | Walking time to stop (filters out departures leaving too soon) | | `--types U,S,BUS,TRAM` | Filter by transport type | | `--compact` | One-line format | | `--json` | JSON output | ### Examples ```bash # Central Munich python3 mvg-departures.py 48.137 11.575 # Only U-Bahn and S-Bahn, 5 min walk to station python3 mvg-departures.py 48.137 11.575 --types U,S --offset 5 # Compact output python3 mvg-departures.py 48.137 11.575 --compact ``` ### Output Format ``` 📍 **Marienplatz** (München) 🚇 U3 → Fürstenried West (2 min) 🚇 U6 → Klinikum Großhadern (3 min) 🚆 S1 → Freising (5 min +2) ``` Delay shown as `(+N)` minutes. ## 2. On Location Share When user sends a location via Telegram/Signal, automatically show nearby departures: ```bash python3 mvg-departures.py <lat> <lng> --limit 6 --compact ``` ## 3. Alerts & Disruptions Check for strikes, disruptions, construction: ```bash web_search "München MVG Streik Störung" --freshness pd ``` ### Keywords - `Streik` — strike - `Störung` — disruption - `Sperrung` — closure - `Ausfall` — cancellation - `Verspätung` — delay - `Bauarbeiten` — construction ### MVG vs S-Bahn | Service | Operator | During MVG Strike | |---------|----------|-------------------| | U-Bahn | MVG | ❌ Affected | | Tram | MVG | ❌ Affected | | Bus (1-199) | MVG | ❌ Affected | | **S-Bahn** | **DB** | ✅ Usually runs | | Regional trains | DB | ✅ Usually runs | ⚠️ S-Bahn is operated by Deutsche Bahn, not MVG! ## 4. Heartbeat Integration Add to HEARTBEAT.md for automated checks: ```markdown ### 🚨 MVG Alerts (every heartbeat) - web_search: "München MVG Streik Störung" freshness=pd - Report NEW alerts only (check reportedAlerts in state) ### 📍 On Location - python3 mvg-departures.py <lat> <lng> --limit 6 ``` Track reported alerts in state file: ```json { "reportedAlerts": ["mvg-streik-2026-02-02"], "acknowledgedAlerts": [] } ``` ## 5. API Reference Uses unofficial MVG API: ``` Base: https://www.mvg.de/api/bgw-pt/v3 GET /stations/nearby?latitude=X&longitude=Y GET /departures?globalId=STATION_ID&limit=N&offsetInMinutes=M ``` Python package: `pip install mvg` ## Requirements ```bash pip install mvg ``` ## Munich Tips - **Rush hours**: 7:00-9:00, 16:30-19:00 - **Oktoberfest**: U4/U5 crowded (late Sept) - **Allianz Arena**: U6 packed on match days - **Night service**: Limited after 00:30 (weekdays)