Fracfocus

@pipeworx/fracfocus

米国の水圧破砕に関する化学物質開示情報――坑井単位の破砕作業記録（事業者、API 番号、所在地、日付、ベース流体量）と、各作業で開示された化学添加剤／成分（商品名、供給業者、用途、CAS 番号、質量、作業に占める割合）。フリート #2982。

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

ツール

• frac_wells(state?, county?, operator?, limit?, offset?) -- 州、郡、および／または事業者名で FracFocus の坑井単位の開示情報を検索します（事業者名は部分一致）。3 項目のうち少なくとも 1 つが必須です。FracFocus の全開示履歴を対象とします。各坑井の API 番号、事業者、坑井名、所在地、作業日、ベース流体量を、作業日の新しい順に返します。
• frac_chemicals(api_number, limit?, offset?) -- API 番号で指定した 1 つの坑井について開示された化学成分一覧です（ハイフンは省略可能）。商品名、供給業者、用途、CAS 番号、成分名、作業全体に占める質量割合、および成分ごとのポンド単位の質量を返します。営業秘密の成分には CAS 番号がなく、代わりに申立企業が記載されます。成分単位の詳細は、このパックの対象期間開始日以降の作業についてのみ読み込まれています。frac_wells に存在しても対象期間開始日より前の坑井を指定した場合は、坑井自体が FracFocus に存在しない場合の reason:"unknown_api_number" とは異なり、found:false, reason:"outside_ingredients_coverage" が返されます。
• chemical_usage(cas_number, state?, limit?, offset?) -- CAS 番号で指定した化学物質が使用された場所を検索します（ハイフンは省略可能）。必要に応じて州を指定できます。概要（成分開示レコードの合計数、坑井の重複を除いた数、州の重複を除いた数）と、一致する使用記録のサンプルを返します。frac_chemicals と同様に、成分データの対象期間内のみを検索します。

すべてのレスポンスには source、source_url、license、および成分データの対象期間（ingredients_since / disclosures_through）が含まれるため、呼び出し元は「この坑井では化学物質が開示されていない」場合と「この坑井の作業は読み込み済みのデータより前のもの」場合を区別できます。

認証

キーは不要です。ツールはデータを保持する Pipeworx ゲートウェイ経由でのみ応答します。単独の npm install では読み取れるデータがなく、そこで各ツールを呼び出すと、空のリストを返すのではなく、「このランタイムではバインドされていません」という明確なエラーが発生します。

データソース

• FracFocus（Ground Water Protection Council / Interstate Oil and Gas Compact Commission） -- 水圧破砕に関する全国規模の化学物質開示レジストリです。FracFocus は一括 CSV ダウンロードのみを公開しており、リクエスト単位の API はありません。そのため、このパックではリクエストごとにプロキシするのではなく、データのコピーを D1 に構築します（scripts/fracfocus/load-data.mjs）。 ライセンス（原文をそのまま引用、2026-10-14 に実際の内容を確認）： "ダウンロードしたデータは集計したり、他のデータセットと組み合わせたりできますが、FracFocus のデータをいかなる方法でも変更することはできません。" また、"提出されたデータは、事業者または事業者が認定した代理人によって提出されたとおりに表示されます。FracFocus は、いかなる方法でもデータを保証しません。" このパックでは CSV の行を SQL の行に再フォーマットし、成分テーブルの対象を最近の日付期間（下記）に限定していますが、保持される値は一切変更していません。

既知の制約 — このパックを拡張する前にお読みください

成分テーブル（ff_ingredients）には全履歴が含まれていません。 FracFocus の一括ダウンロードには、坑井の開示情報が約 25 万件（DisclosureList_#.csv。全件読み込み済み）含まれていますが、化学成分の行は約 730 万件（FracFocusRegistry_#.csv、2026-10-14 に計測）あります。各開示情報の成分行には坑井ヘッダーの全列も繰り返し含まれていますが、このパックでは重複して保存せず、代わりに disclosure_id で ff_disclosures と結合します。成分行 730 万件をすべて一度に読み込むには、初回ロードの約 10 倍の wrangler d1 execute 呼び出しが必要になります。初回ロードでは、--since（既定値は 2024-01-01）以降の作業に対象を絞って ff_ingredients に読み込みます。 2026-10-14 に計測したところ、化学物質の内容を含まない CAS 番号も成分名もない、プレースホルダーのみの行（「Ingredient Container」という化学物質の内容を含まない管理用行）を約 11％除外した後で、約 64 万 6 千行となります。frac_wells（ff_disclosures のみを参照）は全履歴を引き続き対象とします。一方、frac_chemicals と chemical_usage（ff_ingredients を参照）が回答できるのは読み込み済み期間内に限られます。古い坑井に対して空の成功結果を返すのではなく、その旨を明示的に示します（reason:"outside_ingredients_coverage"）。

mcps/bts-ontime の「直近 N か月」を初回ロードする方式と同じです。 前例については、そのパックの README をご覧ください。対象期間をさらに過去へ広げるには、node scripts/fracfocus/load-data.mjs --since 2020-01-01（またはそれ以前の日付）を実行してください。ff_ingredients への挿入は日付で絞り込まれた追加方式なので、後からより過去の日付を指定して実行すると、すでに読み込み済みの行に再処理を行わず、古い行が追加されます。一方、ff_disclosures は実行のたびに全件再読み込みします（テーブルが小さく低コストで、新たに公開された開示情報を取得する最も簡単な方法です）。

WaterSource データは読み込まれていません。 FracFocus 4.0（2023-12-01）では、オプションの給水源ファイル（WaterSource_#.csv、約 5 MB、坑井単位）が追加されました。このパックのツールセットには含まれていません。将来のツールで必要になった場合は、テーブルを追加してください。

データの更新

FracFocus は独自のダウンロードページで「週 5 日」更新しているとしていますが、増分／差分フィードは公開していません。そのため、更新時には一括 ZIP 全体を再ダウンロードして再処理します。node scripts/fracfocus/load-data.mjs を実行してください（Pipeworx の Cloudflare アカウントに wrangler でログイン済みであること、および unzip CLI が必要です）。毎月実行するか、--since をより過去の日付に設定して、成分データの対象期間をさらに広げてください。

クイックスタート

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

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

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

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

これは意図された動作であり、意図せず多重化されているわけではありません。メタツールを使うと、このパックで扱っていない質問にも、カタログ全体を検索する ask_pipeworx 経由で回答できます。そのため、2 つ目の MCP サーバーを追加する必要はありません。現在、メタツールを使わずにパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、ゲートウェイ全体に一度だけ接続してください。

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

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

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

MCP クライアントがありませんか？ HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/frac_wells \
  -H 'Content-Type: application/json' \
  -d '{"state":"Texas","county":"Martin","limit":5}'

最初の呼び出しではアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/frac_wells を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

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

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

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

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-fracfocus

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

ask_pipeworx の使用

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

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

ゲートウェイが適切なツールを選び、引数を自動で入力します。

詳細

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

ライセンス

MIT