Warn Notices

warn-notices

米国WARN法に基づく人員削減および工場閉鎖の通知 — 大規模な人員削減の前に雇用主が提出しなければならない60日前の事前届出 — を州の労働局から取得します。

Pipeworx の一部です — AI エージェントを1684以上のライブデータソースに接続する MCP ゲートウェイです。

対象範囲は意図的に限定しており、すべてのレスポンスでその旨を示します。 全国的なWARNデータベースはありません。連邦労働省（DOL）は収集も公開もしていないため、雇用主は事業所のある州に届出を提出し、各州がそれぞれの方法で公開します。このパックでは、機械可読データを公開している州を対象とし、対象となる州を正確に示します。

ツール

ツール	回答する内容
warn_search	企業、州、日付、規模で絞り込んで、届出を提出した雇用主を確認できます。
warn_recent	最近提出された届出を、新しい順に確認できます。
warn_company	1つの雇用主が提出したすべての届出と、州別・年別の合計を確認できます。
warn_coverage	対象となる州、各州の届出件数、データの最新状況を確認できます。

すべてのレスポンスには states_covered が含まれます。結果が空の場合は、state_not_covered と no_matching_notices を区別します。「ジョージア州は対象外」と「この雇用主は何も提出していない」は異なる回答であり、そのうち雇用主に関するものは一方だけだからです。

対象範囲

州	ソース	形式	履歴	更新頻度
CA	EDD WARN report	XLSX	直近約2か月分	週2回
IL	Illinois WorkNet WARN API	JSON	1987年以降	毎週
NY	NYSDOL WARN dashboard	Tableau CSV	2025-04以降	毎週、不定期に集中して更新
OH	ODJFS annual notice file	CSV	今年分	毎週
TX	TWC via data.texas.gov	Socrata JSON	2019年以降	不定期、約2か月遅れる場合あり

各州は data_freshness に個別に登録されています（warn-ca、warn-il、…）。そのため、更新が滞ったフィードが、より新しい州の日付に隠れることなく確認できます。

調査済みだが、提供対象外

再調査を避けられるよう、記録してあります。

• NJ — XLSXはありますが、州が公開しているファイルでは多くの行で列がずれており、企業名が日付列に入っています。行単位での修正が必要です。
• PA / WA / FL — データは実在し、最新ですが、形式はHTMLのみです。PAはネストされたアコーディオン、WAは1ページ目以降で __VIEWSTATE のポストバックが必要なASP.NET GridView、FLはページ分割されたテーブルです。いずれもスクレイピング可能ですが、機械可読ではありません。
• GA — 現在、公開されている一覧はありません。従来の検索では引き続き回答が得られますが、2013年で止まっており、現在のサイトは雇用主向けの提出フォームで、公開インデックスはありません。

データソース

• California EDD — https://edd.ca.gov/en/jobs_and_training/Layoff_Services_WARN
• Illinois WorkNet — https://apps.illinoisworknet.com/iebs/layoff/publiclayoffs
• New York DOL — https://dol.ny.gov/warn-dashboard
• Ohio ODJFS — https://jfs.ohio.gov/（年次 warn-notice.csv アセット）
• Texas Workforce Commission — https://data.texas.gov/d/8w53-c4f6

データ取り込み処理は workers/data-pipeline/src/datasets/warn.ts にあります。ソースごとの注意点も同ファイルに記載されています。テーブルは warn_notices です（マイグレーション108）。

知っておくべき注意点

• テキサス州は、人員削減と閉鎖を区別するフラグを公開していません。 推測で設定するのではなく、TXの type はnullです。「Layoff」を作り出すと、報告された事実のように見えてしまいます。
• テキサス州のデータには遅れがあります。 2026-08-29時点で、最新の届出は他州より約2か月遅れていました。このフィードでは通常のことです。
• 発効日は必ずしも日付とは限りません。 複数の州では期間や「various」という語が公開されるため、effective_date は解析できた場合にのみ設定し、effective_date_as_published には実際に記載された内容を常に保持します。
• 企業名は自由記述です。 検索では接尾辞を取り除いた形式で照合するため、「Tesla」で「Tesla, Inc.」が見つかります。matched_filed_names には照合した文字列が正確に返されるので、関連会社間で緩やかに一致した結果かどうかを確認できます。

クイックスタート

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

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

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

https://gateway.pipeworx.io/warn-notices/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 も、同じゲートウェイと同じ 1684+ 件のデータソースに接続します。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/warn_search \
  -H 'Content-Type: application/json' \
  -d '{"state":"TX","min_employees":200,"since":"2026-01-01"}'

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

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

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

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

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

npx -y @pipeworx/mcp-warn-notices

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

ask_pipeworx の使用

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

ask_pipeworx({ question: "your question about Warn Notices data" })

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

詳細

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

ライセンス

MIT