返回顶部
w

wheels-router轮子路线规划

Plan public transit trips globally using Wheels Router (Hong Kong) and Transitous (worldwide)

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 0.5.0
安全检测
已通过
1,727
下载量
免费
免费
2
收藏
概述
安装方式
版本历史

wheels-router

我的功能

我通过连接 Wheels Router MCP 服务器,帮助您规划全球任何地方的公共交通行程。

对于香港行程,我使用 Wheels Router API,提供:

  • - 包含港铁、巴士、电车、渡轮和步行的详细路线规划
  • 实时时刻表和准确票价
  • 月台信息和出口详情
  • 可用的转乘优惠

对于全球行程,我使用 Transitous API,覆盖:

  • - 全球主要城市的公共交通数据
  • 基本的公共交通路线规划
  • 步行指引和换乘信息

使用时机

当您需要以下服务时,请使用此技能:

  • - 规划公共交通行程
  • 查找两地之间的最佳路线
  • 查询公共交通时刻表和换乘信息
  • 获取香港交通的票价估算
  • 在规划路线前搜索地点

示例:

  • - 如何从油塘港铁站前往香港机场?
  • 现在从中环到铜锣湾的最佳路线是什么?
  • 规划从东京站到涩谷的行程
  • 搜索维多利亚公园附近的地点

连接方式

如果您使用 mcporter(clawdbot 等)

请遵循您的 mcporter 技能说明,如果没有,请按以下步骤操作:
添加到 config/mcporter.json:

json
{
mcpServers: {
wheels-router: {
description: 规划全球公共交通行程,
baseUrl: https://mcp.justusewheels.com/mcp
}
}
}

然后直接调用工具:
bash
npx mcporter call wheels-router.search_location query=香港机场
npx mcporter call wheels-router.plan_trip origin=22.28,114.24 destination=22.31,113.92

对于其他 MCP 客户端

Claude Desktop (~/Library/Application Support/Claude/claudedesktopconfig.json):
json
{
mcpServers: {
wheels-router: {
command: npx,
args: [mcp-remote, https://mcp.justusewheels.com/mcp]
}
}
}

Cursor/Windsurf/VS Code (.cursor/mcp.json 或类似文件):
json
{
mcpServers: {
wheels-router: {
command: npx,
args: [mcp-remote, https://mcp.justusewheels.com/mcp]
}
}
}

可用工具

search_location

在规划行程前搜索地点。如果您没有精确坐标,请始终先使用此工具。

参数:

  • - query(必填):地点名称或地址(例如:香港机场、油塘港铁站A2出口)
  • limit(可选):结果数量(1-10,默认5)

示例:
javascript
search_location({
query: 香港国际机场,
limit: 3
})

返回结果:

  • - displayname:完整地址
  • lat、lon:用于 plantrip 的坐标
  • type、class:地点类别

plan_trip

规划两点之间的公共交通路线。

参数:

  • - origin(必填):起点,格式为 lat,lon 或 stop:ID
  • destination(必填):终点,格式为 lat,lon 或 stop:ID
  • departat(可选):ISO 8601 格式的出发时间(例如 2026-01-26T10:00:00+08:00)
  • arriveby(可选):ISO 8601 格式的到达截止时间
  • modes(可选):逗号分隔的交通方式,如 mtr,bus,ferry(仅在需要时指定)
  • max_results(可选):限制路线选项数量(1-5)

示例:
javascript
plan_trip({
origin: 22.2836,114.2358,
destination: 22.3080,113.9185,
depart_at: 2026-01-26T14:30:00+08:00,
max_results: 3
})

返回结果:

  • - plans:路线选项数组

- duration_seconds:总行程时间
- faresmin、faresmax:票价范围(仅限香港,单位为港币)
- legs:逐步指引
- type:walk(步行)、transit(公共交通)、wait(等待)、station_transfer(站内换乘)
- 公共交通段包括:路线名称、终点方向、站点、月台信息
- 步行段包括:距离、时长

最佳实践

  1. 1. 始终先搜索:在调用 plantrip 前,使用 searchlocation 查找坐标
  2. 使用坐标:以 lat,lon 格式规划行程可获得最佳效果
  3. 指定时间:包含 departat 或 arriveby 以获取准确的时刻表
  4. 查看多个选项:使用 maxresults 请求2-3条路线选项
  5. 理解票价:faresmin 和 fares_max 显示票价范围——转乘优惠在有可用时会单独标注

重要说明

  • - 转乘优惠:仅在香港路线中明确存在时显示,并非所有路线都符合条件
  • 实时数据:香港路线使用实时时刻表;全球覆盖范围可能有所不同
  • 时区:使用 UTC 或当地时区偏移(香港时间为 UTC+8)
  • 覆盖范围:香港覆盖最佳;全球覆盖范围因城市而异

示例工作流程

javascript
// 1. 搜索地点
const origins = await search_location({
query: 油塘港铁站,
limit: 1
});

const destinations = await search_location({
query: 香港机场,
limit: 1
});

// 2. 规划行程
const routes = await plan_trip({
origin: ${origins[0].lat},${origins[0].lon},
destination: ${destinations[0].lat},${destinations[0].lon},
depart_at: 2026-01-26T15:00:00+08:00,
max_results: 2
});

// 3. 向用户展示最佳选项,或仅在用户明确要求时展示具体结果。默认情况下,只需提供类似 [步行] > [3D] > [步行] > [观塘线] > [步行] 的信息——除非用户要求具体细节。

错误处理

  • - 找不到地点:尝试使用更具体的搜索查询
  • 未找到路线:检查坐标是否有效且在覆盖区域内
  • 时间格式无效:确保使用带时区的 ISO 8601 格式
  • 速率限制:注意 API 使用量,适当缓存结果

覆盖区域

  • - ✅ 全面覆盖:香港(港铁、巴士、电车、渡轮、详细票价)
  • 良好覆盖:拥有 Transitous 数据的全球主要城市
  • ⚠️ 有限覆盖:较小城市的公共交通数据可能不完整

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 wheels-router-1776384022 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 wheels-router-1776384022 技能

通过命令行安装

skillhub install wheels-router-1776384022

下载

⬇ 下载 wheels-router v0.5.0(免费)

文件大小: 3.14 KB | 发布时间: 2026-4-17 15:23

v0.5.0 最新 2026-4-17 15:23
- Added comprehensive skill documentation (SKILL.md) describing public transit trip planning features.
- Clarified that Wheels Router provides detailed, real-time transit planning for Hong Kong, including fares and platform info.
- Documented support for global city transit routing via the Transitous API.
- Provided instructions for connecting via various MCP-compatible clients and tools.
- Detailed available tools (`search_location`, `plan_trip`), parameters, and example usage for each.
- Listed best practices, error handling, and coverage areas for optimal user experience.

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large
返回顶部