Nber Macrohistory

@pipeworx/nber-macrohistory

NBER Macrohistory Database — National Bureau of Economic Research が公開する、米国（および一部の国際的な）長期マクロ経済系列のアーカイブです。多くは1800年代から1960年代までを対象とし、物価、通貨・銀行、生産、建設、雇用、農業、外国貿易、政府財政など、16の分野にわたります。NBER の ID（例：m13045）で特定の系列を検索するか、16の分野別フォルダーから ID を参照できます。

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

ツール

• nber_macrohistory_series(series_id) — NBER の ID（例："m13045" または "a01006"）を指定して、1つの系列を取得します。タイトル、対象地域、単位、対象期間、出典に関する注記（その系列についての NBER 独自のドキュメントから解析したもの）に加え、日付付きのすべての観測値を返します。m は月次、a は年次、q は四半期です。数字だけを指定した場合は、月次、年次、四半期の順に検索し、存在する系列を返します。
• nber_macrohistory_list_series(category) — 16の分野別フォルダー（"01" から "16"）のいずれかにあるすべての系列 ID を取得します。タイトルは含まれません（ディレクトリの一覧にはタイトルがないため）。系列の内容を確認するには、ID を指定して 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）を除き、残りの先頭 2 桁がフォルダー名です — "m13045" → フォルダー "13"、 "a01005a" → フォルダー "01"。カテゴリー 01、07、08、11、13、 15、16 で検証済みです（2026-09-23）。フォルダー 00 および 16 を超えるフォルダーはありません。

data.nber.org は、User-Agent にリテラル文字列 "http" または文字列 "bot" を含む場合、403 を返します。 ブロックページには「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。 このカタログ内の他のすべてのパックでは、User-Agent に "(+https://pipeworx.io)" を付ける慣例を使っていますが、このパックでは意図的に使っておらず、 使うこともできません。使うとすべてのリクエストが 403 になるためです。nber.org／data.nber.org ホストに対してこのパックの取得パターンを他で使う場合は、この点にご注意ください。

系列ごとの .dat ファイルには、全系列共通の欠損値を示す定数がありません — このパックでは、確認済みの系列のドキュメントヘッダーに記載された MD=1E-37 の慣例に基づき、abs(value) < 1e-30 の値を欠損値として扱います。 系列のドキュメントヘッダーに別の欠損値コードが記載されていても、このパックはその項目を読みません — 系列ごとに解析するのではなく、固定のヒューリスティックを使います。

.dat ファイルは一律に 1 行 1 レコードではありません — 年次（a プレフィックス）行は YEAR VALUE、月次／四半期（m／q プレフィックス）行は YEAR PERIOD VALUE です。このパックでは、ID のプレフィックス文字を 信用せず、行ごとに空白で分割したトークン数（2 対 3 以上）で判別します。 実際には、一部の ID（例：m13001a）のように、月次プレフィックスで年次形式の サフィックスを持つものがあるためです。

ドキュメントの .txt ヘッダーには、タイトルの区切りフィールドがありません — 人が読めるタイトルは "----" の破線のすぐ上にあり、そのさらに上には タイトルのように見える簡潔なフィールドコード（VAR／REF／EXP 行）が並びますが、 それらはタイトルではありません。このパックでは破線を基準に、その直前にある最も近い空行または フィールドコード行までさかのぼって読み取ります。タイトルの文字列の形から判別することはありません。

クイックスタート

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

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

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

https://gateway.pipeworx.io/nber-macrohistory/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 でも、同じゲートウェイと同じ 1683 以上のデータソースにアクセスできます。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使えばすべてのツールにアクセスできます。

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":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

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

このパッケージは、ローカルの 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