← 返回 Skills 市场
2152
总下载
0
收藏
0
当前安装
7
版本数
在 OpenClaw 中安装
/install idfm-journey-skill
功能描述
Query Île-de-France Mobilités (IDFM) PRIM/Navitia for Paris + suburbs public transport (Île-de-France) — place resolution, journey planning, and disruptions/...
使用说明 (SKILL.md)
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.
安全使用建议
This skill appears to be a straightforward Python wrapper for the IDFM PRIM/Navitia API and only needs your IDFM_PRIM_API_KEY. Before installing: (1) note the registry metadata omits the required env var — double-check you set IDFM_PRIM_API_KEY only for this skill; (2) review the included scripts/idfm.py yourself (it only uses urllib and calls the official prim.iledefrance-mobilites.fr endpoint); (3) avoid pasting other unrelated secrets into the environment; (4) run it in an isolated environment if you are unsure (or ask the publisher to update the registry metadata to declare the required env var). If you need higher assurance, ask the owner to provide a verified homepage or more provenance for the package.
功能分析
Type: OpenClaw Skill
Name: idfm-journey-skill
Version: 0.1.6
The skill is a legitimate tool for querying the Île-de-France Mobilités (IDFM) transport API. The Python script (scripts/idfm.py) uses the standard library (urllib) to interact with official endpoints and correctly handles the API key via environment variables. No evidence of data exfiltration, malicious execution, or prompt injection was found.
能力评估
Purpose & Capability
The skill's name/description (IDFM PRIM/Navitia queries) matches the bundled script and documentation: place resolution, journeys, and disruptions. However, the registry metadata lists no required environment variables while SKILL.md and scripts/idfm.py both require IDFM_PRIM_API_KEY — an inconsistency between declared metadata and actual runtime needs.
Instruction Scope
SKILL.md instructs the agent/user to set IDFM_PRIM_API_KEY and run the included Python script. The runtime instructions are narrow: call the public Navitia endpoints, optionally print JSON, and pick place IDs. The instructions do not ask to read unrelated local files, transmit data to unknown endpoints, or collect extra system context.
Install Mechanism
No install spec or external downloads; the skill is instruction-only with a bundled Python script that uses only the standard library (urllib). Nothing is written to disk beyond the packaged files. This is a low-risk install mechanism.
Credentials
The script legitimately needs a single service credential (IDFM_PRIM_API_KEY) to call the Navitia API, which is proportional to purpose. The concern is the metadata/registry omission: the top-level metadata claims no required env vars while the SKILL.md and script require an API key. That mismatch could lead to accidental exposure (users won't be warned by the registry) or confusion about what to provide.
Persistence & Privilege
The skill does not request persistent/always-included presence. It does not modify other skills or system settings. Autonomous invocation is allowed (default) but not combined with other elevated privileges.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install idfm-journey-skill - 安装完成后，直接呼叫该 Skill 的名称或使用
/idfm-journey-skill触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v0.1.6
Add LICENSE + complete SKILL.md frontmatter fields (author/triggers/version)
v0.1.5
Declare required env IDFM_PRIM_API_KEY + add base-url exfiltration warning
v0.1.4
republish: try different tag
v0.1.3
republish for registry visibility
v0.1.2
Retry publish (registry visibility)
v0.1.1
Fix publish bundle; improve journeys output formatting
v0.1.0
- Initial release of idfm-journey-skill for Île-de-France Mobilités (IDFM) journey planning and incident checks.
- Supports place resolution, journey planning, and retrieving disruptions/incidents via the PRIM/Navitia API.
- Provides command-line scripts for querying places, planning journeys, and checking incidents.
- Requires setting the `IDFM_PRIM_API_KEY` environment variable before use.
元数据
常见问题
IDFM Journey 是什么？
Query Île-de-France Mobilités (IDFM) PRIM/Navitia for Paris + suburbs public transport (Île-de-France) — place resolution, journey planning, and disruptions/... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2152 次。
如何安装 IDFM Journey？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install idfm-journey-skill」即可一键安装，无需额外配置。
IDFM Journey 是免费的吗？
是的，IDFM Journey 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
IDFM Journey 支持哪些平台？
IDFM Journey 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 IDFM Journey？
由 anthonymq（@anthonymq）开发并维护，当前版本 v0.1.6。
推荐 Skills