Query Île-de-France Mobilités (IDFM) PRIM/Navitia for Paris + suburbs public transport (Île-de-France) — place resolution, journey planning, and disruptions/incident checks.
Installs into .claude/skills of the current project.
Are you the author of Idfm Journey Skill?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/modbender-idfm-journey-skill)
---
id: idfm-journey-skill
name: IDFM Journey
description: Query Île-de-France Mobilités (IDFM) PRIM/Navitia for Paris + suburbs public transport (Île-de-France) — place resolution, journey planning, and disruptions/incident checks.
env: ['IDFM_PRIM_API_KEY']
license: MIT
metadata:
author: anthonymq
category: "Transport"
tags: ["idfm", "navitia", "paris", "transport"]
---
# IDFM Journey (PRIM/Navitia)
Use the bundled script to call PRIM/Navitia endpoints without extra dependencies.
## Prereqs / security
- **Required secret:** `IDFM_PRIM_API_KEY` (treat as a secret; don’t commit it).
- **Scope it:** set it only in the shell/session that runs the command.
- **Do not override `--base-url`** unless you fully trust the endpoint.
The script sends `apikey: <IDFM_PRIM_API_KEY>` to whatever base URL you provide, so a malicious URL would exfiltrate your key.
## Quick commands
Run from anywhere (path is inside the skill folder):
- Resolve places (best match + list):
- `python3 scripts/idfm.py places "Ivry-sur-Seine" --count 5`
- Journeys (free-text from/to; resolves place ids first):
- `python3 scripts/idfm.py journeys --from "Ivry-sur-Seine" --to "Boulainvilliers" --count 3`
- Incidents / disruptions (by line id or filter):
- `python3 scripts/idfm.py incidents --line-id line:IDFM:C01727`
- `python3 scripts/idfm.py incidents --filter 'disruption.status=active'`
Add `--json` to print raw API output.
## Notes
- If place resolution is ambiguous, increase `--count` and choose the right `stop_area` id.
- For API details and examples, read: `references/idfm-prim.md`.
