SRPユーティリティ料金API

Salt River Project（アリゾナ州フェニックス都市圏）の住宅向け電気料金と明細付き請求書を、SRPが提出した料金書から計算して提供します。推定値ではありません。すべてのレスポンスは、出典元の文書とページを明示します。

稼働中: https://utility-api-jn9g.onrender.com · ドキュメント: /docs

GET https://utility-api-jn9g.onrender.com/v1/tariff/rate?tariff_id=srp:E-26&at=2026-07-15T15:00:00

{
  "season": "summer_peak",
  "period": "on_peak",
  "rate_per_kwh": 0.2566,
  "components": [ ... ten unbundled line items ... ],
  "source": {
    "document_url": "https://www.srpnet.com/.../2025-Ratebook-with-Temporary-FPPAM.pdf",
    "page_refs": ["48-53"],
    "verified_by": "Courtney",
    "confidence": "verified"
  },
  "caveats": [ ... ]
}

なぜこれが存在するのか

SRPの住宅向け料金は公開されていますが、実際に計算するのは非常に困難です。料金は時間、曜日、季節、および祝日によって変化し、定義が一致しない多数のプランにまたがっています。

• 季節は請求サイクルで定義され、ピーク時間は暦日で定義される。 E-26では、夏は5月、6月、9月、10月の請求サイクルを指しますが、午後2〜8時のピーク時間帯は暦日で5月1日から10月31日まで続きます。10月31日をまたぐ請求サイクルには、1つの季節の価格と2つの異なる時間分類が適用されます。これらを単一の「season」フィールドにまとめると、中間月の請求がすべて静かに誤ってしまいます。

• 料金はマウンテン標準時で申請され、アリゾナ州は夏時間を採用していない。 夏時間に合わせてシフトする一般的な時間帯別（time-of-use）ライブラリは、年間の半分で1時間ずれてしまいます。

• 料金は単一の数値ではなく、バンドル解除された構成要素のスタックである。 燃料費と購入電力調整額はスタック内にあり、独自のスケジュールで動くため、分離可能なままである必要があります。

• 祝日は一部の時間帯を停止するが、他の時間帯は停止しない。 E-28では、クリスマスにはピーク時間帯が停止されますが、超オフピーク時間帯は引き続き適用されます。

このサービスは、申請書類からこれらすべてをモデル化し、その計算過程を示します。

Related MCP server: ratebook-mcp

対象範囲

最新の回答を得るには GET / または GET /v1/tariff/plans を呼び出してください。最新のデータロード時点:

住宅向けのみ。対象外の請求サイクルに対するリクエストは、対象期間を明記した422を返します。

拒否するものとその理由

これは、依存する前に読む価値のある部分です。

モデル化されていないプラン。 E-28は、現在のデータモデルでは表現できない、エクスポートされたkWhあたりのクレジットを支払います。屋根太陽光を設置している顧客に対して誤った請求書を返す代わりに、このサービスはE-28を明確に拒否し、その旨を伝えます。これを修正するにはスキーマの変更が必要で、以下で追跡しています。

対象外の日付。 各ファイルは特定の請求サイクル期間をカバーします。記録上の申請書が管理していないサイクルを要求すると、対象範囲をリストした422を返します — 外挿された料金は決して返されません。

データとして扱えない条項。 各料金には、unmodeled_provisions リストが含まれており、レスポンスでは caveats として表示されます: 30万ドルの年間省エネ上限、SRPが申請書間で燃料調整額を移動できる裁量、政府の税・手数料の転嫁。これらは実際に金額を変える可能性のある実際の条件であり、隠されることなく明記されています。

税金。 含まれません。州、郡、自治体の税率は、サービス提供住所によって異なります。

MCPサーバー

同じ計算ツールはMCPサーバーとしても利用でき、アシスタントが直接呼び出すことができます。3つのツール: list_srp_plans、get_srp_rate、calculate_srp_bill。無料でローカル — 支払いもネットワーク呼び出しもありません。

{
  "mcpServers": {
    "srp-tariff": {
      "command": "C:\\path\\to\\utility-api\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\utility-api\\mcp_server.py"]
    }
  }
}

Windowsに関する注意（苦労して学んだこと）:

• 依存関係はvenvのインタープリタを明示的に指定してインストールする: & ".\.venv\Scripts\python.exe" -m pip install -r requirements.txt。素の pip install は別のPythonを呼び出す可能性があり、サーバーは ModuleNotFoundError で失敗します。

• Claude DesktopがMicrosoft Storeからインストールされた場合、%APPDATA%\Claude\ ではなく、%LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\ 配下のサンドボックス化された設定パスを読み取ります。Settings → Developer → Edit Config を使用して、アプリが実際に読み取るファイルを見つけてください。

• ローカルサーバーを表示するには、開発者モードを有効にする必要があります。

マシン支払い（x402）

HTTPエンドポイントは、x402 を介して呼び出しごとに支払うこともできます — エージェントは402を受け取り、USDCで支払い、再試行します。アカウントやAPIキーは不要です。現在はBase Sepolia（テストネットワーク） 上にあります。現在有効なネットワークは GET / で報告されます。

/ と /v1/tariff/plans は設計上無料です: 呼び出し側は、支払うことを決定する前に、何が対象かを知ることができなければなりません。

ローカルでの実行

python -m venv .venv
.venv\Scripts\activate
python -m pip install -r requirements.txt
python -m pytest tests\ -v
python -m uvicorn server:app --reload

支払いは、CDP_API_KEY_ID と X402_PAY_TO の両方が .env に設定されている場合にのみ有効になります。未設定のままにすると、支払いなしで実行されます。

データモデル

申請書ごとに1つのJSONファイル（プランごとではありません）: data/tariffs/srp/<slug>@<from-billing-cycle>.json。料金改定または一時的な調整はファイルを追加します。既存のファイルを編集することはありません。レジストリは tariff_id をバージョンのリストにキー付けし、要求された請求サイクルで選択するため、過去のサイクルにも引き続き回答できます。

ファイルは schemas/tariff-schema.v1.1.json に対して検証されます。テストスイートは、すべての構成要素スタックが印刷された合計と一致すること、12の請求月すべてが正確に1つの季節にマッピングされること、カレンダーが生成できるすべての季節/期間の組み合わせに価格があること、そして confidence: verified を主張するファイルが、誰がどのページで検証したかを明記していることをチェックします。

既知のギャップ

• 2026年11月以降はモデル化されていません。 SRPは複数の料金書バリアント（基本、一時的FPPAM、TCA改訂）を公開しており、データを追加する前に、どのバリアントが11月のサイクルに適用されるかをソースで確認する必要があります。

• 輸出クレジット（E-28、E-13、E-14、E-16）には、クレジットの課金タイプが必要です — スキーマv1.2。

• 一部の請求サイクル（入居、退去、プラン変更）の日割り計算は表現されていません。

• 構造化された資格。 2019年の屋根太陽光を持つ顧客はE-26に加入できませんが、資格は現在散文で表現されているため、呼び出し側がその顧客をE-26で価格設定することを妨げるものはありません。

• 丸め規則は、明細項目ごとに丸めてから合計します。SRPが合計してから一度だけ丸めるかどうかは、実際の時間帯別請求書で検証されていません。

正確性と免責事項

料金はSRPの提出済み料金書から転記され、各ファイルは誰がどのページで検証したかを記録しています。構成要素のスタックは、印刷された合計と一致することを機械的にチェックされています。それでも、これは非公式の再実装です: SRPとは提携・承認されておらず、財務上の決定の唯一の根拠にすべきではありません。ご自身の請求書とSRPの公開料金で確認してください。

申請書は変更されます。任意のレスポンスの retrieved_at を確認し、そのサイクルがカバーされていることを確認してください。

Killion Apps によって構築されました。