Ferc Eqr

ferc-eqr

誰が誰に卸電力を販売しているか：FERC Electric Quarterly Report（EQR）の 提出者と、売り手と取引相手との間の契約です。

Pipeworx の一部です — AI エージェントを1879以上の稼働中のデータソースに接続するMCPゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携しておらず、承認も公開も受けていません。

ferc-elibrary と同じものではありません。このパックはFERCの案件・文書検索（提出書類、命令、意見）を扱います。このパックは基盤となる提出者と契約のデータを扱います。まったく別の問い（「誰が誰に販売しているか」と「FERCが何を提出したか」）です。

ツール

ツール	回答する内容
eqr_seller_lookup	会社名またはFERCの会社ID（例：「C000740」）を、EQR提出者のレコード（四半期ごとの提出状況、および提出者が価格指数の発行者に取引を報告したかどうか）に照合します。会社レベルの識別情報のみで、提出者の連絡先情報は含みません。
eqr_contracts_search	売り手、取引相手、製品、および／または四半期の範囲で契約を検索します。契約レベルの料金期間の明細（数量、料金、引渡し／受取地点、契約期間の日付）を返します。
eqr_counterparty_sellers	「Xに電力を販売しているのは誰か」—取引相手名の一致に基づいて売り手を集計し、契約数と該当する四半期の範囲を示します。
eqr_coverage	テーブルごとの行数、現在の対象四半期の範囲、最終更新日時を返します。空の結果を否定的な回答と見なす前に呼び出してください。

認証

不要です。キーもアカウントも必要ありません。

個人データなし

上流のソースには、会社ごとの提出者の連絡先フィールドも含まれています — 個人の氏名、役職、住所、電話番号、メールアドレスです。これらは一切読み込まれず、どのツールからも返されません。 会社レベルの識別情報（company_id_ferc、filer_unique_id、company_name）のみを保持します。

対象範囲は2013年以降の「すべて」を自動的にカバーするわけではありません

上流のデータは2013q3から現在までを対象としていますが、このパックの対象データは一括ではなく、段階的に読み込まれます。空の結果を「該当する契約はない」と見なす前に、実際に対象となっている四半期の範囲をeqr_coverageで確認してください — 対象範囲外の結果は、否定的な回答ではなく、カバレッジの空白です。すべてのツールの応答にもこの説明があります。

データソース、ライセンス、帰属表示

FERCはElectric Quarterly Reportsを四半期ごとのネストされたZIPファイルとしてのみ公開しており、独自のクエリインターフェースはありません。Catalyst CooperativeのPUDLプロジェクト — 広く利用されているオープンなエネルギーデータプロジェクト — は、EQRを四半期ごとの構造化テーブルに正規化し、一般公開しています。

ライセンス：「Copyright 2016-2026, Catalyst Cooperative, CC-BY-4.0」 （https://docs.catalyst.coop/pudl/en/latest/LICENSE.html）— DATAに明記されています（データ処理に使われているコードには別途MITライセンスが適用されますが、これは別のものであり、データには適用されません）。CC-BY-4.0では、帰属表示を条件に再配布が許可されます。すべてのツールの応答にはattributionフィールドが含まれます。このパックに手を加える場合は削除しないでください。

更新

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

再実行可能で安全です。読み込まれたすべての列のコンテンツハッシュに基づいて行をアップサートするため、すでに対象となっている四半期を再度読み込んでも、重複は発生せず何も変更されません。node scripts/ingest-ferc-eqr.mjs --dry-run [--since <q> | --all]は、書き込みを行わずに解析します。新しい四半期の行数を読み込み前に確認するのに便利です。listQuarters()は実行ごとに公開済みのデータをライブで検出するため、新しい四半期が公開されてもコードの変更は不要です — --sinceの範囲を広げるだけです。

Phase 1 と Phase 2 の比較

Phase 1（このパック）：提出者の識別情報、指数価格公表者の報告、契約条件 — 契約ごとに1行ではなく、契約の RATE-PERIOD 明細ごとに1行です（1つの契約に、その期間中の異なるレート期間に対応する複数行が含まれる場合があります）。ここで返される数量やレートは、確定した取引ではなく、契約に記載された条件に基づいています。

Phase 2（未構築）：実際に決済された取引レベルの価格／数量データ — 契約の 条件 に記載された内容と、実際に取引された 内容です。「販売者 X は実際に何をいくらで販売したか」という質問に答えるための、圧倒的に価値の高いデータであり、難易度も群を抜いて高いものです。このデータの上流ソースは Phase 1 の対象全体よりおよそ2桁大きく、直近の四半期1つだけでも、このパックが現在カバーする全データを上回ります。Phase 1 とは異なる読み込み戦略が必要です。おそらく全履歴ではなく、より狭いローリングウィンドウを使うか、ストレージ構造自体を変える必要があります。タスクとしては登録していません。Phase 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