commutescout

CommuteScout 读取 53 个官方机构的数据源（CHP 调度信息、州 DOT 的道路封闭和事故、链条管制、摄像头、信息牌、野火范围、道路天气、收费价格），并将它们整合成一幅实时路况全景图。查看地图、规划路线并了解沿途的实际情况，或用日常语言询问行车路线。同一数据也通过 MCP 提供，因此 Claude 和其他 AI 助手可以将其用作工具，而不是靠猜测判断路况。

你将获得

• **全国实时地图：**按类型显示事件、按类别显示道路封闭、链控、带真实过火范围的野火、路边气象站、约 18,000 个交通摄像头，以及所有当前正在显示内容的信息牌。
• **收费道路和快速车道定价：**收费路段和桥梁的当前费率，沿实际车道绘制，并经人工核验龙门架位置，确保价格标签不会悬浮在错误的道路上。
• **了解道路状况的路线规划器：**自动补全、路线选项、逐向导航、沿途实时路况，以及打印、GPX、KML 或分享链接导出。
• **读取数据源的助手：**规划路线、点击建议问题，答案便会根据同一份实时数据流式生成，并显示各数据源的时间戳。
• **通俗易懂的事件详情：**CHP 调度日志会从无线电简语转成易读的时间线，并按顺序列出每个单位的抵达和解除时间。
• **监控区域：**绘制圆形、多边形或路线走廊；当区域内出现事件、道路封闭、链控或野火时，接收推送或电子邮件提醒。
• **MCP 服务：**针对精选路段和区域提供十种工具，并使用道路封闭分类体系，确保封闭匝道不会被误读为高速公路封闭。
• **手机上的逐向导航：**原生 iOS 和 Android 应用会播报路线前方的情况，而不仅仅是下一个转弯。道路封闭、事故、链控和火情会按距离播报，并根据行驶方向筛选，因此向南行驶时，向北方向的匝道封闭不会触发播报。参见 commutescout-app。
• 插件及其协议：Flare 是一项开放规范，任何数据源都可以实现它，将自己的警报显示在地图上。插件会出现在市场中，并按审核程度标注；未经审核的插件绝不会替驾驶员关闭道路。此仓库中提供了一个参考插件及其一致性测试。
• **公共 API：**通过纯 HTTP 提供相同的十种工具，附带 OpenAPI 文档、统一的错误封装和已公布速率限制的密钥。无需注册即可试用。
• **公开评测：**91 个基于录制数据的标准问题，由一个绝不会是受评模型之一的大模型裁判评分。评分卡是注明日期的快照，会标明所反映的版本；它不是发布门槛。评分卡及其完整历史记录均已提交到此仓库。

规划行程。自动补全、路线选项、导航、打印或导出。	询问路况。点击一个建议问题，答案便会读取实时数据源。	或者直接查看。每个图层都可切换，从全面封路到未显示内容的标志牌。
添加插件。每张卡片都会说明其覆盖范围、报告内容，以及是否经过审核。	或者基于它进行开发。十种基于纯 HTTP 的工具、统一的错误封装和已公布的速率限制。

## 覆盖范围

地图覆盖 37 个州。覆盖范围并不统一，因为它基于各州机构实际发布的数据：有些州的所有图层都可以免密使用，有些州只发布道路施工信息，还有少数州没有可用数据。地图会明确说明这一点，将不支持的州标示出来，并注明缺少的内容，而不是显示一片空白区域。

加利福尼亚州的数据最丰富。 它是唯一提供 CHP 调度日志、逐车道封闭详情、链控等级和 CAL FIRE 火场边界的州。助手和 MCP 工具会回答所有已覆盖州的问题，但关于加利福尼亚州的问题可以获得更丰富的详情，其他州则依据经过标准化的州 DOT 数据源作答。

各州当前可用的数据以及存在缺口的原因，详见矩阵： docs/state-coverage.md。尚未集成的州及其各自原因： docs/state-expansion-audit.md。

开始使用

打开 commutescout.com。无需运行任何程序，也无需注册，数据源已准备就绪。手机应用位于 commutescout-app。

托管应用上的关注区域和助手均可免费使用；目前关注区域账户需要审批，因为每个账户的轮询请求都由我们代为执行。

添加到 Claude

通过自定义连接器，为 Claude 提供实时道路数据：

https://mcp.commutescout.com/mcp

请在网站上查看：commutescout.com/mcp。 本地 stdio 配置和完整工具参考：docs/mcp.md。

自行运行

代码采用 MIT 许可证，仓库内容完整，因此你可以自行运行一份。不过，我们也应该坦诚说明所需投入：部署到 Cloud Run、获取十几个州数据源的凭据、配置 Firestore 数据库、发布地图快照、为关注区域配置调度器，以及使用付费地图服务商。维护这些内容是项目中最主要的工作，因此我不建议也不支持这条路。

唯一合理的例外是 MCP 服务本身，因为它不需要账户或密钥：

{
  "mcpServers": {
    "commutescout": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/nicglazkov/commutescout", "ca-roads-mcp"]
    }
  }
}

阅读代码，借鉴有用的部分；如果发现这里有误，请提交 issue。docs/deploy.md 记录了部署方式，仅供存档，并非供你照着操作的指南。

数据

CHP 事故和调度日志；Caltrans 及 30 多个其他州 DOT 的封路信息、事故、摄像头、电子信息牌和道路天气；加利福尼亚州和太平洋西北地区的链控信息；WFIGS 和 CAL FIRE 的野火数据及火场边界；NWS 警报；USGS 地震；收费公路和快速车道定价；以及可选的 TomTom 和 511 SF Bay 数据源。

每条响应都会附带各数据源的 data_as_of 时间戳，数据源故障绝不会悄无声息：系统会继续提供上次成功获取的数据，并标记为过期，同时附上错误信息并一路显示到 UI。

完整的数据源表、刷新频率和封路分类： docs/data-sources.md。

回答质量如何？

评测套件会根据已记录的测试样例为助手打分：四种场景（一场内华达山脉风暴日、一个火灾封路日、一个平静日，以及一份逐字节捕获的真实火灾季节日数据），91 个带有标准答案（包括陷阱）的黄金问题，以及一个绝不会作为被评测模型的大模型评审器。

评测需手动触发，而非每次发布时运行。事实证明，每次发布都运行完整套件，每月的费用会超过托管助手的服务成本，因此现在只有在提示词或工具发生确实需要重新评分的变更时才会运行。每次运行都会追加到已提交的历史文件中，因此趋势始终公开可查：EVALS.md。

底层实现

三个层次清晰的 Python 软件包共享同一数据主干：数据源层提供支持过期时重新验证的缓存，以及能从截断的数据源中抢救出完整记录的解析器；此外还有 MCP 接口层和 Web 应用。

地图不会通过 API 启动。发布器每个周期会构建一次整个覆盖区域，并将预先 gzip 压缩的快照上传到 CDN 后方的对象存储。因此，首次渲染时加载的是边缘缓存的静态文件，访客请求无需等待服务器拼装 JSON。即使地图在墙上的显示器上一直打开，也能无限期地原地更新。

架构图和设计说明：docs/architecture.md。

参与贡献

欢迎提交 PR。测试套件基于固定样例，无需网络访问即可运行。请先阅读 CONTRIBUTING.md；如果你想接入新的数据源，请参阅添加数据源。

许可证与可持续发展

CommuteScout 采用 MIT 许可证：地图、路线规划器、MCP 服务和所有数据解析器均采用该许可证，不设开源核心版的功能限制。托管应用 commutescout.com 即将推出可选的高级功能（更深入的历史数据、更多警报）；这些功能将为服务器提供资金，并让免费层级继续免费。

免责声明

数据来自 CHP、Caltrans 和 docs/state-coverage.md 中列出的其他州 DOT，以及 WFIGS、CAL FIRE、NWS 和 USGS。我们与任何机构均无关联。情况变化速度可能快于任何数据源；驾车前请先核实（拨打 511 或查询所在州的 DOT；在加利福尼亚州还可访问 quickmap.dot.ca.gov）。

路线规划和地点名称查询由 Stadia Maps 提供，该服务会看到所涉及的坐标。网站和手机应用使用本项目自己的地图文件绘制基础地图（基于 Protomaps OpenStreetMap 构建，并托管在 Cloudflare R2 的 maps.commutescout.com 上），因此没有第三方能够看到地图的查看位置；而网站上的 Positron 和 Bright 样式会从 OpenFreeMap 加载图块，该服务会看到查看者的地址和地图区域。字体和地图库均由本地提供。