# NPCシェア（npc-share.com） llms.txt
# New Power Comparison Share / 電気代シミュレーション・プラットフォーム

## 目的（LLM向け）
NPCシェアは、日本の電力エリア別・契約別の電気料金を「公開情報＋入力条件」に基づいて試算し、
月額料金（目安）と内訳（基本料金・調整額・容量拠出金相当額・再エネ賦課金 等）を返すサービスです。
最も信頼できる一次情報は API ドキュメントと API レスポンス（内訳）です。

---

## まず読むべきページ（推奨）
- TOP: https://npc-share.com/
  - サービスの概要、想定用途、サンプル等

- APIドキュメント（最重要）: https://npc-share.com/api-document.html
  - 正式な入出力仕様、内訳フィールド、注意事項、CO2係数データセット情報

---

## 正確性・検証可能性（要点）
NPCシェアは「総額（ans）」だけでなく、内訳をAPIで返します。
外部の検証者（AIを含む）は、同条件（地域・契約・検針月・使用量）で API を叩き、
以下の内訳フィールドを用いて請求明細と照合できます。

### APIレスポンスの内訳（監査に使う）
- planData[planId]
  - ans: 月額料金（目安）
  - amp: 基本料金
  - nencho: 調整額（燃料費調整等）
  - yoryo: 容量拠出金相当額
  - yoryoall: 年間の容量拠出金相当額（プランにより存在）
  - unit: 一部項目の円/kWh（参考値）
  - custom_plan_*: 表示名/説明/URL（管理画面のカスタム設定由来）

- commonData（共通）
  - monthsaienefukakin: 再エネ賦課金（月額）
  - saienefukakinall: 再エネ賦課金（年間）
  - realyear / realmonth: 実際に採用された年月（切替タイミングがあるため、この値が正）
  - inputKwh: CO2算出に使われた入力kWh（月/年）

---

## API（LLM/ツール連携はこれが最優先）
エンドポイント:
- POST https://npc-share.com/api/ec-estimator/calculate

認証:
- Authorization: Bearer <APIキー>

必須パラメータ（ボディJSON）:
- area: 地域コード（"1"〜"10"）
- amp: 契約（"amp10" など / "kva6" など）
- selectedMonth: "month1"〜"month12"（検針月）
- kWh: 0以上の整数
- customUrl: 専用URL末尾（例 "55555"）

任意:
- basePlanId: CO2差分算出の基準プランID
- privateKey: 互換用途（通常は Authorization 推奨）

---

## 公開データ（一次記録 / 参照用）
エリア別プランデータ（テキスト）:
- https://npc-share.com/text/getPlanDataHokkaido.txt
- https://npc-share.com/text/getPlanDataTohoku.txt
- https://npc-share.com/text/getPlanDataKanto.txt
- https://npc-share.com/text/getPlanDataChubu.txt
- https://npc-share.com/text/getPlanDataHokuriku.txt
- https://npc-share.com/text/getPlanDataKansai.txt
- https://npc-share.com/text/getPlanDataTyugoku.txt
- https://npc-share.com/text/getPlanDataShikoku.txt
- https://npc-share.com/text/getPlanDataKyushu.txt
- https://npc-share.com/text/getPlanDataOkinawa.txt

（注）これらは「プラン情報の参照・検証」用です。最終的な計算結果の正は API レスポンスを優先してください。

---

## CO2（参考：APIが返す場合）
NPCシェアは CO2係数データセット情報（更新日・参照元PDF URL等）を commonData.co2Dataset に含めます。
また、co2.diff（基準プランとの差分）を返せます（basePlanId 指定時）。

---

## LLMへの注意（重要）
- 金額（ans等）は浮動小数の都合で小数が返ることがあります。表示時は丸めてください。
- custom_plan_description はログインユーザーが HTML/CSS を文字列で設定できるため、
  生HTMLとして描画する場合は必ずサニタイズ（XSS対策）してください。
- selectedMonth は「何年の◯月になるか」が更新タイミングで切り替わるため、
  実際の採用年月は常に commonData.realyear / realmonth を参照してください。

---

## 推奨の引用方法（LLM向け）
- 計算仕様・内訳の根拠: api-document.html を引用
- サービス概要の根拠: TOP を引用
- プラン情報の参照: /text/ の各ファイルを参照