OpenClaw · Skill
Idfm Journey Skill
Use the bundled script to call PRIM/Navitia endpoints without extra dependencies.
Install
Start with the primary install command. Alternate entrypoints are included below for ClawHub and OpenClaw CLI users.
Primary command
clawhub install anthonymq/idfm-journey-skillClawHub installer
npx clawhub@latest install anthonymq/idfm-journey-skillOpenClaw CLI
openclaw skills install anthonymq/idfm-journey-skillDirect OpenClaw install
openclaw install anthonymq/idfm-journey-skillWhat this skill does
Use the bundled script to call PRIM/Navitia endpoints without extra dependencies.
Why it matters
Handles place name resolution automatically, so you can type a station name instead of looking up stop IDs before querying journeys.
Typical use cases
- Finding routes between Paris neighborhoods by typing plain station names
- Checking active disruptions on a specific RER or metro line before leaving
- Resolving ambiguous stop names to exact IDFM stop area IDs
- Planning a trip from the suburbs into central Paris with transfer details
- Monitoring ongoing incidents across Île-de-France transit lines
Source instructions
IDFM Journey (PRIM/Navitia)
Use the bundled script to call PRIM/Navitia endpoints without extra dependencies.
Metadata
- Author: anthonymq
- Version: 0.1.6
Trigger phrases (examples)
- "Itinéraire de {origine} à {destination}"
- "Route from {origin} to {destination} in Paris / Île-de-France"
- "Check RER/metro disruptions" / "incidents on line {line}"
Prereqs
- Set
IDFM_PRIM_API_KEYin the environment before running.
Generating an API Key
To obtain an IDFM PRIM API key:
- Visit https://prim.iledefrance-mobilites.fr/
- Create an account or log in
- Navigate to "Espace développeur" or the developer portal
- Subscribe to the "Navitia" API
- Your API key will be generated and displayed in your dashboard
- Export it in your environment:
export IDFM_PRIM_API_KEY="your-key-here"
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:C01727python3 scripts/idfm.py incidents --filter 'disruption.status=active'
Add --json to print raw API output.
Notes
- If place resolution is ambiguous, increase
--countand choose the rightstop_areaid. - For API details and examples, read:
references/idfm-prim.md.