메뉴
JARTIC (日本道路交通情報センター) が公開する渋滞「予測」データを取得する手順。ゴールデンウィーク・お盆・年末年始・行楽期の高速道路の渋滞予測、ピーク日時、◯◯祭りなどイベント周辺の一般道渋滞と迂回路を聞かれた際に使う。 `www.jartic.or.jp` の JSON を curl で取得し、路線名・年月・都道府県を `jq` で絞り込む。返るのは将来の予測であって現在の実況交通量ではない。今この瞬間の交通量・渋滞長を求められた場合はこの手順では取得できない。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | jartic-traffic-jam-forecast |
| description | JARTIC (日本道路交通情報センター) が公開する渋滞「予測」データを取得する手順。ゴールデンウィーク・お盆・年末年始・行楽期の高速道路の渋滞予測、ピーク日時、◯◯祭りなどイベント周辺の一般道渋滞と迂回路を聞かれた際に使う。 `www.jartic.or.jp` の JSON を curl で取得し、路線名・年月・都道府県を `jq` で絞り込む。返るのは将来の予測であって現在の実況交通量ではない。今この瞬間の交通量・渋滞長を求められた場合はこの手順では取得できない。 |
JARTIC が公開する渋滞「予測」データを取得する手順。高速道路の月別渋滞予測と、一般道のイベント周辺渋滞予測・迂回案内の 2 系統がある。
返るデータはすべて将来の渋滞「予測」である。今この瞬間の交通量・渋滞長・通行止めではない。
ベースは https://www.jartic.or.jp。いずれも認証不要・追加ヘッダ不要で、素の curl で HTTP 200・application/json が返る (2026 年 6 月時点で確認)。
| パス | 中身 | 規模の目安 |
|---|---|---|
/d/service/trafficjam/highway.json | 高速道路の月別渋滞予測 (路線 × 年月 × 予測日・時間帯) | 約 4.5 MB |
/d/service/trafficjam/general.json | 一般道のイベント周辺渋滞予測・迂回案内 (都道府県別) | 約 15 KB |
/d/service/trafficjam/summary.json | 渋滞予測資料 (記者発表 PDF 等) の告知バナー。渋滞データ本体ではない。 | 約 1.5 KB |
highway.json は数 MB ある。パイプで丸読みせず一度ファイルへ保存し、jq で路線名・年月へ絞ってから読む (下記)。curl -sS 'https://www.jartic.or.jp/d/service/trafficjam/highway.json' -o highway.json
jq '{updateDate, minYearMonth, maxYearMonth, months: (.trafficJam|keys)}' highway.json
| キー | 意味 |
|---|---|
updateDate | データ更新日 (例 2026年6月9日)。提示時に添える。 |
minYearMonth maxYearMonth | 予測がカバーする年月の範囲 (例 2026-5 〜 2026-10)。範囲外は取得できない。 |
routeList | 路線一覧。routeId / name / directionUp / directionDown (端点名)。 |
trafficJam | 予測本体。trafficJam[年月][routeId] に directionUp / directionDown の配列。 |
年月キーは YYYY-M 形式 (月はゼロ埋めなし、例 2026-5 2026-10)。先に minYearMonth/maxYearMonth と .trafficJam|keys で対象月の存在を確認する。
口語の期間語は、まず対象の年月キーへ落とす。月をまたぐ期間は複数キーを見る。
trafficJam["2026-8"] を見る。U ターン集中 (上り) はおおむね 8/11〜8/18、下り (出発側) は連休初日寄りにピークが出る。方向で窓がずれるので、上り下りどちらを問われたかで採用窓を変える。2026-4 と 2026-5 の両方を見る。minYearMonth〜maxYearMonth の範囲外なら「予測の提供対象外」として扱う (例: maxYearMonth が 2026-10 なら年末年始は範囲外)。hourlyTrafficjam[].date (例 8月18日 (日)) で比較する。ゼロ埋めなしの和文日付なので、test("6日") のような部分一致は 16日 26日 を巻き込む。日で絞るなら完全一致か境界つき正規表現を使う。trafficJam の各エントリは routeName を自前で持つので、routeId を引かずに路線名で直接絞れる。指定年月・路線名 (部分一致) の予測を上り下りまとめて取り出す。
jq -c --arg m "2026-8" --arg r "東名" '
.trafficJam[$m] | to_entries[] | .value
| (.directionUp + .directionDown)[]
| select(.routeName | test($r))
' highway.json
test($r) は部分一致なので、東名 は 新東名 や 東名阪 も巻き込む。単一路線に確定したいときは select(.routeName == "東名高速道路") の完全一致か境界つき正規表現を使い、部分一致は下の候補引きに留める。
正式な路線名が分からなければ routeList で候補を引く。
jq -r '.routeList[] | select(.name | test("東名|東北")) | "\(.routeId)\t\(.name)"' highway.json
trafficJam[年月][routeId].directionUp[] (下りは directionDown) の 1 要素が「ある区間・ある予測日 (または日グループ)」の渋滞予測。同一区間でも予測日ごとに別要素として並ぶ。
| キー | 意味 |
|---|---|
routeName direction | 路線名・方向 (上り / 下り)。 |
section | 区間 (例 横浜青葉IC→東京IC)。 |
timeZone | 渋滞が見込まれる時間帯 (例 06:00～17:00)。hourlyTrafficjam の時間窓と食い違うことがある。提示は timeZone を大枠、hourlyTrafficjam を実数として併記する。 |
peakDistance peakTime | ピーク時の渋滞長と時刻 (例 10km / 7時)。 |
bottleneck | 渋滞の先頭になりやすい地点 (例 東京IC付近)。 |
requiredTimeNormal | 平常時所要時間 (H:MM)。 |
requiredTimeTrafficjam | 渋滞時所要時間。 |
requiredTimeIncrease | 増加分。 |
cause | 渋滞要因。データ無しは ―。 |
hourlyTrafficjam | 予測日・時間帯別の渋滞長配列。{date, time, distance} (距離は km の数値)。time は 7時台 の単一時台と 7～8時台 のレンジの 2 形式がある。 |
「ピークはいつか」を答えるには、該当区間の複数エントリを跨いで hourlyTrafficjam[].distance を比較する。peakTime/peakDistance は各エントリ内の代表値であり、月内最大とは限らない。区間指定がない依頼では、方向内の全区間の hourlyTrafficjam を横断して比較する。判定は次の順で行う: (1) 対象窓 (お盆等) で日付を絞る → (2) 窓内の distance 最大を採る → (3) 同値が並ぶ場合は渋滞時間帯の長さで tie-break する (time のレンジをパースして時間数を数える。パースが煩雑なら同値エントリ数で代替してよい)。窓外に同値以上のピークがあれば補足として言及する。
口語の路線名 (「東名」等) が複数の正式名に部分一致する場合は、最短一致の路線 (「東名」なら東名高速道路) を主として扱い、近縁路線 (新東名等) の存在を一言添える。
路線だけ指定された依頼では方向別に全区間を提示してよいが、長距離路線で区間が複数の地方に散る場合は、想定エリア (例: 首都圏側か中京側か) の確認を促す一文を添える。
行楽期・祭事など特定イベント周辺の一般道渋滞予測と迂回案内。高速のような網羅的・恒常的データではなく、シーズンごとに対象イベントが入れ替わる。
curl -sS 'https://www.jartic.or.jp/d/service/trafficjam/general.json' -o general.json
jq '{updateDate, prefsWithData: [to_entries[] | select(.value|type=="array" and length>0) | .key]}' general.json
トップレベルは updateDate と、都道府県別キー R01〜R47。各キーの値はイベント単位のオブジェクト配列 (該当無しは空配列)。updateDate がシーズンを反映するため古いことがある。古ければ「現在のイベントではなく前シーズンの予測」である旨を添える。
R01 北海道 R02 青森 R03 岩手 R04 宮城 R05 秋田 R06 山形 R07 福島
R08 茨城 R09 栃木 R10 群馬 R11 埼玉 R12 千葉 R13 東京 R14 神奈川
R15 新潟 R16 富山 R17 石川 R18 福井 R19 山梨 R20 長野 R21 岐阜
R22 静岡 R23 愛知 R24 三重 R25 滋賀 R26 京都 R27 大阪 R28 兵庫
R29 奈良 R30 和歌山 R31 鳥取 R32 島根 R33 岡山 R34 広島 R35 山口
R36 徳島 R37 香川 R38 愛媛 R39 高知 R40 福岡 R41 佐賀 R42 長崎
R43 熊本 R44 大分 R45 宮崎 R46 鹿児島 R47 沖縄
都道府県で引く、またはイベント名で全国横断検索する。
jq '.R13' general.json
jq '[.[] | select(type=="array") | .[] | select(.destination | test("さくら"))]' general.json
イベントによっては迂回データを持たず routeDetailList の各フィールドが ― のことがある。迂回路の提示が目的なら、detourSection が ― でないイベントを先に絞ってから選ぶ。
jq -c '[.[] | select(type=="array") | .[] | select(any(.routeDetailList[]; .detourSection != "―"))]' general.json
イベント 1 件のフィールド。
| キー | 意味 |
|---|---|
destination | 目的地・イベント名 (例 弘前公園 弘前さくら祭り)。 |
startPoint | 渋滞の起点となる交差点等。 |
targetDays | 対象期間 (例 4月17日（金）～5月5日（火）)。 |
routeDetailList | 経路別の予測・迂回案内の配列 (下記)。 |
routeDetailList[] の各要素。
| キー | 意味 |
|---|---|
routeName | 道路名 (例 （国）７ （県）260石川百田線)。 |
direction | 方向。 |
timeZone | 渋滞が見込まれる時間帯。 |
peakLength peakTime | ピーク渋滞長とその通過所要時間。 |
requiredTimeNormal | 平常時所要時間。 |
detourSection | 迂回路の区間。 |
detourLength | 迂回路の距離。 |
comment | 迂回手順等の補足。 |
comment は迂回手順だけでなく目的地・前提 (例: 特定の駐車場へ至る経路) を含むことがある。前提ごと提示し、目的地が異なるユーザに汎用の迂回路と誤認させない。
渋滞データ本体ではなく、渋滞予測資料 (記者発表 PDF 等) への告知バナー。
visibility が false のときサイト上で非表示。データが無い・期限切れの状態でも返ることがある。summaryText は HTML 断片で、５ のような数値文字参照 (全角数字等) を含む。提示時はデコードし、タグを除く。file は資料 PDF のファイル名。渋滞の予測値そのものは含まない。補足情報としてのみ扱う。updateDate を添える。general.json はシーズン外だと古い・空になりやすい。updateDate が新しいのに全都道府県が空の場合はシーズン間の掲載空白であり、「現時点で掲載イベントなし」と答え、対象イベントのシーズンが近づいた時点での再取得を提案する。highway.json で対象月が 0 件 (trafficJam[年月] が無い、または路線が空) のときは、minYearMonth/maxYearMonth で範囲を確認し、範囲外なら「予測の提供対象外」と答える。範囲内で空なら、その路線・月に渋滞予測が立っていない (=渋滞予測なし) と解する。routeList の name 一覧、または general.json の destination 一覧を提示して綴り・名称を確認する。憶測で別路線を当てない。highway.json をエージェントへ丸読みさせない。jq で年月・路線へ絞ってから読む。-o /tmp/highway.json)、bash の作業ディレクトリに依存させない。後続の jq も同じ絶対パスを参照する。使用後に削除する。実行環境によっては/tmp がコマンド呼び出し間で永続しないことがあるため、後続の jq の前にファイルの存在を確認し、無ければ再取得する。登山対象の山の天気を、てんくらの登山指数 (A/B/C) ・気象庁の麓の天気・Open-Meteo の山頂標高指定の数値予報・標高差からの推定で判断する手順。 「○○山の天気」「登山の天気」「明日山に登れるか」「登山指数」「山頂の気温」などを聞かれた際に使う。 てんくらの登山指数は無料のサーバ HTML から取得でき、気象庁の麓・登山口周辺の気象と Open-Meteo の山頂標高指定の数値予報を併せて判断する。 山頂のピンポイント気象数値そのものは保証されないため、指数・麓の天気・数値予報・推定で総合判断し、その限界をユーザに伝える。
指定ユーザ (主に自分自身) の Bluesky の情報を公開 API から取得する手順。直近の投稿内容・関心トピック・フォローしている人・フォローされている人を把握したい際に使う。「最近何を投稿したか」「旅行の写真を見たい」「誰をフォローしているか」「フォロワーは誰か」などが対象。フォロー先の傾向から関心分野を推し量る用途にも使う。 AT Protocol の公開 AppView (public.api.bsky.app) を認証なしで叩く。投稿は app.bsky.feed.getAuthorFeed、プロフィールと各種件数は app.bsky.actor.getProfile、フォロー/フォロワーは app.bsky.graph.getFollows / getFollowers を使う。画像はダウンロード後に ffmpeg でリサイズして表示する。 対象は公開情報のみ。いいね一覧など認証必須のデータの取得や、投稿・フォローの作成/削除はできない。
Discord の REST API を curl で叩いてサーバ (ギルド) を操作する手順。メッセージの送信・取得・検索、リアクション付与、スレッドの作成・名前変更、チャンネルやメンバーの一覧・検索が対象。「Discord にメッセージを送る」「チャンネルの発言を読む」「スレッドを立てる」「スレッド名を変える」「メンバーを検索する」などで使う。 bot トークンを Authorization の Bot ヘッダで渡し、 https://discord.com/api/v10 を叩く。トークンは環境変数 DISCORD_BOT_TOKEN から取る。メッセージ検索の API は bot に無いため、履歴を取得して jq でフィルタする。 対象は bot トークンで操作できる範囲のサーバ機能。レート制限 (429) は自前で Retry-After を見て待つ。ユーザ DM や OAuth が要る操作、Gateway (リアルタイム受信) は扱わない。
指定の道路・エリアの現在の交通量を JARTIC 交通量 API (国土交通省) から取得する手順。「国道◯号の今の交通量」「◯◯付近の混雑」など、特定の道路や地点の最新交通量を聞かれた際に使う。 地名・道路名を国土地理院ジオコーディングで緯度経度へ変換し、WFS 2.0.0 GetFeature を BBOX と時間コードで叩く。対象は高速自動車国道と一般国道のみで、県道・市道は取得できない。
指定テーマの最新ニュースを優先ソースから N 件集め、各記事をタイトル・要約・公開日・個別 URL の形にまとめて返す手順。「バイクの最新ニュースを集めて」「セキュリティ分野の注目記事を要約して」「最近の登山界隈の動きをまとめて」のように、特定テーマの新着記事を収集して要約したい際に使う。 優先ソースに RSS/Atom があればフィードを先に取得し、無ければ一般 Web 検索で補う。期間と除外リストでフィルタし、件数分を選んで各記事を要約する。 出力はタイトル・要約・公開日・個別 URL の中立フォーマット。Discord 等への整形・投稿は呼び出し側で行う前提で、この skill には含めない。
ユーザの登山履歴・各山行のタイム・ペース、および登山計画 (予定行程) をヤマレコ (yamareco.com) から取得する手順。登山計画の所要時間予測や、過去実績からのペース倍率の集計、ヤマレコに登録済みの計画の予定行程・距離・累積標高の確認を求められた際に使う。 山行リスト・計画リストは API、個別山行および個別計画の詳細は公開設定のもののみ HTML から抽出する。