Open Data Hub CLI

请使用 odh 命令行工具，而非手动爬取 Open Data Hub 网页。大部分实用数据来自南蒂罗尔 / 博尔扎诺自治省；请务必通过坐标、来源或元数据验证每条记录的具体地理位置。

安装与初始化

odh version
odh doctor --timeout 10s

当前命令契约、数据集指引、来源（source）/溯源（provenance）字段、交通辅助功能、GTFS/公共交通支持、按条件筛选的最新测量值、逗号安全的 --param 参数、transit journey --with-realtime 及 MCP 服务端模式等功能，均需 odh v0.4.0+ 版本支持。

推荐的手动安装方式：

go install github.com/galjos/odh-cli/cmd/odh@v0.4.0
brew install galjos/odh/odh

Agent 主机亦可利用本技能中声明的 OpenClaw Go 安装器元数据进行部署。若直接从源码仓库运行，请使用 ./odh。

偏好使用 MCP 协议而非 Shell 命令的 Agent 主机，可通过 odh mcp serve 启动同一套经人工校验的命令接口；其工具输出严格遵循与 CLI 相同的 JSON 契约格式及警告机制。

输出规范

• 经人工校验的命令默认以表格形式输出。如需解析结果，请显式添加 --json 或 --format json 参数。
• 该规则尤其适用于 traffic、a22 status、transit、tourism types、mobility types 和 mobility datatypes 等命令。
• 将 stderr 视为诊断信息，而非有效数据。
• 非零退出码表示执行失败；退出码 2 通常表示命令调用错误（bad invocation）。
• 在受控的 Agent 循环中，请将全局超时参数置于子命令之前，例如：odh --timeout 20s traffic today --area bozen-unterland --json。
• 若不确定某命令的具体用法，可先运行 odh --help；当前帮助文档包含面向具体任务的示例。
• 在猜测提供方名称、数据类型、站点 ID 或区域 ID 之前，请优先使用发现类（discovery）命令。
• 相比推断溯源信息，应优先采用返回结果中的 source、source_detail、endpoint、archive、realtime 和 warnings 字段。
• 稳定可用的结构化 JSON 字段定义详见代码仓库中的 docs/json-contracts.md。

数据发现

odh apis
odh datasets guide "ev charging availability" --format json
odh datasets search parking
odh openapi mobility
odh openapi tourism
odh mobility types --kind station
odh mobility origins --station-type ParkingStation
odh mobility datatypes --station-type TrafficSensor --origin A22 --limit 1000 --json

面对不熟悉的数据主题时，请首先运行 odh datasets guide --format json，并依据其返回的 discovery、verify 和 caveats 字段指导后续操作，再选择更底层的命令。

在任何使用 --origin 进行过滤的查询前，务必先执行 odh mobility origins --station-type 。即使来源看似明确（如 A22、ALPERIA、PROVINCE_BZ），也须如此操作：来源名称属于上游词汇表（upstream vocabulary），已编目来源或数据类型本身，并不能保证存在对应开放的实测数据行。

对于已知端点，可使用 odh call --param key=value。其中 --param 可重复指定，且参数值允许包含逗号。

交通信息

道路施工、封闭及各类道路事件：

odh traffic zones --json
odh traffic categories --json
odh traffic today --area ueberetsch-unterland --type roadworks --json
odh traffic search badia --today --zone-id 6 --json
odh traffic today --near 46.42,11.25 --radius 15km --json

优先使用 traffic 命令，而非原始的 mobility events --origin PROVINCE_BZ。请向用户呈现过期警告（stale warnings）和来源警告（source warnings）。切勿将过期或无明确时效性的开放数据行，当作已确认的当前道路封闭信息展示。

A22 高速公路：

odh a22 status --limit 10 --json
odh mobility events --origin A22 --latest --limit 20

a22 status 面向当前/实时状态。请勿基于 TrafficForecast 类型数据推断实时事故。若需查询历史本地 A22 事故，应说明 ODH/A22 实时数据流通常不保留历史记录，必要时请参考带时间戳的外部数据源。

出行测量数据

获取当前可用性数据时，请先发现来源（origin）与数据类型（datatype），再按时效性进行筛选：

odh diagnostics ev-charging --origin ALPERIA --fresh-within 24h
odh diagnostics parking-forecasts --origin "Municipality Merano" --fresh-within 2h --forecast-minutes 60
odh mobility latest --station-type ParkingStation --data-type free --origin "Municipality Merano" --active --fresh-within 2h --sort newest --request-limit 10000 --limit 10 --format table

原始的“最新”数据行可能包含已失效或非活跃站点。请向用户呈现 warnings 字段内容。若诊断结果显示 current_only，则仅报告当前占用状态，不得展示过期的预测数据。

旅游活动事件：

odh diagnostics tourism-events --date 2026-05-18 --limit 20
odh tourism poi --limit 1 --seed 42 --fields Detail.en.Title,GpsInfo

在做出“今日附近”类推断前，请务必检查 date_status、location_status 及 GpsInfo 字段。

公共交通

odh gtfs datasets
odh gtfs realtime --dataset sta-time-tables --feed trip-updates --limit 5
odh transit stops search merano --limit 10
odh transit departures --stop-id  --date 2026-05-16 --around 13:00 --mode train --json
odh transit trip --from-stop-id  --to-stop-id  --date 2026-05-16 --time 13:00 --mode train --json
odh transit journey --from-stop-id  --to-stop-id  --date 2026-05-16 --time 13:00 --max-transfers 3 --with-realtime --json
odh transit delay-stats --from auer --to brenner --time 14:05 --weekday saturday --json

当站点名称存在歧义时，请使用站点 ID（stop ID）。journey --with-realtime 将静态路线与当前 GTFS-RT 数据叠加标注，但**不执行动态重路径规划（live-reroute）**。缺失实时实体（realtime entities）并不意味着服务准点。若未归档 GTFS-RT 历史数据，则无法支持历史延误概率分析；此时请使用 delay-stats，切勿主观猜测。

评估（Evals）

scripts/run-agent-evals.sh

请使用 evals/agent/tasks.json 进行人工评分，使用 evals/agent/recipes.json 作为机器可读的命令配方（command recipes）。通过评估结果判断反复失败是否需要更新文档、优化技能指引、改进 Agent 推理逻辑，或引入特定 CLI 功能增强。

参考资料

• https://opendatahub.com/api/
• https://docs.opendatahub.com/en/latest/datasets.html
• https://docs.opendatahub.com/en/latest/howto/mobility/getstarted.html