Nber Macrohistory

@pipeworx/nber-macrohistory

NBER 宏观历史数据库——美国国家经济研究局的公开档案，收录了美国（以及部分国际）长期宏观经济序列，大多数序列涵盖 19 世纪至 20 世纪 60 年代，分为 16 个主题类别（价格、货币与银行、生产、建筑、就业、农业、对外贸易、政府财政等）。可通过 NBER 编号（例如 m13045）查找特定序列，也可以浏览 16 个主题文件夹中的编号。

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

工具

• nber_macrohistory_series(series_id) — 通过 NBER 编号获取单个序列（例如 "m13045" 或 "a01006"）。返回标题、涵盖地区、单位、覆盖日期、来源说明（根据 NBER 针对该序列的官方文档解析）以及所有带日期的观测值。m = 月度，a = 年度，q = 季度。如果只提供数字编号，它会依次尝试月度、年度和季度序列，并返回存在的序列。
• nber_macrohistory_list_series(category) — 获取 16 个主题类别文件夹（"01" 至 "16"）中的所有序列编号。不包含标题（目录列表中没有标题）——调用 nber_macrohistory_series 并传入编号即可查看序列内容。

身份验证

无需密钥。

数据源

• https://www.nber.org/research/data/nber-macrohistory-database — 该 档案的介绍页（仅供背景参考，此工具包不会抓取）。
• https://data.nber.org/databases/macrohistory/rectdata/{folder}/{id}.dat — 序列的原始定宽数据文件。
• https://data.nber.org/databases/macrohistory/rectdata/{folder}/docs/{id}.txt — 序列的文档标头（标题、领域、单位、覆盖范围、来源、 备注）。
• https://data.nber.org/databases/macrohistory/rectdata/{folder}/ — 类别的 目录列表，由 nber_macrohistory_list_series 抓取。

这是一个按请求实时代理：每次调用都会直接从 data.nber.org 获取数据，此工具包不会批量下载或存储任何内容。

序列 ID → 文件夹。 去掉前导字母（m/a/q）；文件夹名是剩余部分 的前两位数字——"m13045" → 文件夹 "13"， "a01005a" → 文件夹 "01"。已在类别 01、07、08、11、13、 15、16 中验证（2026-09-23）。不存在文件夹 00，也没有大于 16 的文件夹。

data.nber.org 会拒绝任何包含字面子串 "http" 或子串 "bot" 的 User-Agent。 其拦截页面显示“Prevent Bots from data downloads.”。2026-09-23 的测试结果："foo/1.0 (+https://x)" → 403， "somebot/1.0" → 403（仅因包含“bot”），"foo/1.0 (pipeworx.io)" → 200。此目录中的其他 所有工具包都使用 "(+https://pipeworx.io)" 这一 User-Agent 约定——唯独此工具包刻意不使用，也不能使用，否则每个请求都会返回 403。如果你将此工具包的抓取模式复制到其他针对 nber.org/data.nber.org 主机的场景中，请牢记这一点。

各序列的 .dat 文件没有统一的缺失数据标记常量——根据目前已检查序列的 文档标头中注明的 MD=1E-37 约定，此工具包将任何满足 abs(value) < 1e-30 的值视为缺失。如果某个序列的文档标头注明了不同的缺失数据代码， 此工具包不会读取该字段——这是一个固定的启发式规则，不会按序列解析。

.dat 文件的每行并非统一对应一条记录——年度（a 前缀） 行的格式为 YEAR VALUE，月度/季度（m/q 前缀）行的格式为 YEAR PERIOD VALUE。此工具包通过统计每行按空白拆分后的词元数（2 个与 3 个以上） 来区分，而不是依赖 ID 的前缀字母，因为少数实际存在的 ID（例如 m13001a）带有月度前缀，但后缀却呈年度格式。

文档 .txt 标头的标题没有字段分隔符——人类可读的标题直接位于 一行 "----" 虚线之上；虚线之上还有简短的字段代码（VAR/REF/EXP 行）， 这些内容看起来也像标题文本，但并不是标题。此工具包以虚线为锚点，向前回溯至最近的空行或字段代码行，而不是试图根据格式 匹配标题文本。

快速开始

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

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

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/nber-macrohistory/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 都连接到同一个网关和相同的 1683+ 个数据源。唯一的区别是直接列出哪个工具包的工具；ask_pipeworx 无论从哪个 URL 都能访问所有工具。

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

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

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

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

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

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

或者直接运行，以确认它可以启动：

npx -y @pipeworx/mcp-nber-macrohistory

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

使用 ask_pipeworx

你也可以用通俗的英语提问，而不是直接调用工具——上述工具包端点和完整网关都支持此功能：

ask_pipeworx({ question: "your question about Nber Macrohistory data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT