China Macro

@pipeworx/china-macro

中国人民銀行（PBOC）のローンプライムレート（贷款市场报价利率、LPR）、国家統計局の主要指標、70都市の住宅価格、SHIBOR、国債利回り曲線を、すべてキー不要でリアルタイムに取得できます。

Pipeworx の一部です。AI エージェントを1879以上のリアルタイムデータソースに接続するMCPゲートウェイです。これは独立した非公式の連携であり、上流のプロバイダーとは提携・推奨・公開の関係にありません。

ツール

• china_lpr({ months? }) — 直近12か月までのLPR発表（1年物および5年物の金利と基準日）を、新しい順に返し、latest フィールドも含みます。上流で公開されているのは約1年分のローリング期間のみのため、months の上限は12です。
• china_lpr_latest() — 現在の1年物／5年物LPRとその基準日のみを返し、履歴は含みません。「現在の金利」だけを必要とする呼び出し元に適しています。
• china_macro_indicator({ indicator, periods? }) — 9つの主要指標に対応するツールです。対象は cpi、ppi、pmi（製造業＋非製造業）、gdp（セクター別の年初来累計）、industrial_production（鉱工業付加価値の伸び率）、retail_sales、fixed_asset_investment、money_supply（M0／M1／M2）、trade（月次の輸出入総額）です。最新の期間から順に、最大で periods 件（デフォルト12、上限36）の月次／四半期履歴を返します。すべてのフィールドは、中国国家統計局（NBS）の中国語名称から英語名に翻訳され、単位も含まれます。 直接ルート（source: "nbs"）。 再配信元ではなく、中国国家統計局の独自データベースから取得します。各系列には、公開時のまま変換せずに period、period_type（single_month／single_quarter／year_to_date）、measure（index、pct_change_yoy、pct_change_qoq、change_pp、level、level_pct、rate_pct、diffusion_index）、unit、base（例：「前年同月＝100」）が含まれます。公開元の単位表記は誤っている場合があるため（基準値100の指数が「%」として公開される場合など）、そのまま published_unit として保持されます。公開元のラベルから基準を特定できない系列は、basis_status: "unresolved" とともに、数値を value_raw としてのみ返します。空の期間は削除して件数を記録し、nullとしては返しません。また、urban_unemployment と capacity_utilization（四半期）、series（名前付きの単一系列）、period、region も含まれます。region は履歴の場合は省名、1期間の31の中国本土の省級地域を対象とする場合は "all" です（cpi、ppi、industrial_production、fixed_asset_investment、gdp）。台湾、香港、マカオはこれらの系列に含まれません。
• china_house_prices({ city?, month? }) — 70都市の新築住宅および中古住宅の価格指数を取得します。city（英語名）を指定すると、1都市の履歴（最大24か月）を取得します。month（"YYYY-MM"）を指定すると、特定の発表月を取得します。どちらも指定しない場合は、最新月の70都市すべてを横断したデータを返します。
• china_rates({ series, days?, periods? }) — series: "shibor" では、上海銀行間取引金利を8つすべての期間について取得します（最新のフィキシング＋日次履歴）。series: "yield_curve" では、中国国債の利回り曲線を取得します（日付付きの1年物／10年物ベンチマーク履歴と、活発に取引される全満期のリアルタイム気配利回り曲線）。

認証

キーは不要です。Cookieやセッションも不要です。

データソース

• PBOC の認可を受けた全国銀行間資金センター — 貸出プライムレート（china_lpr、china_lpr_latest）。
• 中国国家統計局 — CPI、PPI、PMI、GDP、工業付加価値成長率、小売売上高、固定資産投資、マネーサプライ、および全国70都市の住宅価格指数（china_macro_indicator、china_house_prices）。
• 中国国家統計局、全国・省級統計データベース — 直接ルート（source: "nbs"、region）：全国の月次・四半期系列と省別クロスセクション。data_as_of は、値が存在する最新の期間です。
• 中国税関総署 — 月次の輸出入総額（china_macro_indicator({ indicator: "trade" })）。
• 中国外貨交易中心／全国銀行間資金センター — SHIBOR のフィキシングレートと中国国債利回り（china_rates）。

LPR の公表元が提供するのは直近約12か月分のみのため、china_lpr ではそれより前の履歴を取得できません。LPR は毎月20日（または次の営業日）に発表されるため、china_lpr_latest の reference_date はおよそ月に1回更新されます。

NBS と税関の統計値は、公式系列を掲載するキー不要の再配信元（Eastmoney のデータセンター）経由で取得しています。すべてのレスポンスの source フィールドでは、NBS または税関の名称が先に、仲介元がその次に記載されます。1年物／10年物の国債ベンチマークは、IMF の特別データ配信基準に基づき開示される日次系列です。このエンドポイントでは1回の呼び出しにつき最大60行に制限されているため、日次の最大件数ではなく、必要な件数に近い periods を指定してください。リアルタイムのイールドカーブは、デフォルトで国債が対象です。

クイックスタート

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

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

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

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

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

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

最初の呼び出しにアカウントは不要です。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/china_lpr を使用します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

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

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

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

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

npx -y @pipeworx/mcp-china-macro

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

ask_pipeworx での使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。 これは、上記のパックエンドポイントだけでなく、フルゲートウェイでも機能します。

ask_pipeworx({ question: "your question about China Macro data" })

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

詳細

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

ライセンス

MIT