pp-opensnow

OpenSnow — Printing Press CLI

前提条件：CLI のインストール

このスキルは opensnow-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**インストールされていない場合は、先にインストールしてください。

1. Printing Press インストーラーを使ってインストールします。バイナリの既定のインストール先は、macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin です。

   npx -y @mvanhorn/printing-press-library install opensnow --cli-only
   

2. 確認します：opensnow-pp-cli --version
3. このスキルを実行するエージェント／ランタイムの $PATH に、表示されたインストール先のディレクトリが含まれていることを確認します。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go を直接インストールしてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/productivity/opensnow/cmd/opensnow-pp-cli@latest

インストール後に --version が「command not found」と表示する場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できていません。確認が成功するまで、スキルのコマンドを実行しないでください。

この CLI を使う場合

雪に特化した詳細情報（昼夜別の降雪量、パウダーの質、リゾートの営業状況など）を含む山岳地帯の天気予報が必要な場合は、OpenSnow CLI を使ってください。リゾートの比較、ストームの追跡、または「今週末はどこでスキーをするのがよい？」という質問への回答が必要な旅行計画エージェントに最適です。Daily Snow ダイジェストでは、一般的な天気 API では得られない、専門の気象予報士による分析を提供します。

この CLI を使わない場合

作成、更新、削除、公開、コメント、賛成票の投票、招待、注文、メッセージの送信、予約、購入、またはリモートの状態変更が必要なリクエストでは、この CLI を有効にしないでください。この Printing Press CLI が公開するのは、確認、エクスポート、同期、分析のための読み取り専用コマンドです。

独自の機能

この API を利用する他のツールでは、次の機能は利用できません。

パウダー情報

• powder-score — 予報降雪量、風、気温、過去の平均値を組み合わせ、1～10日先の日ごとにパウダーの質を評価します。

  エージェントが今週スキーをするのに最適な日を1日だけおすすめする場合、生の予報数値ではなく、スコア付きの順位をこのコマンドで確認できます。

  opensnow-pp-cli powder-score alta --days 5 --agent
  

• powder-rank — 予想降雪量、積雪の深さ、滑走可能な地形の状況を組み合わせ、同期済みのすべてのリゾートをパウダーの見込みで順位付けします。

  エージェントが「今週末、コロラドでどこを滑るのがよい？」という質問に答える場合、スコア付きの順位リストを確認できます。

  opensnow-pp-cli powder-rank --slugs alta,steamboat,telluride --agent
  

• storm-track — 時間とともに変化する直近の時間別予報を照合し、ストームの推移（雪が降り始める時刻、ピーク、終了時刻）を表示します。

  ストームに合わせて移動を計画する場合、到着に適した時刻とストームの期間が終わる時刻を正確に確認できます。

  opensnow-pp-cli storm-track telluride --agent
  

• overnight — お気に入りのリゾートについて、夜間の半日予報を確認できます。パウダーを求める人が朝に行う習慣的な確認に便利です。

  スキーヤーがまず尋ねるのは「夜の間にどれくらい雪が降った？」ということです。お気に入りのリゾートすべてについて、1回の呼び出しで回答できます。

  opensnow-pp-cli overnight --agent
  

蓄積されるローカル状態

• dashboard — お気に入りのすべての場所について、現在の気温、過去24時間の降雪量、5日間の合計降雪量、営業状況を1つのコマンドで表示します。

  OpenSnow アプリを開く代わりに、1つのコマンドですべての情報を表示できます。エージェントは、ユーザーが好む山について必要な情報をすべて確認できます。

  opensnow-pp-cli dashboard --agent
  

• diff — 現在の積雪情報を前回同期したバージョンと比較し、新雪、リフトの開閉、状況の変化などを確認できます。

  リゾートの状況を監視するエージェントは、生のレポートを解析せずに、重要な変化を検出できます。

  opensnow-pp-cli diff alta --agent
  

• history — キャッシュされたレポートのスナップショットから、降雪量の推移、シーズン累計と平均値の比較、積雪の深さの変化を表示します。

  数週間先の旅行を計画する場合、過去の情報から山の状況が上向きか下向きかを確認できます。

  opensnow-pp-cli history steamboat --days 30 --agent
  

エージェント向けの連携機能

• digest — お気に入りの地域の Daily Snow 投稿をすべて取得し、HTML を読みやすいテキストに変換して、ダイジェストを表示します。

  OpenSnow の気象予報士による専門的な予報を、ブラウザーを使わずにエージェントやターミナル向けに表示します。

  opensnow-pp-cli digest --region colorado,tahoe --agent
  

コマンドリファレンス

daily-reads — 日次リードを管理します

forecast — 予報を管理します

• opensnow-pp-cli forecast get-by-point — 地球上の陸地にある任意の経度・緯度の地点の予報を取得します。現在の状況、1時間ごとの詳細などを返します…
• opensnow-pp-cli forecast get-detail — OpenSnow の任意の名称付きロケーションの5日間予報を取得します。現在、1時間ごと、日ごとの予報などを返します…
• opensnow-pp-cli forecast get-snow-detail — OpenSnow の任意の名称付きロケーションの5日間の日中・夜間の降雪予報を取得します。時間帯は日中（午前6時〜午後6時）と…

snow-report — 積雪レポートを管理します

• opensnow-pp-cli snow-report <id_or_slug> — 最新の積雪レポートを取得します。スキー場が報告する降雪量、積雪深、営業状況、コンディションなどを確認できます…

適切なコマンドを見つける

実行したいことはわかっていても、どのコマンドを使えばよいかわからない場合は、CLI に直接問い合わせてください。

opensnow-pp-cli which "<capability in your own words>"

which は、自然言語による機能の問い合わせを、この CLI の厳選された機能インデックス内で最も適したコマンドに解決します。終了コード 0 は少なくとも1つ一致したことを示し、終了コード 2 は確かな一致がないことを示します。その場合は --help を確認するか、より具体的な問い合わせを使ってください。

レシピ

今週最高のパウダーデー

opensnow-pp-cli powder-rank --slugs alta,steamboat,telluride --agent --select resort,score,expected_snow,conditions

同期済みのコロラド州の全スキー場を、今後5日間のパウダーの可能性で順位付けし、エージェントが利用する主要なフィールドだけを返します。

朝の積雪チェック

opensnow-pp-cli overnight --agent --select name,precip_snow,conditions_label

お気に入りの全スキー場の夜間の降雪量をすばやく確認できます。パウダーハンターの朝の日課です。

2つのスキー場を比較

opensnow-pp-cli compare alta steamboat --agent

旅行の計画に役立つ、予報とコンディションの並列比較です。

エキスパートによる予報ダイジェスト

opensnow-pp-cli digest --region colorado --agent

OpenSnow の気象専門家による本日の Daily Snow を、ターミナルで読みやすい形式で確認できます。

ストームの監視

opensnow-pp-cli storm-track telluride --agent --select period,precip_snow,wind_speed

エージェントのコンテキスト向けにフィールドを絞り、Telluride で次のストームがいつ始まり、ピークを迎え、終わるかを追跡します。

認証の設定

OpenSnow API の利用はパートナー限定です。opensnow-pp-cli config set-token <key> で API キーを設定してください。キーはローカルに保存され、すべてのリクエストでクエリパラメーターとして渡されます。アクセスレベル5では地点ベースの予報を利用でき、レベル10では名称付きロケーション、積雪レポート、Daily Snow が利用可能になります。

opensnow-pp-cli doctor を実行して設定を確認してください。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — stdout に JSON、stderr にエラーを出力します

• フィルター可能 — --select でフィールドを絞り込めます。ドット区切りのパスでネストされた構造をたどり、配列では各要素を走査します。出力が冗長な API でコンテキストを小さく保つために重要です。

  opensnow-pp-cli snow-report mock-value --agent --select id,name,status
  

• プレビュー可能 — --dry-run でリクエストを送信せずに内容を確認できます

• オフラインに対応 — 同期・検索コマンドは、利用可能な場合、ローカルの SQLite ストアを使用できます

• 非対話型 — プロンプトは表示されず、すべての入力をフラグで指定します

• 読み取り専用 — 作成、更新、削除、公開、コメント、賛成票、招待、注文、送信、その他の変更を伴うリクエストには、この CLI を使用しないでください

レスポンスエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力を情報源のエンベロープでラップします。

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を、ライブデータかローカルデータかの確認には .meta.source を解析してください。人が読める N results (live) の概要は、stdout がターミナルの場合に限り stderr に出力されます。パイプやエージェントで利用する場合、stdout には JSON のみが出力されます。

エージェントへのフィードバック

この CLI について気になる点があったら（エージェントが気づいた場合も含めて）、記録してください。

opensnow-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
opensnow-pp-cli feedback --stdin < notes.txt
opensnow-pp-cli feedback list --json --limit 10

エントリーは ~/.opensnow-pp-cli/feedback.jsonl にローカル保存されます。OPENSNOW_FEEDBACK_ENDPOINT が設定され、かつ --send が渡されるか、OPENSNOW_FEEDBACK_AUTO_SEND=true の場合を除き、POST されることはありません。デフォルトではローカルにのみ保存されます。

バグ報告ではなく、意外に感じたことを書いてください。短く、具体的に、1行で。それが積み重ねにつながります。

出力先への配信

すべてのコマンドで --deliver <sink> を指定できます。出力は stdout のほか、または stdout の代わりに指定した出力先へ送られるため、エージェントはコマンド結果を手作業でパイプに渡すことなく振り分けられます。対応している出力先は次の3種類です。

出力先	動作
stdout	デフォルト。stdout のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（tmp + rename）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

未対応のスキームを指定すると、対応するスキームを示す構造化エラーが返されます。Webhook の失敗時はゼロ以外の終了コードを返し、URL と HTTP ステータスを stderr に記録します。

名前付きプロファイル

プロファイルは、呼び出しのたびに再利用できるフラグ値の保存セットです。スケジュールされたエージェントが毎回、同じ設定で同じコマンドを実行する場合に使用します。これは HeyGen の「Beacon」パターンです。

opensnow-pp-cli profile save briefing --json
opensnow-pp-cli --profile briefing snow-report mock-value
opensnow-pp-cli profile list --json
opensnow-pp-cli profile show briefing
opensnow-pp-cli profile delete briefing --yes

明示的に指定したフラグは、常にプロファイルの値より優先されます。プロファイルの値はデフォルト値より優先されます。agent-context は available_profiles の下にすべての利用可能なプロファイルを一覧表示するため、情報を調べるエージェントは実行時にそれらを検出できます。

終了コード

コード	意味
0	成功
2	使用方法のエラー（引数が正しくありません）
3	リソースが見つかりません
4	認証が必要です
5	API エラー（上流の問題）
7	レート制限中です（待機して再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します。

1. 空、help、または --help → opensnow-pp-cli --help の出力を表示します
2. install で始まる → mcp で終わる場合は MCP のインストール、それ以外の場合は上記の前提条件を参照します
3. それ以外 → 直接使用（--agent を付けて CLI コマンドとして実行します）

MCP サーバーのインストール

1. MCP サーバーをインストールします。

   go install github.com/mvanhorn/printing-press-library/library/productivity/opensnow/cmd/opensnow-pp-mcp@latest
   

2. Claude Code に登録します。

   claude mcp add opensnow-pp-mcp -- opensnow-pp-mcp
   

3. 確認します：claude mcp list

直接使用

1. インストールされているか確認します：which opensnow-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある前提条件を参照してください）。
2. ユーザーのクエリに最適なコマンドを、上記の独自機能とコマンドリファレンスから選びます。
3. --agent フラグを付けて実行します。

   opensnow-pp-cli <command> [subcommand] [args] --agent
   

4. あいまいな場合は、サブコマンドのヘルプを確認します：opensnow-pp-cli <command> --help