⭐ 重要：天行数据找不到火车 API？请使用聚合数据！

📋 问题说明

你反映在天行数据平台找不到"火车票务查询"接口，这是正常的。

原因：

• 天行数据的火车 API 可能已下架或调整
• 各平台 API 会经常调整，这是正常现象

---

✅ 解决方案：使用聚合数据 ⭐⭐⭐⭐⭐

为什么推荐聚合数据？

特性	聚合数据	天行数据
火车 API	✅ 稳定运营	❓ 可能已下架
免费额度	100 次/天	100 次/天（如有）
数据质量	⭐⭐⭐⭐⭐	⭐⭐⭐⭐
推荐度	⭐⭐⭐⭐⭐	⭐⭐⭐

---

🚀 立即行动：5 分钟搞定

步骤 1：注册聚合数据（2 分钟）

1. 访问：https://www.juhe.cn
2. 注册：点击右上角"注册"
3. 登录：用手机号或邮箱登录

步骤 2：申请火车 API（2 分钟）

1. 搜索：在 API 市场搜索"火车"或"票务"
2. 找到："火车票务查询"或"12306 车次查询"
3. 申请：点击"立即申请"（免费，立即生效）
4. 获取 Key：在控制台复制 API Key

步骤 3：测试查询（1 分钟）

cd /root/.openclaw/workspace/travel/scripts/train_schedule

# 查询北京→上海
python query.py --from 北京 --to 上海 --api juhe --key YOUR_JUHE_KEY

---

📁 已更新的文件

所有文档和脚本已更新为优先推荐聚合数据：

scripts/train_schedule/
├── QUICKSTART.md       # ⭐ 已更新，推荐聚合数据
├── ALTERNATIVES.md     # ⭐ 新增，替代方案说明
├── query.py            # ⭐ 已更新，优化聚合数据支持
├── update_cache.sh     # 批量更新脚本
└── README.md           # 完整技术文档

---

💡 快速使用指南

查询示例

# 北京→西安
python query.py --from 北京 --to 西安 --api juhe --key YOUR_JUHE_KEY

# 北京→上海
python query.py --from 北京 --to 上海 --api juhe --key YOUR_JUHE_KEY

# 西安→宝鸡
python query.py --from 西安 --to 宝鸡 --api juhe --key YOUR_JUHE_KEY

批量缓存

# 缓存 35 条热门线路
./update_cache.sh YOUR_JUHE_KEY

---

📊 聚合数据 API 详情

API 信息

• 名称：火车票务查询
• 文档：https://www.juhe.cn/docs/api/id/18
• 免费额度：100 次/天
• 价格：超出后 ¥0.01-0.02/次
• 数据源：12306 官方

返回格式

{
    "error_code": 0,
    "reason": "查询成功",
    "result": {
        "list": [
            {
                "train_no": "G655",
                "from_station_name": "北京西",
                "to_station_name": "西安北",
                "start_time": "07:38",
                "end_time": "12:38",
                "lishi": "05:00"
            }
        ]
    }
}

---

⚠️ 常见问题

Q1: 找不到"火车票务查询"怎么办？

A: 尝试以下关键词搜索：

• "12306"
• "火车"
• "高铁"
• "车次"

如仍找不到，可能是：

• 分类调整（在"交通出行"或"生活服务"分类下）
• 暂时下架（联系客服咨询）

Q2: 聚合数据 API 稳定吗？

A: 聚合数据是老牌 API 服务商，火车 API 已运营多年，稳定性好。

Q3: 100 次/天够用吗？

A:

• 个人使用：完全够用
• 旅行规划：配合缓存，可查询 50+ 条线路
• 高频使用：可申请多个账号或购买付费套餐

---

🎯 下一步

1. 立即注册聚合数据：https://www.juhe.cn
2. 申请火车 API
3. 测试查询：北京→上海
4. 批量缓存：热门线路

---

📞 需要帮助？

如果有任何问题，请告诉我：

• 注册问题
• API 申请问题
• 查询失败
• 其他技术问题

我会立即帮你解决！

---

最后更新：2026-03-14 维护者：Travel Agent