Eia

EIA — 美国能源信息署

官方美国能源数据：石油、天然气、电力、煤炭、可再生能源、核能、能源总量和国际能源数据。涵盖全国、州级及（电力的）电厂级别的产量、消费量、价格、储量、进口／出口数据。免费使用，需申请免费的 API 密钥。

属于 Pipeworx — 一个将 AI Agent 连接到 1878+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联、未获其认可，也并非由其发布。

这对 AI Agent 有何意义

对于能源相关问题——“天然气价格是多少？”“太阳能发电占多少？”“汽油价格在上涨吗？”——EIA 是权威数据来源。政府级数据，无商业加价。可搭配 FRED 获取能源相关的宏观指标，并搭配 NOAA 获取与能源相关的天气背景信息。

常见工作流：

• 现货价格。“WTI 原油的交易价格是多少？”→ 原油现货价格序列。
• 各州电力结构。“加利福尼亚有多少比例的电力来自太阳能？”→ 各州按能源来源划分的发电量。
• 零售汽油和柴油。“美国普通汽油的平均价格是多少？”→ us_fuel_price — EIA《每周零售汽油和柴油价格》调查中的美国每周平均加油站价格，按所询问的等级提供（默认普通汽油——全国重点数据——也可以是中档、高档、所有等级或柴油）。eia_petroleum 的产品为 “gasoline” 时，现在也会遵循相同的 grade 设置，并默认采用美国平均值，而不是混合所有地区的所有等级数据。
• 天然气储量。“储气库中有多少可用天然气？”→ EIA-915 每周报告。

身份验证

EIA Open Data API 需要从 https://www.eia.gov/opendata/register.php 申请免费密钥。通过 _apiKey 传入。速率限制宽松。

主要数据集

数据集	更新频率	用途
石油及其他液体燃料	每周／每月	原油价格、汽油、馏分油、OPEC
天然气	每周储量，每月产量	价格、储量、消费量
电力	每月	按燃料划分的发电量、各州零售电价
煤炭	每月／每年	开采、价格、出口
可再生能源及替代燃料	每月	太阳能、风能、生物燃料、电动汽车充电
能源总量／年度能源展望	每年	长期预测

序列 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 — 美国普通汽油每周平均价格

请使用 eia_search 工具查找 ID，而不是手动拼接。

常见注意事项

• **报告延迟各不相同。**石油价格每周更新，延迟约 3 天。发电量每月更新，延迟约 2 个月。不要假设不同数据集的“当前”数据时间一致。
• **热值与体积。**天然气数据可能以 BCF（十亿立方英尺）、MMcf 和能量单位（BTU、MMBtu）报告。跨燃料比较时，单位换算很重要。
• **净发电量与总发电量。**电厂发电量的定义较为复杂。“净”发电量已扣除电厂内部用电。EIA 主要发布净发电量。不要重复计算。
• **按主要动力设备划分的州级电力数据。**EIA 的州级电力结构按主要动力设备（蒸汽轮机、联合循环等）和燃料划分——同一电厂可能归入多个类别。请按问题所需的粒度汇总。
• **预测是情景分析。**AEO（年度能源展望）包含参考情景预测和其他情景。不要把参考情景当作“未来必然如此”。
• **没有实时市场价格。**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 服务。目前无法挂载不含这些工具的工具包端点；如果额外的架构定义耗费的上下文超过了路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者连接完整的 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":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账号）

此软件包也可作为本地 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