Eia

EIA — 米国エネルギー情報局

米国の公式エネルギーデータです。石油、天然ガス、電力、石炭、再生可能エネルギー、原子力、総エネルギー、国際エネルギーを網羅しています。生産、消費、価格、埋蔵量、輸出入を、国、州、（電力については）発電所のレベルで確認できます。無料で利用できますが、無料の API キーが必要です。

Pipeworx の一部です。AI エージェントを 1878 以上のリアルタイムデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとの提携、承認、公開によるものではありません。

AI エージェントにとって重要な理由

エネルギーに関する質問、たとえば「天然ガスの価格はいくらですか？」「電力のうち太陽光発電はどのくらいですか？」「ガソリン価格は上昇していますか？」には、EIA が情報源になります。政府機関の信頼性の高いデータを、商業上の上乗せなしで利用できます。エネルギー関連のマクロ指標には FRED を、エネルギーに関係する気象情報には NOAA を組み合わせてください。

よくあるワークフロー：

• スポット価格。 「WTI 原油の取引価格はいくらですか？」→ 原油スポット価格の時系列データ。
• 州別の電源構成。 「カリフォルニア州の電力のうち、太陽光は何％ですか？」→ 電源別の州レベルの発電量。
• 小売ガソリン・軽油。 「米国のレギュラーガソリンの平均価格はいくらですか？」→ us_fuel_price — EIA の「Weekly Retail Gasoline and Diesel Prices」調査による、指定グレードの米国週平均店頭価格です（デフォルトはレギュラーで、全国の代表的な数値です。ほかにミッドグレード、プレミアム、全グレード、軽油を指定できます）。eia_petroleum で製品に「gasoline」を指定した場合も、同じ grade を使用し、すべての地域の全グレードを混在させた値ではなく、米国平均をデフォルトで返すようになりました。
• 天然ガスの貯蔵量。 「貯蔵中の稼働可能なガスはどのくらいですか？」→ EIA-915 の週次報告。

認証

EIA Open Data API の利用には、https://www.eia.gov/opendata/register.php で取得できる無料のキーが必要です。_apiKey 経由で渡してください。レート制限には十分な余裕があります。

主なデータセット

データセット	更新頻度	用途
石油・その他の液体燃料	週次／月次	原油価格、ガソリン、留出油、OPEC
天然ガス	貯蔵量は週次、生産量は月次	価格、貯蔵量、消費量
電力	月次	燃料別発電量、州別小売料金
石炭	月次／年次	採掘、価格、輸出
再生可能・代替燃料	月次	太陽光、風力、バイオ燃料、電気自動車の充電
総エネルギー／Annual Energy Outlook	年次	長期予測

系列 ID

EIA の系列は dataset_id.frequency.region.product のパターンに従います。例：

• PET.RWTC.D — WTI 原油、日次
• NG.RNGC1.D — 天然ガスのヘンリーハブ価格、日次
• ELEC.GEN.SUN-CA-99.M — カリフォルニア州の太陽光発電量、月次
• PET.EMM_EPMR_PTE_NUS_DPG.W — 米国のレギュラーガソリン週平均価格

ID を手動で組み立てるのではなく、eia_search ツールを使って検索してください。

よくある注意点

• 報告の遅延はデータによって異なります。 石油価格は約 3 日遅れで毎週更新されます。発電量は約 2 か月遅れの月次データです。データセット間で「最新」の時点が一致するとは限りません。
• 熱量と体積の違い。 天然ガスは BCF（10 億立方フィート）、MMcf、エネルギー単位（BTU、MMBtu）で報告されます。燃料間で比較する場合は、単位換算が重要です。
• 正味発電量と総発電量。 発電所の発電量には、定義上の微妙な違いがあります。「正味」は発電所内での使用分を差し引いた値です。EIA が主に公開しているのは正味発電量です。二重計上しないようにしてください。
• 原動機別の州別電力データ。 EIA の州別電源構成は、原動機（蒸気タービン、コンバインドサイクルなど）と燃料の両方で分類されています。同じ発電所が複数の分類に含まれることがあります。質問に必要な粒度に集計してください。
• 予測はシナリオです。 AEO（Annual Energy Outlook）は基準ケースの予測に加え、複数の別シナリオを示しています。基準ケースを「実際に起こること」として扱わないでください。
• 市場のリアルタイム価格はありません。 EIA のスポット価格は公式の日次終値です。日中の市場価格には EIA ではなく、商用フィードが必要です。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "eia": {
      "url": "https://gateway.pipeworx.io/eia/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/eia/mcp の tools/list は、上の表にあるツールに加えて、共有の Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールに加えて、約 30 個の共有ツールが一覧表示されます。接続時の initialize 応答に正確な対象範囲が記載されており、その日の状況を確認する際の確実な情報源です。

これは意図的な仕様であり、偶然の多重化ではありません。メタツールを使えば、このパックでは対応できない質問にも、カタログ全体にルーティングする ask_pipeworx を通じて回答できます。MCP サーバーをもう 1 つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、ゲートウェイ全体に一度だけ接続してください。

または、Pipeworx ゲートウェイ全体に接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1878 以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使えば、すべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/eia_series \
  -H 'Content-Type: application/json' \
  -d '{"route":"petroleum/pri/gnd"}'

最初の呼び出しではアカウントは不要です。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/eia_series を使用します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

{
  "mcpServers": {
    "eia": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-eia"]
    }
  }
}

または、起動を確認するために直接実行します。

npx -y @pipeworx/mcp-eia

stdin/stdout 経由で MCP を使用し、このパック固有のツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントでも、ゲートウェイ全体でも機能します。

ask_pipeworx({ question: "your question about Eia data" })

ゲートウェイが適切なツールを選択し、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT