Warn Notices

warn-notices

美国《WARN 法案》裁员和工厂关闭通知——雇主在大规模裁员前必须提前 60 天提交的申报，由各州劳工部门发布。

属于 Pipeworx——一个将 AI Agent 连接到 1684+ 个实时数据源的 MCP 网关。

覆盖范围有意保持不完整，并且每条响应都会说明这一点。 美国没有全国性的 WARN 数据库：联邦劳工部（DOL）既不收集也不发布此类数据，因此雇主需向工厂所在州提交申报，各州也按各自的方式发布。本工具包涵盖会发布机器可读数据的州，并会准确列出这些州。

工具

工具	可回答的问题
warn_search	哪些雇主提交了通知？可按公司、州、日期或规模筛选。
warn_recent	最近提交了哪些通知？按时间从新到旧排列。
warn_company	某雇主提交的所有通知，以及按州和年份统计的总数。
warn_coverage	覆盖了哪些州、每个州有多少条通知，以及各州数据的更新情况如何。

每条响应都包含 states_covered。空结果会区分 state_not_covered 和 no_matching_notices，因为“未覆盖佐治亚州”和“该雇主没有提交任何通知”是两种不同的答案，只有后者与雇主有关。

覆盖范围

州	来源	格式	历史数据	更新频率
CA	EDD WARN 报告	XLSX	滚动约 2 个月	每周两次
IL	Illinois WorkNet WARN API	JSON	自 1987 年起	每周
NY	NYSDOL WARN 仪表板	Tableau CSV	自 2025-04 起	每周，分批发布
OH	ODJFS 年度通知文件	CSV	当前年度	每周
TX	TWC，通过 data.texas.gov	Socrata JSON	自 2019 年起	不定期，可能延迟约 2 个月

每个州都会在 data_freshness 中单独注册（warn-ca、warn-il 等），这样某个数据源停滞时就会显现出来，而不会被更新更及时的州的数据掩盖。

已探查但未纳入

记录在此，以免重复探查：

• NJ — 存在 XLSX 文件，但该州自己的文件中许多行的列错位（公司名称出现在日期列中）。需要逐行修复。
• PA / WA / FL — 数据真实且当前有效，但仅有 HTML。PA 使用嵌套折叠面板，WA 使用 ASP.NET GridView，翻到第 1 页之后需要通过 __VIEWSTATE 提交请求，FL 使用分页表格。都可以抓取，但都不是机器可读格式。
• GA — 没有当前公开列表。旧版搜索仍可查询，但数据截至 2013 年；新版网站是雇主提交表单，没有公开索引。

数据源

• 加利福尼亚州 EDD — https://edd.ca.gov/en/jobs_and_training/Layoff_Services_WARN
• Illinois WorkNet — https://apps.illinoisworknet.com/iebs/layoff/publiclayoffs
• 纽约州 DOL — https://dol.ny.gov/warn-dashboard
• 俄亥俄州 ODJFS — https://jfs.ohio.gov/（年度 warn-notice.csv 文件）
• 德克萨斯州劳动力委员会 — https://data.texas.gov/d/8w53-c4f6

数据导入逻辑位于 workers/data-pipeline/src/datasets/warn.ts；各数据源的特殊问题也记录在该文件中。数据表：warn_notices（迁移 108）。

值得了解的注意事项

• 德克萨斯州不发布裁员与关闭的标记。 因此，TX 的 type 为 null，而不是猜测其类型——凭空填入“裁员”会被误认为是已报告的事实。
• 德克萨斯州的数据有延迟。 截至 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 服务。目前无法挂载不带这些元工具的工具包端点；如果额外的架构定义耗费的上下文超过了路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者连接完整的 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