idfm-journey

TotalClaw 作者 anthonymq v0.1.6

查询巴黎+郊区公共交通（法兰西岛）的法兰西岛移动 (IDFM) PRIM/Navitia — 地点解析、行程规划和中断/事件检查。当被要求查找法兰西岛的路线（例如“itinéraire de X à Y”）、解析车站/站点 ID 或检查 RER/地铁线路中断且您拥有 IDFM PRIM API 密钥时使用。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~anthonymq-idfm-journey-skill

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~anthonymq-idfm-journey-skill/file -o anthonymq-idfm-journey-skill.md

## 概述（中文）

查询巴黎+郊区公共交通（法兰西岛）的法兰西岛移动 (IDFM) PRIM/Navitia — 地点解析、行程规划和中断/事件检查。当被要求查找法兰西岛的路线（例如“itinéraire de X à Y”）、解析车站/站点 ID 或检查 RER/地铁线路中断且您拥有 IDFM PRIM API 密钥时使用。

## 原文

# 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_KEY` in the environment before running.

### Generating an API Key

To obtain an IDFM PRIM API key:
1. Visit [https://prim.iledefrance-mobilites.fr/](https://prim.iledefrance-mobilites.fr/)
2. Create an account or log in
3. Navigate to "Espace développeur" or the developer portal
4. Subscribe to the "Navitia" API
5. Your API key will be generated and displayed in your dashboard
6. 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: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`.