power-get

公開一次ソースのデータを取得して CSV(Excel 互換 UTF-8 BOM) で保存する。取得ロジックは scripts/power_data.py、実行は scripts/power_get.py。

ライトパス（既定）

一つずつ問い詰めず、提案して確認する流れにする。

1. 発話から dataset・期間・エリアを抜き出す（例:「東京のスポット、昨日分」→ dataset=spot, area=東京, date=昨日）。dataset が読み取れない/曖昧なら python power_get.py datasets（ネットワーク不要のpeek）で一覧を見せ、選んでもらう。
2. 未指定項目は既定値を推論して提案する（黙って決め打ちしない。提案した上で確認を取る）:
   • 日付未指定の既定: spot/intraday=昨日（スポットは前日10時台に翌日分の約定結果として公表されるため、当日時点で確実に取れるのは前日分）／reserve=翌日（広域予備率は翌日の見通しを見る用途が主）／area-actual=先月（月次・四半期公表が多いため）。
   • エリア未指定 → まず power_profile の常用エリア（/power-setup で登録可）を参照。無ければ質問する（推測で決めない）。
   • area-actual を要求されたら、対応は東京/九州/北海道のみである旨を先に伝える。他エリアの需給を見たいなら reserve（広域予備率）を代替案として提示する。
3. python power_get.py --dataset <..> ... --dry-run を実行し、解決済みパラメータと保存予定ファイル名を提示する（ネットワーク未接続・ファイル未生成）。--year を使う場合は**年度（4月始まり。例: 2026-07-13は2026年度、2026-03-31は2025年度）**である点を明示する。日付（--date）だけ渡せば年度・期間形式は自動導出されるので、ライトユーザーには基本 --date を勧める。
4. 「このパラメータで実行してよいか」を1回確認し、OKなら --dry-run を外して実行する。
5. 完了後、保存パス + 先頭数行 + 行数 + 出典(sites.md) を報告。エラー時は原因と次の一手。

インバランス単価はこのライトパス（CLI）非対応。MCPの power_imbalance_prices（read-only）経由での確認を案内する。

精密パス

1. 引数があれば使う。無ければ一つずつ尋ねる。
2. どのデータ? — spot(スポット) / intraday(時間前) / reserve(予備率) / area-actual(エリア需給実績)。python power_get.py datasets でネットワーク不要のpeek（必須/任意パラメータ・対応エリア）を確認できる。 （インバランス単価はこのCLI未対応。HTML1件のみで実CSV取得が未実装のため。MCPのpower_imbalance_pricesは別途利用可）
3. 選んだデータに必要なパラメータだけ尋ねる:
   • spot/intraday: --year(年度。4月始まり)(必須。--date のみでも自動導出), 任意で --date(その日で行フィルタ)
   • reserve: --from·--to(必須。--date のみなら from=to=date として自動導出), 任意 --area(エリア絞り込み), --granularity koma|daily(既定 koma=jhSybt02)
   • area-actual: --area(東京/九州/北海道 のみ実装), 東京=--yyyymm / 九州=--yyyymmdd / 北海道=--from·--to(YYYYMM、内部でHEPCO形式 YYYYMM-MM に正規化)。--date のみでも各形式へ自動導出される。エリア表記ゆれ（東京電力/TEPCO/tokyo 等）は正式名に自動正規化される。
4. 保存先は既定 ~/Downloads(変更は --out <ディレクトリ>)、--format json も可。--dry-run で解決済みパラメータ・保存予定ファイル名のみ確認できる（ネットワーク未接続）。
5. 実行: python "${CLAUDE_PLUGIN_ROOT}/scripts/power_get.py" --dataset <..> ...
6. 完了後、保存パス + 先頭数行 + 行数 + 出典(sites.md) を報告。エラー時は原因と次の一手。