commutescout

CommuteScout は、53 の公的機関のフィード（CHP の配車情報、州 DOT の通行止めと事故、チェーン規制、カメラ、電光掲示板、山火事の延焼範囲、道路の気象情報、通行料金）を読み取り、道路状況を 1 つのリアルタイムな情報にまとめます。地図を見たり、ルートを計画してそのルート上の実際の状況を確認したり、ドライブについて自然な英語で質問したりできます。同じデータは MCP 経由でも提供されるため、Claude などの AI アシスタントが交通状況を推測する代わりに、ツールとして利用できます。

得られるもの

• 全国のリアルタイムマップ： 種類別のインシデント、クラス別の通行止め、チェーン規制、実際の延焼範囲を示す山火事、道路脇の気象観測所、約18,000台の交通カメラ、現在何らかの情報を表示しているすべての電光掲示板。
• 有料道路とエクスプレスレーンの料金： 料金所のある道路区間や橋の最新料金を、実際の道路に沿って表示します。料金所の位置は人の手で確認しているため、料金表示が別の道路の上に浮かぶことはありません。
• 道路事情に詳しいルートプランナー： オートコンプリート、ルートの選択肢、ターンバイターン方式の道案内、ルート沿いのリアルタイム状況に加え、印刷、GPX、KML、共有リンクでのエクスポートに対応しています。
• フィードを読み取るアシスタント： ルートを計画して、提案された質問をタップすると、同じリアルタイムデータから回答がストリーミングされ、各データソースのタイムスタンプも表示されます。
• 平易な英語でのインシデント詳細： CHPの出動記録を無線の略語から読みやすい時系列に変換し、各部隊の到着と解除を順番に示します。
• 監視エリア： 円、ポリゴン、またはルート沿いのエリアを描画すると、その範囲内でインシデント、通行止め、チェーン規制、山火事が発生した際にプッシュ通知またはメールでお知らせします。
• MCP サーバー： 厳選された道路区間や地域を対象とした10個のツールを提供します。通行止めの分類体系により、入口ランプの通行止めを高速道路全体の通行止めとして誤認しません。
• スマートフォンでのターンバイターン方式のナビゲーション： iOSとAndroidのネイティブアプリが、次の曲がり角だけでなく、ルート先の情報も音声で案内します。通行止め、事故、チェーン規制、火災は距離に基づいて通知され、走行方向に合わせて絞り込まれるため、南へ向かっているときに北行きランプの通行止めが通知されることはありません。commutescout-appをご覧ください。
• プラグインとそのためのプロトコル： Flareは、あらゆるデータソースが独自の警告をマップに表示するために実装できるオープンな仕様です。プラグインはマーケットプレイスに表示され、審査の進捗がラベルで示されます。未審査のプラグインがドライバー向けに道路を通行止めにすることはできません。リファレンスプラグインと適合性テストもこのリポジトリに含まれています。
• パブリックAPI： 同じ10個のツールをプレーンなHTTP経由で利用でき、OpenAPIドキュメント、共通のエラー形式、公開されたレート制限付きのキーを提供します。試すだけなら登録は不要です。
• 公開評価： 記録済みのフィクスチャに基づく91個の正解付き質問を、評価対象のモデルとは異なるLLM審査員が採点します。スコアカードは、対象のバージョンを明記した日付付きのスナップショットであり、リリースの判定基準ではありません。スコアカードと全履歴はこのリポジトリにコミットされています。

旅の計画を立てる。 オートコンプリート、ルート候補、道案内、印刷やエクスポートに対応しています。	質問する。 提案された質問をワンタップすると、回答がリアルタイムのフィードを読み取ります。	マップを見るだけでもかまいません。 完全な通行止めから情報のない電光掲示板まで、すべてのレイヤーを切り替えられます。
プラグインを追加する。 各カードに、対応範囲、報告する情報、レビューの有無が表示されます。	または、これを基盤に開発する。 プレーンなHTTP経由の10個のツール、共通のエラー形式、公開されたレート制限を利用できます。

## 対応範囲

地図は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"]
    }
  }
}

コードを確認し、役立つ部分を活用し、ここに誤りがあればイシューを作成してください。docs/deploy.md には、手順書としてではなく、記録のためにデプロイ方法を記載しています。

データ

CHP のインシデントと出動記録、Caltrans およびその他 30 以上の州 DOT による通行止め、インシデント、カメラ、メッセージ標識、道路気象情報、カリフォルニア州と太平洋岸北西部のチェーン規制、WFIGS と CAL FIRE の火災情報および火災範囲、NWS の警報、USGS の地震情報、料金所とエクスプレスレーンの料金、さらにオプションの TomTom と 511 SF Bay のフィードを扱います。

すべての応答にはソースごとの data_as_of タイムスタンプが含まれます。また、フィードの障害が知らされないままになることはありません。最後に取得できた正常なデータを提供し、古いデータとしてフラグを付け、エラーを添付して UI まで表示します。

ソースの全一覧、更新頻度、通行止めの分類体系： docs/data-sources.md。

回答の精度は？

評価スイートでは、記録済みのフィクスチャを使ってアシスタントを採点します。4 つのシナリオ（シエラの嵐の日、火災による通行止めの日、平穏な日、火災シーズンの実際の一日をバイト単位でそのまま取り込んだ記録）、トラップを含む正解データ付きの 91 個の基準質問、そして評価対象モデルには決してならない LLM ジャッジを使用します。

実行はリリースごとではなく、手動で開始します。リリースのたびにスイート全体を実行すると、ホスト型アシスタントの月額費用を上回ることがわかったため、現在はプロンプトやツールの変更によって再採点が必要な場合に実行します。実行結果は毎回、コミットされる履歴ファイルに追記されるため、推移を公開し続けることができます：EVALS.md。

内部の仕組み

1 つのデータ基盤を共有する、明確にレイヤー分けされた 3 つの Python パッケージで構成されています。フィードレイヤーには、stale-while-revalidate キャッシュと、途中で切れたフィードから完全なレコードを復元するパーサーがあります。これに MCP のインターフェースとウェブアプリが加わります。

マップは API 経由では起動しません。パブリッシャーがサイクルごとに対象範囲全体を一度構築し、事前に gzip 圧縮したスナップショットを CDN の背後にあるオブジェクトストレージへアップロードします。そのため、最初の表示ではエッジキャッシュされた静的ファイルが使われ、訪問者のリクエストが、サーバーでの JSON 組み立てを待つことはありません。壁掛けモニターでマップを開いたままにしても、更新が途切れることはありません。

図と設計に関するメモ：docs/architecture.md をご覧ください。

貢献

PR を歓迎します。テストスイートはフィクスチャベースで、ネットワークアクセスなしで実行できます。まず CONTRIBUTING.md をご覧ください。新しいフィードを接続する場合は、データソースの追加もご覧ください。

ライセンスと持続可能性

CommuteScout は MIT ライセンスです。マップ、プランナー、MCP サーバー、すべてのデータパーサーが対象で、オープンコアの例外はありません。commutescout.com のホスト型アプリでは、近日中にオプションのプレミアム機能（より長期間の履歴や、より多くのアラート）を提供する予定です。これがサーバーの運用費を賄い、無料プランを無料のまま維持するための資金になります。

免責事項

データは、docs/state-coverage.md に記載されている CHP、Caltrans、その他の州 DOT に加え、WFIGS、CAL FIRE、NWS、USGS から取得しています。いずれの機関とも提携していません。状況はどのフィードよりも速く変化するため、運転前に確認してください（511 または州 DOT をご利用ください。カリフォルニア州では quickmap.dot.ca.gov もご利用ください）。

ルート検索と地名検索には Stadia Maps を使用しており、関連する座標が同社に送信されます。ウェブサイトとスマートフォンアプリでは、このプロジェクト独自のマップファイル（Protomaps OpenStreetMap ビルドから作成し、Cloudflare R2 上の maps.commutescout.com から配信）を使ってベースマップを描画するため、マップの閲覧場所が第三者に知られることはありません。一方、ウェブサイトの Positron および Bright スタイルでは、OpenFreeMap からタイルを読み込むため、閲覧者のアドレスとマップの表示範囲が同社に知られます。フォントとマップライブラリはローカルから配信しています。