Econdata

@pipeworx/econdata

通过劳工统计局公开 API v2 获取美国劳动力和价格统计数据，包括通胀（CPI-U）、失业率、按行业划分的非农就业人数，以及任何 BLS 系列 ID 对应的数据。

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

工具

工具	返回内容
get_cpi	美国城市平均水平、所有项目的 CPI-U 指数历史记录，包含按月计算的 yoy_inflation_pct 和 latest 汇总。默认不进行季节性调整（BLS CUUR0000SA0）；传入 seasonally_adjusted: true 可使用 CUSR0000SA0——即 FRED 发布为 CPIAUCSL 的同一系列。每条响应都会注明所用的调整方式，并附带另一种调整方式下对应月份的值，分别存于 latest.index_value_sa / latest.index_value_nsa，因为两者相差约一个点（2026-07：NSA 为 333.918，SA 为 332.813）。
get_unemployment	经季节性调整的民用失业率（LNS14000000），按月统计。
get_employment_by_industry	经季节性调整的雇员工资总人数，单位为千人，适用于 total_nonfarm、manufacturing、construction、retail、financial 或 government。
get_series	按系列 ID 获取任意 BLS 系列的数据，供已知所需系列的调用方使用。

数据按从新到旧的顺序返回——每条响应都会在 observation_order 中说明这一点，无需根据日期推断。此处 total 和 returned 始终相等：BLS 会返回请求年份范围内的所有数据点，因此不会截断数据。

每个数据点都包含从 BLS period 代码推导出的 ISO date（按月为 M01–M12，按季度为 Q01–Q04，按半年为 S01/S02，按年为 A01/M13），因此无需解码 "M06"，即可对结果排序并检查数据时效性。

身份验证

无需密钥即可使用，每个 IP 每天约可请求 25 次。免费的 BLS 注册密钥可将限额提升至每天 500 次：请前往 https://data.bls.gov/registrationEngine/ 获取。网关会提供平台密钥（PLATFORM_BLS_KEY）；仅在要使用自己的密钥覆盖平台密钥时才传入 _apiKey。

BLS 的两种限流会以不同方式失败，此工具包会区分它们，因为过去两种错误的提示很相似：

• 每秒突发请求限流——并发调用在同一秒到达时，BLS 会返回 HTTP 429 "Requests Per Second Limit Exceeded"。工具包会重试三次（400 ms、1200 ms、2500 ms）；只有三次重试后仍存在的 429 才会作为 upstream_throttled 返回，并明确说明这不是每日配额限制，也不是密钥额度耗尽。
• 每日限额——以 REQUEST_NOT_PROCESSED 响应体返回，而非 HTTP 错误。也会作为 upstream_throttled 返回，并附上注册链接。

数据来源

• BLS 公共数据 API v2 — https://api.bls.gov/publicAPI/v2/timeseries/data/（文档：https://www.bls.gov/developers/api_signature_v2.htm）
• 使用的系列：CUUR0000SA0 / CUSR0000SA0（CPI-U，NSA / SA）、LNS14000000（失业率）、CES*（按行业划分的当前就业统计数据）

快速开始

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

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

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/econdata/mcp 返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和网关级工具集中的其他工具。因此，你看到的工具数量会多于表格中的数量：目前，单个工具包端点会列出约 30 个共享工具，以及该工具包自己的工具。连接的 initialize 响应会说明确切范围，是当天情况的权威依据。

这是有意设计的，并非意外多路复用。元工具可以让范围受限的连接回答此工具包未涵盖的问题——通过 ask_pipeworx 在整个目录中路由——而无需添加第二个 MCP 服务。目前无法挂载不含这些工具的工具包端点；如果额外的架构定义耗费的上下文多于路由带来的价值，请改为连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是这个工具包的工具：

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

两个 URL 都连接到同一个网关和相同的 1878+ 个数据源。唯一的区别是直接列出哪个工具包的工具；从任一端点都可以通过 ask_pipeworx 访问所有工具。

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

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

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/econdata_get_series。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

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

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

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

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

npx -y @pipeworx/mcp-econdata

它通过 stdin/stdout 使用 MCP，并对 initialize/tools/list/tools/call 作出响应，仅提供此工具包的工具——不包含上述网关连接额外提供的任何共享元工具。来源相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗英语提问，而不必直接调用工具——这既适用于上面的工具包端点，也适用于完整网关：

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

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT