Ferc Eqr

ferc-eqr

谁向谁批发售电：FERC Electric Quarterly Report（EQR）申报方，以及卖方与交易对手之间的合同。

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

这与 ferc-elibrary 不同：那个工具包用于搜索 FERC 案卷／文档（申报文件、命令、意见）。本工具包提供底层申报方和合同数据，回答的是完全不同的问题（“谁向谁售电”与“FERC 申报了什么”）。

工具

工具	可回答的问题
eqr_seller_lookup	将公司名称或 FERC 公司 ID（例如 “C000740”）解析为对应的 EQR 申报方记录 — 按季度列出的申报，以及申报方是否报告了向指数价格发布机构提交的交易。仅提供公司级身份信息，不含申报方联系方式。
eqr_contracts_search	按卖方、交易对手和／或产品搜索合同，并指定季度范围。返回合同级费率期间明细 — 数量、费率、交付／接收点、合同期限。
eqr_counterparty_sellers	“谁向 X 售电” — 按交易对手名称匹配汇总卖方，并列出合同数量及其出现的季度范围。
eqr_coverage	各表的行数、当前覆盖的季度范围，以及上次刷新的时间。在将空结果视为否定答案之前，请先调用此工具。

身份验证

无需验证。不需要密钥或账户。

不含个人数据

上游来源也包含每家公司的申报方 CONTACT 字段 — 个人姓名、职务、地址、电话和电子邮件。**这些信息均不会被加载或由任何工具返回。**仅保留公司级身份信息（company_id_ferc、filer_unique_id、company_name）。

覆盖范围并非自动包含“自 2013 年以来的所有数据”

上游数据涵盖 2013q3 至今，但本工具包采用增量加载，并非一次性加载全部数据。在将空结果视为“无此类合同”之前，请调用 eqr_coverage 查看实际覆盖的季度范围 — 超出覆盖范围的结果属于覆盖缺口，而非否定答案。每个工具的响应中也会说明这一点。

数据来源、许可与署名

FERC 仅以按季度打包的嵌套 ZIP 文件形式发布 Electric Quarterly Reports，本身不提供查询界面。Catalyst Cooperative 的 PUDL 项目 — 一个广泛使用的开放能源数据项目 — 将 EQR 规范化为结构化的季度表，并公开重新发布。

许可：“Copyright 2016-2026, Catalyst Cooperative, CC-BY-4.0” （https://docs.catalyst.coop/pudl/en/latest/LICENSE.html）— 明确适用于数据（其处理代码采用单独的 MIT 许可，这与数据不同，也不适用于数据）。CC-BY-4.0 允许在注明出处的情况下重新分发。每个工具响应都包含 attribution 字段；如果你修改此工具包，请勿删除该字段。

刷新

node scripts/ingest-ferc-eqr.mjs --since <yyyyqN>

可重复运行且安全：每行都会根据所有已加载列的内容哈希进行 upsert，因此再次加载已覆盖的季度不会产生重复，而是不执行任何操作。node scripts/ingest-ferc-eqr.mjs --dry-run [--since <q> | --all] 会解析数据但不写入任何内容，可用于在正式加载前检查新季度的行数。每次运行时，listQuarters() 都会发现当前实时发布的季度，因此发布新季度无需更改代码 — 只需扩大 --since 范围。

第 1 阶段与第 2 阶段

第 1 阶段（本工具包）：申报方身份、指数价格发布方报告和合同条款——每个合同 RATE-PERIOD 项目一行，而非每份合同一行（单份合同在其有效期内可能包含多个不同费率周期的项目）。此处返回的数量或费率来自合同中列明的条款，而非已结算的交易。

第 2 阶段（尚未构建）：实际结算的交易级价格／成交量数据——合同的条款写了什么，与实际成交情况之间的差异。对于“卖方 X 实际以什么价格卖出了什么”这类问题，这是最有价值的数据，且难度远高于其他数据：其上游数据源的规模大约是第 1 阶段涵盖内容的 100 倍，而仅最近一个季度的数据量就超过了本工具包目前涵盖的全部数据。它需要采用不同于第 1 阶段的加载策略——很可能要使用范围更窄的滚动窗口，而非完整历史数据；也可能需要采用完全不同的存储结构。此项尚未列为任务；等衡量出第 1 阶段的实际需求后（是否有人实际调用 eqr_contracts_search / eqr_counterparty_sellers），再单独界定范围，因为它的基础设施成本相当高，值得先获得相关证据。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

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

此端点实际提供的内容

https://gateway.pipeworx.io/ferc-eqr/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 都连接到同一个网关和相同的 1879+ 个数据源。唯一的区别是直接列出的工具所属工具包不同；无论连接哪一个，ask_pipeworx 都可以访问全部工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/eqr_seller_lookup \
  -H 'Content-Type: application/json' \
  -d '{"query":"NextEra"}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/eqr_seller_lookup。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

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

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需与网关往返通信：

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

或者直接运行，确认它能正常启动：

npx -y @pipeworx/mcp-ferc-eqr

它通过 stdin/stdout 使用 MCP 通信，并仅针对本工具包的工具响应 initialize / tools/list / tools/call——不包含上述网关连接提供的任何共享元工具。数据源相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

你可以不用直接调用工具，而是用自然语言提问——在上述工具包端点和完整网关上都可以使用：

ask_pipeworx({ question: "your question about Ferc Eqr data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT