核心用法
GuruWalk Free Tours 通过 MCP 协议对接 GuruWalk 官方 API，为用户提供可预订的免费步行导览搜索服务。用户仅需提供城市名称、日期范围和语言偏好，即可获得包含评分、时长、集合地点、向导信息及可预订时段的完整行程列表。
典型使用场景：
- 规划马德里、巴塞罗那等欧洲城市的免费 walking tour
- 对比不同向导的评分与可用时段
- 按语言筛选（支持西班牙语、英语、德语、意大利语等）
- 实时查看剩余名额并直接跳转预订
显著优点
1. 零成本入门："Free tour"模式降低旅行体验门槛，用户按满意度自由打赏
2. 本地化深度体验：由当地向导带领，获取攻略难以覆盖的城市细节
3. 灵活筛选：支持日期范围查询，便于多行程串联规划
4. 实时可用性：返回具体时段的剩余名额，避免预订冲突
5. 信誉透明：平均评分、向导姓名、集合地点等关键信息完整呈现
潜在局限与风险
1. 地理覆盖不均：主要集中于欧洲热门城市，亚太、非洲城市选项有限
2. 质量波动：免费模式导致向导水平参差，评分仅供参考
3. 隐性消费：部分 tour 虽标"免费"，但向导可能推销付费项目或期待高额小费
4. 时区处理：start_time 返回 UTC 时间，需自行转换当地时区
5. 空值兼容：个别 tour 可能出现 title: null，需健壮处理
6. 依赖第三方：GuruWalk 平台政策变动可能影响 MCP 可用性
适合人群
- 预算有限的背包客与青年旅行者
- 偏好灵活行程、不喜跟团游的自由行旅客
- 希望快速建立城市认知的首访游客
- 语言学习者（可筛选特定语言导览强化练习）
常规风险
- 预订失败风险：显示可用名额不代表最终确认，建议提前预订
- 行程变动：向导可能因天气、人数不足取消 tour
- 数据时效：API 返回数据存在缓存延迟，热门时段实际满员可能未实时更新
- 安全考量：夜间 tour 集合地点可能位于偏僻区域，建议提前踩点
技术实现要点
- 城市名需转为小写连字符格式（如
new-york、san-sebastian） - 日期严格使用 ISO 8601 格式（
yyyy-mm-dd） - 结果按可用名额>0、评分降序、时间升序智能排序
- 默认语言策略：西班牙语对话自动选
es，其余选en