entur-travel

ClawSkills 作者 clawskills

Plan public transit trips in Norway using the Entur API. Covers all operators (Vy, Ruter, Kolumbus, etc.), all modes (bus, rail, tram, metro, ferry, coach). Use when: (1) planning a journey between places in Norway, (2) checking departure boards/next departures, (3) finding stop IDs or place names, (4) looking up real-time transit info. Triggers on questions about trains, buses, ferries, trams in Norway, getting to airports (Gardermoen, Torp, Flesland), or how do I get to X.

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install clawskills:clawskills~mmichelli-entur-travel

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/clawskills%3Aclawskills~mmichelli-entur-travel/file -o mmichelli-entur-travel.md

# Entur Travel

Plan public transit journeys across Norway via the Entur Journey Planner API. Covers every operator and mode — bus, rail, tram, metro, ferry, coach, air — with real-time data.

**No API key required.** Free, open API under NLOD licence.

## Script

`scripts/entur.py` — standalone Python 3 CLI, no dependencies beyond stdlib.

### Commands

```bash
# Search for stops/places
python3 scripts/entur.py search "Oslo S"

# Plan a trip (place names auto-resolve via geocoder)
python3 scripts/entur.py trip "Porsgrunn" "Oslo lufthavn"

# Plan with specific departure time
python3 scripts/entur.py trip "Bergen" "Stavanger" --time "2025-03-01T08:00:00"

# Arrive by a specific time
python3 scripts/entur.py trip "Drammen" "Oslo S" --time "2025-03-01T09:00:00" --arrive

# Filter by mode
python3 scripts/entur.py trip "Tromsø" "Harstad" --modes water

# Departure board for a stop
python3 scripts/entur.py departures "NSR:StopPlace:58966" --limit 5

# Stop details (quays, platforms)
python3 scripts/entur.py stop "NSR:StopPlace:58966"
```

All output is JSON.

### Modes

Valid transport modes for `--modes`: `bus`, `rail`, `tram`, `metro`, `water`, `air`, `coach`

### Common Stop IDs

Use `search` to find IDs. Some common ones:
- Oslo S: `NSR:StopPlace:59872`
- Oslo lufthavn (Gardermoen): `NSR:StopPlace:269`
- Bergen stasjon: `NSR:StopPlace:585`
- Trondheim S: `NSR:StopPlace:41742`

## Presenting Results

When presenting trip results to users:
- Show times in local format (HH:MM), not ISO
- Summarize legs concisely: "🚆 RE11 Porsgrunn → Torp (10:17–10:50, platform 1)"
- Flag real-time delays: if aimed ≠ expected, mention the delay
- For departure boards, use a compact list format
- Include walk distances when significant (>200m)

## Limitations

- Norway only (Entur covers all Norwegian public transport)
- No ticket purchasing — planning and real-time info only
- Geocoder works best with Norwegian place names
- For international trips, only the Norwegian leg is covered