Bls

BLS — Bureau of Labor Statistics

米国労働統計局のデータウェアハウスです。雇用、失業、賃金、物価（CPI／PPI）、生産性、職業別予測など、米国の公式な労働・物価データを提供します。全国、州、都市圏のデータを利用できます。API キーを登録すれば無料です。

Pipeworx の一部です。AI エージェントを1882以上のリアルタイムデータソースにつなぐ MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携しておらず、承認や公開も受けていません。

AI エージェントにとっての重要性

公式データで労働市場やインフレに関する情報が必要なら、BLS を利用します。FRED では主要な系列を取得できますが、BLS では職業別、業種別、MSA 別といった詳細データを取得できます。地域の経済状況、業種別賃金、特定の CPI 構成要素を調査するエージェントは、BLS に直接アクセスできます。

主なフローは3つです。

1. 系列を検索する。「デンバー都市圏の失業率は？」→ bls_search({query: "Denver unemployment"}) → 系列 ID が返されます。次に bls_get_series({series_id}) で値を取得します。

2. 最新の値を取得する。「現在の全国失業率は？」→ bls_latest({series_id: "LNS14000000"}) → 最新の観測値が返されます。

3. よく使われる系列を閲覧する。「BLS が公開しているデータは？」→ bls_popular_series → 利用頻度の高い ID を厳選した一覧が返されます。

雇用予測。「ソフトウェア開発者の予測成長率と年間求人件数は？」→ bls_occupation_projections({ soc_code: "15-1252" })、または ({ query: "nurse" })、あるいは ({ rank_by: "growth_percent", min_employment_thousands: 50 }) で職業をランキングできます。最新リリースの全国雇用マトリックスを提供します（雇用者数、10年間の変化、年間求人件数、賃金中央値、一般的な入職時の学歴）。雇用者数と求人件数の単位は千人で、レスポンスには予測期間と data_as_of が含まれます。過去のリリース時点のデータは提供されません。

4. 地名から地域別失業率を取得する。「ノースカロライナ州ウェイク郡の失業率は？」、「ノースカロライナ州ケーリー市は？」、「ファーゴ・ムーアヘッド MSA は？」→ bls_local_unemployment({place, state?})。これは、郡／都市圏／市ごとの LAUS（地域別失業統計）を検索するツールです。bls_search の厳選カタログには地域別データがなく、LAUS の系列 ID を手作業で作成するには、地名を BLS の地域コードに対応付ける表（米国の郡／都市圏／市が約8,000件）が必要です。推測で対応できるものではありません。bls_local_unemployment はその対応表（BLS の la.area 参照ファイルを同梱）を使って地名を照合し、地名が曖昧な場合は候補を返します。また、市のデータが LAUS の公表基準に満たない場合は郡のデータに切り替え、そのことを明示します。

レスポンスの読み方

bls_get_series は各系列を新しい順に返します。ペイロードの observation_order にその順序が記載されているため、日付から方向を 推測する必要はありません。count はその系列のデータ点数です。BLS は 指定された年の範囲に含まれるすべてのデータ点を返すため、短いリストの 横に合計値が表示されることはありません。

認証

BLS API の利用には、https://www.bls.gov/developers/ で無料のキーを取得する必要があります。キーがない場合、IP アドレスあたりの呼び出し回数は約25回／日に制限されます。キーがあれば、500回／日まで利用できます。呼び出しごとに _apiKey を渡してください。

系列 ID の構造

BLS の系列 ID には、調査、地域、セクター、データ種別が含まれています。例：

系列 ID	内容
LNS14000000	全国の失業率（季節調整済み）
CES0000000001	非農業部門の雇用者総数（全国）
CUUR0000SA0	CPI 総合、米国都市平均、季節調整なし
LAUMT080000000000003	デンバー MSA の失業率
WPSFD49207	最終財の PPI

全国／州／業種の ID を一から作成しようとせず、bls_search または bls_popular_series を使用してください。特に LAUS の地域別 ID （郡／MSA／市）を取得する場合は、bls_local_unemployment({place, state?}) を使用してください。地名から適切な地域コードを解決します。

更新頻度

データ	公開時期
雇用状況（全国＋州）	毎月第1金曜日
CPI	月中（10〜15日ごろ）
PPI	月中、CPIの翌日
都市圏の失業率（LAUS）	対象月の約3週間後
生産性	四半期ごと、四半期末から約5週間後

Pipeworx は、公開スケジュールに合わせた TTL で BLS のレスポンスをキャッシュします。

よくある落とし穴

• 季節調整。 同じ系列に季節調整済み（SA）と季節調整なし（NSA）のバリエーションがあります。系列 ID のプレフィックスを確認してください（LNS = SA、LNU = NSA）。両者を混在させるのは、アナリストが最もよく犯す誤りです。
• 年平均と月次。 年次データのみを返す ID もあれば、月次データを返す ID もあります。傾向をグラフ化する前にメタデータを確認してください。
• 州および都市圏の網羅状況。 すべての系列が、すべての地域で利用できるわけではありません。小規模な都市圏ほど遅延が大きく、補完された値も多くなります。
• インフレ率と CPI。 「インフレ率」は通常、CPI の前年同月比の変化を意味します。前年同月比を得るには、13 か月分のデータを取得して計算するか、FRED の CPIAUCSL に pc1 の単位変換を適用してください（自動的に計算されます）。

クイックスタート

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

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

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

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

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

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

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

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

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

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

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

npx -y @pipeworx/mcp-bls

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

ask_pipeworx を使う

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

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

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

詳細

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

ライセンス

MIT