메뉴
ユーザの登山履歴・各山行のタイム・ペース、および登山計画 (予定行程) をヤマレコ (yamareco.com) から取得する手順。登山計画の所要時間予測や、過去実績からのペース倍率の集計、ヤマレコに登録済みの計画の予定行程・距離・累積標高の確認を求められた際に使う。 山行リスト・計画リストは API、個別山行および個別計画の詳細は公開設定のもののみ HTML から抽出する。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | yamareco |
| description | ユーザの登山履歴・各山行のタイム・ペース、および登山計画 (予定行程) をヤマレコ (yamareco.com) から取得する手順。登山計画の所要時間予測や、過去実績からのペース倍率の集計、ヤマレコに登録済みの計画の予定行程・距離・累積標高の確認を求められた際に使う。 山行リスト・計画リストは API、個別山行および個別計画の詳細は公開設定のもののみ HTML から抽出する。 |
ユーザの登山履歴・各山行のタイム・ペースを取得する手順。
curl -s 'https://api.yamareco.com/api/v1/getReclist/user/{userId}/{page}' \
--header 'Accept: application/json'
{userId} はヤマレコユーザ ID (数値)。プロフィールページ URL https://www.yamareco.com/modules/yamareco/userinfo-{userId}-prof.html の userinfo- と -prof の間の数値 (例: userinfo-1005182-prof.html なら 1005182)。不明ならユーザに確認する{page} はページ番号 (1 始まり)。母集合を揃えるには page=1 から辿る。終端を過ぎると reclist が空配列ではなく reclist キー自体が無い {"err":1,"errcode":"NODATA"} が返る。終端判定は reclist キーの有無で行い、errcode 文字列値には依存しない (計画リストも終端で同じ NODATA を返すため、文字列で見分けようとすると取り違える)reclist[].rec_id が個別山行の IDreclist[].permission.guest が "1" ならゲスト閲覧可、"0" なら非公開。集計時は guest="1" の山行のみ対象とし、"0" は除外して継続する (どうしても必要なら公開設定をユーザに依頼する)reclist[].place/start/end/area などで概要把握可能reclist[].page_url に詳細ページの HTML URL (後述)GET /api/v1/getRec/{rec_id} は OAuth 認証が必要で、未認証だと {"err":1,"message":"App does not have a valid scope."} が返る。
現状は API では詳細取れない。HTML から抽出する。
公開設定 (permission.guest=1) の山行のみ取得可能。
# 1. HTML 取得 (User-Agent 必須、403 を避ける)
# 一時ファイルは rec_id で一意化する。固定パス (/tmp/y.html 等) は
# 複数山行のループや並列実行で互いに上書きし、別山行の値を掴む。
# 形式的なサニティチェックは通過してしまうので発見が難しい。
curl -s -A "Mozilla/5.0" \
"https://www.yamareco.com/modules/yamareco/detail-{rec_id}.html" \
-o "/tmp/yamareco-{rec_id}.html"
# 2. EUC-JP -> UTF-8 変換
iconv -f EUC-JP -t UTF-8//IGNORE "/tmp/yamareco-{rec_id}.html" > "/tmp/yamareco-{rec_id}-utf8.html"
複数山行を扱う場合も、各 rec_id ごとに上記の取得・変換・抽出を完結させてから次の rec_id へ進む。{rec_id} を含むパスを使えば取り違えが起きない。
UTF-8//IGNORE を付ける (実際に一部の山行ページで illegal input sequence が起きる)UTF-8 変換後の HTML を Grep する。
| 項目 | パターン |
|---|---|
| 山行時間 | class="time1">[0-9:]+ |
| 休憩時間 | class="time2">[0-9:]+ |
| 合計時間 | class="time3">[0-9:]+ |
| 距離・登り・下り | font-weight:bold;font-size:18px;">[0-9.,]+</span>(km|m) |
| ペース区分(参考) | pace[1-4]">[^<]+(とても速い / 速い / 標準 等、表記は倍率帯で変わる) |
| ペース倍率(範囲) | pace-num.{1,150} 内の font-en">[0-9.]+(下限・上限の2値) |
time1/time2/time3 は HTML 内に複数マッチがあるので最初の 1 件を採用すること (コースタイム表示用と日付表示用が混在)。
距離・登り・下りは同一パターンで 3 値が連続マッチする。HTML 上の出現順に距離 → 登り → 下りが対応する。登り・下りが 1000 以上だと 1,747 のように桁区切りカンマが入るので、パターンは [0-9.,]+ でカンマを含めて拾う([0-9.]+ だと取りこぼして 3 値に満たず、正常データを誤って構造変化と判定する)。数値化する際はカンマを除去する。マッチ数が 3 でない場合は構造変化とみなし、後述の 0 件時と同様に処理を止めて報告する。
各抽出の直後にサニティチェックを行う。推測で値を埋めない。
^[0-9]{1,2}:[0-9]{2}$、距離・標高は正の数値であることを確認する。pace-num の倍率) で期待するマッチが0 件のときは HTML 構造が変わった可能性が高い。値を捏造せず、処理を止めて構造変化を疑い、ユーザに報告する。一方、ペース区分ラベル pace[1-4] は参考情報なので、0 件でも欠落として扱い処理を継続する (捏造しない)。pace-num 内に下限・上限の 2 値が出る。2 値揃わない場合は範囲表記の構造変化を疑う。ヤマレコの「らくルート」標準コースタイムを 1.0 としたときの倍率。pace-num は単一値ではなく下限〜上限の範囲で出力される (font-en が 2 値、区切りは 〜 = ～)。
**範囲は 1 値に畳まない。**下限・上限の両方を保持してユーザにそのまま範囲で伝え、状況 (体調・天候・荷物・予備時間) に応じてどの値を採るかはユーザに選ばせる。下限に丸めると倍率を低く (= 速く) 見積もって所要時間を短く出すため、後述「楽観しすぎるな」と矛盾する。中点・上限を skill 側で決め打ちするのも同様に避ける。
区分の早見表は次のとおり (半開区間。下限以上・上限未満で全域を被覆し、境界値の帰属が一意)。
倍率が範囲なので、区分も下限・上限それぞれで引き、またがる場合は両区分を併記して報告する。区分名自体に「〜」を含むものがあるため「〜」で単純連結せず、側を明示する (例: 範囲[0.60 〜 0.70]なら「下限 0.60 は速い〜とても速い、上限 0.70 は速い」)。抽出パターン pace[1-4] の文字列ラベル (とても速い/速い/標準等、表記は倍率帯で変わる) は参考情報で、上の 5 区分とは対応させない。ラベル文言が上の区分名と食い違っても気にしない (別系統)。報告に載せる場合は「参考ラベル」等の別欄にし、5 区分の判定と混在させない (載せなくてもよい)。
ユーザの過去実績を集めれば、未経験ルートの所要時間を標準 CT × 倍率で予測できる。倍率が範囲なので予測も範囲で出す。集計は次の規則で行う。
getReclist を page=1 から辿り、permission.guest="1" の山行を対象とする。直近 10 件程度を目安とし、季節・山域が偏らないよう選ぶ。ユーザが件数を明示した場合はそちらを優先し、目安との乖離が信頼度に影響する (少数・偏りがある) 場合はその旨を注記する。10 件は明確な上限ではなく、多少超えても偏りがなければ全件使ってよい (恣意的に間引かない)。倍率を抽出できた有効件数が 3 件に満たない場合は page を進めて補充する (上限の目安 5 ページ/50 件。届かなければ信頼度が低い旨を明示)。pace-num 内の下限・上限の 2 値) を抽出する。抽出できない山行は母集合から除外する。ユーザがヤマレコに登録済みの登山計画の一覧を取得する。
curl -s 'https://api.yamareco.com/api/v1/getPlanlist/user/{userId}/{page}' \
--header 'Accept: application/json'
{userId}/{page} は山行リストと同じ (ユーザ ID と 1 始まりのページ番号)。終端を過ぎると planlist キー自体が無い {"err":1,"errcode":"NODATA"} が返る。山行リストと同じく終端判定は planlist キーの有無で行い、errcode 文字列値には依存しない (記録リストと終端レスポンスが同形なので、NODATA 等の文字列で見分けない)planlist[].plan_id が個別計画の IDpermission.guest="1" が公開だが、計画は planlist[].private が "0" で公開、"1" で非公開 (OpenAPI の PlanSummary 準拠)。取得対象は private="0" のみとし、"1" は除外して継続するplanlist[].place/start/end/days/area/genre で概要把握可能planlist[].nodate が "1" の計画は日程未定で、start/end/days は意味を持たないplanlist[].page_url に詳細ページの HTML URL (後述)GET /api/v1/getPlan/{plan_id} は山行詳細の getRec と同じく OAuth 認証が必要で、未認証だと App does not have a valid scope. が返る。
計画詳細も API では取れない。HTML から抽出する。
公開設定 (private="0") の計画のみ取得可能。URL は山行と別モジュール (yr_plan) なので注意する。
# 1. HTML 取得 (User-Agent 必須、403 を避ける)。一時ファイルは plan_id で一意化する
curl -s -A "Mozilla/5.0" \
"https://www.yamareco.com/modules/yr_plan/detail-{plan_id}.html" \
-o "/tmp/yamareco-plan-{plan_id}.html"
# 2. EUC-JP -> UTF-8 変換
iconv -f EUC-JP -t UTF-8//IGNORE "/tmp/yamareco-plan-{plan_id}.html" > "/tmp/yamareco-plan-{plan_id}-utf8.html"
注意点は山行 HTML と同じ。 WebFetch は 403、 EUC-JP 変換必須、 plan_id でパスを一意化する。
計画 HTML の構造は山行詳細ページと別物。山行側の実績時間 time1/time2/time3 は計画ページには無い (計画は実績ではないため)。pace-num 倍率は計画ページにもあるが意味が違う。山行の pace-num は実際に出た実績倍率の範囲、計画の pace-num は計画作成時にユーザが設定した予定倍率の単一値で、行動予定の時刻はこの予定倍率で算出されている (後述)。混同しないこと。
距離・累積標高は <dl> の <dt class="..."> で項目を示し、値はその次行の <dd> に入る。実 HTML では dt と dd が別の行に分かれているので、1 行で dt ... dd をまとめて grep すると 0 件になる。dt にマッチさせてから後続行の dd を拾うこと (例: grep -A1 で dt の次行を見る、または grep -ozP 等で改行をまたいで取得する)。
| 項目 | dt (項目行) | 次行の dd (値) |
|---|---|---|
| 距離 | <dt class="distance">距離</dt> | <dd>[0-9.,]+<span>km |
| 上り (累積標高) | <dt class="up">上り</dt> | <dd>[0-9.,]+<span>m |
| 下り (累積標高) | <dt class="down">下り</dt> | <dd>[0-9.,]+<span>m |
計画タイム (コースタイムの合計) と行動予定 (通過予定時刻列) を取得する。計画ページには新旧 2 つのレイアウトがあり、どちらが使われるかはページごとに異なる。両方を試し、片方が無いだけで「未入力」と断じない。
コースタイムの合計 (補正の入力に使う計画タイム) は次のように取得する。
record-detail-content-time-block-head の totaltime 内に、<dt>山行</dt><dd class="time1">9:45</dd>/<dt>休憩</dt><dd class="time2">0:00</dd>/<dt>合計</dt><dd class="time3">9:45</dd> の形で直接入る (記録ページと同じ time1/time2/time3 クラス)。補正にはこの合計 (time3、行動だけなら time1) を計画タイムとして使う。端点の時刻差を手計算するより正確。なお同じ totaltime 構造で距離・登り・下りも dd class="time2" で出るため、time2 を広域 grep すると休憩時間と距離が混ざる。山行/休憩/合計 の dt ラベルや totaltime 領域に絞って拾う。totaltime の合計が無い。後述の行動予定の通過時刻列から、最初 (出発) と最後 (下山) の時刻差で行程の幅を出す (端点差は休憩込みで粗い近似)。行動予定 (通過予定時刻列) は次のように取得する。
record-detail-content-time-block-timelline 内に <div class="item ..."> が地点順に並び、1 item = 1 地点である。item 内の <div class="name"> が地点名、<div class="time1">HH:MM</div> が通過予定時刻。時刻だけ拾うと地点との対応が示せないので、item 単位で name と time1 を組にして抽出する (どちらも値は開きタグの次行以降にある)。name の中身はリンク付き (<a> 入り) とプレーンテキストの 2 形態があるため、閉じタグまでを取って内部タグを剥がしてから trim する。往復・周回計画では同名地点が正当に重複するので、出現順を保持し重複を除去しない。item class はページ後方の別文脈 (地図商品欄等) にも出現するため、まず timelline の親コンテナの範囲を切り出してからその内側でマッチする (ファイル全体から <div class="item" を拾わない)。item ブロックの切り方は、コンテナ内を item の開きタグで split し、各断片から最初の name と time1 を取る形でよい。record-detail-content-time-text の <div> 内に 地点名 23:00 → 01:08 次の地点 → … → 08:58 地点名 (下山) の形でインラインに並ぶ (区切りは → = →)。最初の時刻が出発、最後の時刻が下山予定で、日をまたぐ計画は時刻が一周する点に注意する。いずれのレイアウトも値は開きタグの次行以降にあり、距離・累積標高と同じく行をまたいで取得する (1 行 grep では空振りする)。開きタグにマッチさせて後続行を拾うか、開きタグから閉じタグまでの行範囲を sed 等で切り出す。grep -ozP を使うなら改行を含む文字クラス ([\s\S] 等) でないと拾えない。
計画の予定倍率は class="record-detail-content-pace" の領域内、pace-num の font-en に単一値で入る (記録のような下限・上限の範囲ではない)。ラベルは label-pace pace[1-4] (標準等、参考)。これは計画作成時にユーザが設定した倍率で、行動予定の時刻はこの倍率で計算されている。多くは 1.0 (標準) だがユーザが変更でき計画ごとに異なるので、必ず抽出して確認し 1.0 と決め打ちしない。
| 項目 | パターン |
|---|---|
| 計画の予定倍率 | pace-num の数行先の font-en">[0-9.]+ (単一値) |
| ペース区分ラベル | label-pace pace[1-4]">[^<]+ (標準 等、参考) |
pace-num と font-en は別行に分かれる場合と同一行に収まる場合の両方がある。行をまたぐ取得 (grep -A3 や -ozP) は同一行も包含するので、常に行またぎ前提で拾えば両形態に対応できる。
1,425 のように桁区切りカンマが入るので [0-9.,]+ で拾い、数値化時にカンマを除去する。grep -A1/-ozP) で拾えているかを確認する。dt と dd が別行なので 1 行 grep では正常な HTML でも 0 件になり、これを構造変化と取り違えやすい。行をまたいでも 0 件のときに限り HTML 構造が変わった可能性が高いとみなし、値を捏造せず処理を止めて構造変化を疑い、報告する。record-detail-content-time-block-timelline と record-detail-content-time-text) を確認し、どちらにも時刻列が無いときのみコースタイム未入力とみなす。片方の class が無いだけで「未入力」と断じない。未入力なら捏造せず「予定行程は未入力」として扱う。class 名は <style> 内の CSS 定義にも出現するため、存在判定は単純な出現カウントでなく開きタグ形 (class="..." を含むタグ) でマッチする。pace-num 内に単一値で出る。下限・上限の 2 値が出たら記録ページと取り違えている。値が取れないときは 1.0 と仮定せず、未取得として扱い後述の補正では安全側 (遅い前提) に倒す。ユーザがヤマレコに計画を登録済みなら、「登山計画リスト取得」「個別計画の詳細取得」でその計画の予定行程・距離・累積標高・予定倍率を直接取得できる。
計画の行動予定の時刻は、その計画の予定倍率 (pace-num。多くは 1.0 = 標準 CT だが計画ごとに確認する) で算出されている。予定倍率は「標準的な歩き手」の想定であって、ユーザ自身の実力ではない。ユーザの実力倍率 (記録側で実測される範囲) と食い違う分だけ、実際の所要時間は計画とずれる。この差を埋めて現実的なタイムを伝える。
計画の行動予定タイムを、ユーザの実力に合わせた現実的タイムへ補正する。安全に直結する。下記ガードレールを必ず守る。
補正式は次のとおり (範囲は範囲のまま、1 値に畳まない)。
現実タイムの範囲 = 計画タイム × (ユーザ実力倍率の範囲 [下限 〜 上限] / 計画の予定倍率)
DANGER ガードレール。倍率を小さく報告して入山し事故った場合の被害は甚大なので、下振れ方向への丸めは禁止する。
登山対象の山の天気を、てんくらの登山指数 (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 (日本道路交通情報センター) が公開する渋滞「予測」データを取得する手順。ゴールデンウィーク・お盆・年末年始・行楽期の高速道路の渋滞予測、ピーク日時、◯◯祭りなどイベント周辺の一般道渋滞と迂回路を聞かれた際に使う。 `www.jartic.or.jp` の JSON を curl で取得し、路線名・年月・都道府県を `jq` で絞り込む。返るのは将来の予測であって現在の実況交通量ではない。今この瞬間の交通量・渋滞長を求められた場合はこの手順では取得できない。
指定の道路・エリアの現在の交通量を JARTIC 交通量 API (国土交通省) から取得する手順。「国道◯号の今の交通量」「◯◯付近の混雑」など、特定の道路や地点の最新交通量を聞かれた際に使う。 地名・道路名を国土地理院ジオコーディングで緯度経度へ変換し、WFS 2.0.0 GetFeature を BBOX と時間コードで叩く。対象は高速自動車国道と一般国道のみで、県道・市道は取得できない。
指定テーマの最新ニュースを優先ソースから N 件集め、各記事をタイトル・要約・公開日・個別 URL の形にまとめて返す手順。「バイクの最新ニュースを集めて」「セキュリティ分野の注目記事を要約して」「最近の登山界隈の動きをまとめて」のように、特定テーマの新着記事を収集して要約したい際に使う。 優先ソースに RSS/Atom があればフィードを先に取得し、無ければ一般 Web 検索で補う。期間と除外リストでフィルタし、件数分を選んで各記事を要約する。 出力はタイトル・要約・公開日・個別 URL の中立フォーマット。Discord 等への整形・投稿は呼び出し側で行う前提で、この skill には含めない。