China Safe

@pipeworx/china-safe

中国の公式準備資産、国際収支、対外債務 — 外汇储备（外貨準備）、国际收支（国際収支）、外债（対外債務） — 外汇管理局（国家外汇管理局、SAFE）の英語データページから解析したデータです。

Pipeworx の一部です。AI エージェントを1875以上の稼働中データソースにつなぐ MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとの提携、承認、公開はありません。

ツール

• china_fx_reserves({months}) — 月次の公式準備資産：主要な 外貨準備（外汇储备）、IMFリザーブポジション、SDR保有高、金（価値＋ オンス）、その他の準備資産、および合計。月次で、月末からおよそ 1週間後に公表されます。2026-09-07に確認：最新月は2026年8月で、 外貨準備は3,438.325十億米ドル、公式準備資産合計は 3,854.885十億米ドルでした。2026-09-07に公表。
• china_balance_of_payments({quarters, currency}) — 四半期ごとの国際収支の概要： 経常収支（財、サービス、第一次・第二次所得）、資本・金融収支 （準備資産の増減を含む）、および誤差脱漏。currency は usd （デフォルト）、rmb、または sdr です。四半期ごとに、四半期末から およそ3か月後に公表されます。これは標準的なBPM6の公表サイクルであり、 サイトのデータが古いわけではありません。2026-09-07に確認：最新四半期は 2026Q1で、2026-06-26に公表されました。
• china_external_debt({quarters}) — 2014Q4以降の四半期ごとの総対外債務残高 （外债）：合計、契約時の当初満期別（短期／長期）、および機関部門別 （一般政府、中央銀行、その他預金取扱機関、その他部門、直接投資関係会社間 貸付）。BOPと同様、四半期ごとに約3か月の遅れがあります。2026-09-07に確認： 最新四半期は2026Q1で、2026-06-26に公表されました。
• china_safe_releases({limit}) — 他の3つのツールの実際の公表日を確認できます。 各ソースページ自身のPubDateメタデータと添付ファイルのアップロード日時を 参照しており、ページのパーマリンクは参照しません。データの新しさが重要な 場合は、他のツールの数値を引用する前に使用してください。

認証

キー不要です。

データソース

• https://www.safe.gov.cn/en/ForexReserves/index.html — 公式準備資産。 暦年ごとに、累積データを含む.xlsxファイルが1つあります（列はYYYY.01～YYYY.12）。
• https://www.safe.gov.cn/en/BalanceofPayments/index.html — 年次と四半期の各シートに 人民元／米ドル／SDR建ての国際収支時系列データ全体を含む.xlsxファイルが1つあります。
• https://www.safe.gov.cn/en/ExternalDebt/index.html — 2014Q4以降の四半期ごとの部門別 総対外債務残高を含む.xlsxファイルが1つあります。

ここに記録した落とし穴：誰かが同じことを再発見せずに済むように

• パーマリンクの URL は公開日ではありません。 SAFE は毎年、外貨準備表と BOP／債務の時系列データを、何年も前に発行された URL にそのまま再掲載します。たとえば「Official Reserve Assets (2026)」は 2021 年の日付が付いたパス /en/2021/0203/2045.html にありますが、2026-09-07 時点でもライブデータが更新されていました。パーマリンクではなく、記事ページ自体の <meta name="PubDate"> と、添付ファイル自体のパスに含まれる日付（/en/file/file/20260907/....xlsx）を信用してください。
• JSON も CSV も、数値が含まれたレンダリング済み HTML テーブルもありません。 各記事ページには .xlsx（通常は対応する .pdf も）へのリンクがあるだけで、ページ本文はスタブです。このパックは、手書きの依存関係不要な ZIP+XML リーダー（src/xlsx.ts。ema-medicines パックのリーダーを移植したもの）で .xlsx を直接解析します。3 つのファイルを処理するためだけに、Worker に xlsx ライブラリ一式を含めることはできません。
• xlsx リンクのアンカーテキストはページによって異なります。 外貨準備ページでは通常のアンカーテキスト（<a href="...">xlsx</a>）を使いますが、BOP／対外債務ページではレポートの完全なタイトルをアンカーテキストにし、ファイル名は title="..." 属性に記載します。アンカーテキストではなく、.xlsx 拡張子の href で照合してください。
• 外貨準備の行は、列見出しの繰り返しではなく位置で固定されています。 各月は 2 列（USD、次に SDR）で構成されますが、「YYYY.MM」の見出しテキストがあるのは USD 列だけです。SDR 列は結合セルで、独自の見出しはありません。6 つの指標行（外貨準備、IMF リザーブポジション、SDR、金の価値、金の重量、その他の準備資産、合計）はシート内の固定行番号にあります。出荷前にライブファイルと照合して検証済みです（行の合計は小数点以下 2 桁まで列の合計と一致します）。
• BOP は約 280 行の BPM6 内訳で、このパックが提供するのは 17 のサマリー項目であり、サブアカウントの詳細全体ではありません（金融商品別・部門別の内訳は 4 階層にわたります）。同じテンプレートが RMB／USD／SDR の各シートで再利用されているため、行番号はハードコードせず、列 A のラベルテキストを正規化して照合し、動的に取得します。
• 対外債務の各部門の合計は、それぞれの短期・長期の小計行の合計と一致し、総合計は 5 部門の合計と一致します。 出荷前にライブの 2026Q1 の数値で確認済みです（24,120.799 = 3,601.510 + 1,034.221 + 9,886.860 + 6,820.844 + 2,777.364）。
• 金の重量は 10,000 オンス単位（万盎司）で報告されます。たとえば「7673万盎司」は 76,730,000 オンスです。このパックでは gold_million_oz に直接変換します。

クイックスタート

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

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

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

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

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

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

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

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

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

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

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-china-safe

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

ask_pipeworx の使用

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

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

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

詳細

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

ライセンス

MIT