Sovereign Debt Contagion

ソブリン債務伝染 MCP サーバー

ApifyForge で見る | Apify Store で使う

---

クイックスタート

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

{
  "mcpServers": {
    "sovereign-debt-contagion-mcp": {
      "url": "https://ryanclinton--sovereign-debt-contagion-mcp.apify.actor/mcp"
    }
  }
}

---

信用アナリスト、マクロファンドマネージャー、開発金融機関向けのソブリン債務伝染分析を、MCP 互換の AI クライアントから利用できます。このサーバーは、8 つの国際データソース（IMF、World Bank、OECD、UN COMTRADE、FRED、リアルタイムおよび過去の為替レート、GDACS 災害アラート）を統合し、投資適格からデフォルトリスクまでの複合的なソブリンリスク判定を生成します。自然言語で質問すると、数値スコア、調整済みシグナル、ポートフォリオの推奨事項を含む構造化 JSON を数秒で受け取れます。

このサーバーは、ソブリンリスクのあらゆる側面を網羅する 7 種類の MCP ツールを提供します。財政ストレス、貿易経路を通じた伝染、通貨危機の確率、財政余力、災害と財政の複合的な脆弱性、複数国の比較、地域全体のシナリオ計画に対応します。基盤となる 8 つのデータソースはすべて Promise.all を使って並列に実行されるため、全体の待ち時間は最も遅い単一のデータソースに抑えられます。一度セットアップすれば、コードは不要です。

どのようなデータを抽出できますか？

データ項目	ソース	例
📊 債務対 GDP 比率、財政収支、経常収支赤字	IMF World Economic Outlook	債務/GDP：87.4％、赤字：-6.2％
🏛️ ガバナンスの有効性、政治的安定性、法の支配	World Bank Indicators	ガバナンス：下位 28 パーセンタイル
🏦 国境を越える資本フロー、金融統合のシグナル	OECD Statistics	資本流出：-42 億ドルを検出
🔗 二国間貿易フロー、貿易相手国ネットワーク、HHI 集中度	UN COMTRADE	貿易相手国 34 か国、HHI：3,200 — 集中状態
💱 リアルタイム FX レート、下落率の変化	Exchange Rate Tracker	USD/TRY：変動シグナル +18.3％
📉 過去の FX 変動率の時系列、危機パターンの照合	Exchange Rate History	90 日間に大きな変動が 12 回
🇺🇸 米国債 10 年物スプレッド、世界の金利環境	FRED Economic Data	GS10：4.8％、スプレッド：5.4％
🌍 自然災害アラート、深刻度の分類	GDACS Disaster Alerts	アラート 3 件、うち 2 件は ORANGE 深刻度
⚠️ 複合的なソブリンリスクスコアと判定	4 モデルのスコアリングエンジン	スコア：38、判定：高利回り
📋 すべての調整済みシグナルと実行可能な推奨事項	8 つのデータソースを統合	シグナル 10 件、ポートフォリオの推奨事項 3 件

Sovereign Debt Contagion MCP Server を使う理由

従来のソブリン信用分析では、チームが IMF ポータル、World Bank API、COMTRADE、FRED からデータを収集し、債務持続可能性指標、貿易集中度指数、FX 変動率シグナルを手作業で算出する必要があります。この作業には 1 か国あたり数時間かかり、アナリストによって結果にばらつきが生じるうえ、Bloomberg Terminal や Moody's CreditView のサブスクリプションに年間数万ドルの費用がかかります。

このサーバーは、そのプロセス全体を自動化します。国名を指定すると、最大 8 つのデータソースを並列で実行し、検証済みの 4 つのスコアリングモデルを適用して、既存の AI クライアントを通じて構造化された判定を返します。セットアップ後は、コードを 1 行も書かずに利用できます。

• スケジュール実行 — Apify Scheduler を使ってポートフォリオ全体のソブリンストレス調査を毎週実行し、ニュースになる前に新たなリスクを検出します
• API アクセス — Apify API を使って、Python、JavaScript、または任意の HTTP クライアントからアセスメントを実行し、完全な JSON 出力を取得できます
• プロキシローテーション — 基盤となるデータ収集にはすべて Apify のプロキシインフラストラクチャを利用し、国際的なデータポータルへの安定したアクセスを実現します
• モニタリング — Apify Webhook 経由で Slack またはメールのアラートを設定し、ソブリンストレススコアが設定したしきい値を超えたときに通知を受け取れます
• 連携 — 出力を Zapier、Make、Google Sheets、または Webhook に接続し、後続のポートフォリオ監視ワークフローに活用できます

特長

• 4つの独立したスコアリングモデル — ソブリン・ストレス指数、伝染ネットワークグラフ、通貨危機確率、災害・財政脆弱性がそれぞれ0～100のスコアと、ラベル付きの深刻度レベル（例：STABLE、ELEVATED、DISTRESSED、CRISIS）を算出します
• ソブリンリスクの総合判定 — 加重複合式（ソブリン・ストレス35％＋通貨危機25％＋伝染20％＋災害20％）により、単一のINVESTMENT_GRADE / SPECULATIVE / HIGH_YIELD / DISTRESSED / DEFAULT_RISKの信用力評価を算出します
• 危機時の強制判定ロジック — ソブリン・ストレスと通貨危機が同時にCRISISレベルに達した場合、他のサブスコアにかかわらず判定をDEFAULT_RISKに強制し、複合スコアの平均化によって深刻な複合危機が覆い隠されるのを防ぎます
• HHI貿易集中度スコアリング — UN COMTRADEの二国間貿易フローを集計してハーフィンダール・ハーシュマン指数を算出し、シェアが30％を超える相手国を単一障害点となる伝染経路として明示的にフラグ付けします
• 過去の為替変動パターン照合 — 通貨危機モデルは為替レートの履歴から変動率の時系列を構築し、3％および10％を超える変動を数えて、不安定な通貨体制を特定します
• 8つのソースからの並列データ収集 — すべてのActor呼び出しをPromise.allで並行実行するため、各ソースを順番に処理した合計時間ではなく、最も遅い単一ソースの所要時間まで全体のレイテンシを短縮できます
• 部分的な結果を適切に処理 — データソースに障害が発生した場合や空のデータが返された場合も、スコアリングパイプラインを停止させず、空の配列を返します。不足データはリスクを過大評価せず、保守的にゼロ点としてスコアリングします
• 支出上限の適用 — 各ツール呼び出しはデータ収集の開始前にActor.charge()を確認し、予算上限に達した場合は処理を一部だけ完了させず、構造化されたエラーオブジェクトを返します
• 7つの独立したMCPツール — 各リスク領域を個別に呼び出せます。regional_contagion_scenarioは8つすべてのソースを実行し、同じ料金で4つの領域すべてと総合判定を1回の呼び出しで返します
• 調整済みのシグナルテキスト — 各スコアリングモデルは人が読めるシグナル（例：「貿易HHI 3,200 — 貿易依存の集中」）を出力し、アナリストが確認できるようallSignalsにまとめます
• MCPスタンバイモード — Apifyのインフラストラクチャ上で継続的に実行されるため、同じセッション内で国を順次照会する際のコールドスタート遅延を解消します

ソブリン債務の伝染分析のユースケース

ソブリン信用調査

資産運用会社の債券アナリストやクレジットチームは、従来の格付け機関による評価を補完する定量的なストレススコアの生成にこのサーバーを利用します。IMFやFREDからほぼリアルタイムで先行指標を取得するため、正式な格付け変更の数カ月前に財政状況の悪化を検知できます。ソブリン債ポートフォリオを週次でストレスチェックし、DISTRESSEDになる前にWATCHまたはELEVATEDのシグナルを把握できます。

新興国市場の為替リスク管理

FXトレーダーや新興国市場ファンドマネージャーは、通貨を継続的に監視するためにcurrency_crisis_probabilityを利用します。このツールは、現在の通貨下落シグナルと、既知の危機前兆に対する過去の変動パターン照合を組み合わせます。スコアが50を超え、外貨準備高による輸入カバー月数が3カ月を下回ると、出力でFXヘッジまたは現地通貨建て債券の回避を明示的に推奨します。これはデータに直接基づく実用的な指針です。

貿易経路の伝染マッピング

国境をまたぐエクスポージャーを持つポートフォリオマネージャーは、ある国のソブリン危機が貿易相手国にどのように波及するかを把握するためにcontagion_network_analysisを利用します。HHI集中度スコアにより、単一の相手国のデフォルトが引き起こす連鎖に最も脆弱な国を特定できます。トルコ、アルゼンチン、サハラ以南のフロンティア市場に地域エクスポージャーが集中する新興国市場ポートフォリオでは、特に有用です。

開発金融における融資評価

多国間開発銀行や二国間融資機関は、fiscal_headroom_analysisを使って、ストレス閾値を超える前に各国がどれだけ追加のソブリン債務を負担できるかを評価します。このツールは、IMFの債務持続可能性指標とOECDの財政統計を組み合わせ、具体的な財政赤字および債務シグナルを含む余力スコアを算出します。

災害・財政複合リスク分析

気候ファイナンスチームや災害債券の発行体は、disaster_fiscal_vulnerabilityを使って、自然災害へのエクスポージャーが財政の脆弱性を増幅させる国を特定します。GDACSの警報頻度が高く、財政準備金が限られている小島嶼開発途上国では、単一の災害が債務再編を引き起こしかねない複合リスクに直面します。このツールは、最新のGDACSデータを使って、この相互作用を明示的にスコアリングします。

地域間伝染シナリオの策定

最高投資責任者やマクロ戦略担当者は、regional_contagion_scenarioを使って地域全体のストレステストを実施します。国名と任意の地域コンテキストを指定すると、サーバーが8つすべてのソースに問い合わせ、4つすべてのリスク次元、すべてのシグナル、ポートフォリオの推奨事項を含む完全なレポートを返します。四半期ごとのシナリオ策定や、特定のマクロイベントへの対応に活用できます。

ソブリン債務伝染分析の使い方

1. MCP サーバーをAIクライアントに接続します — サーバー URL https://sovereign-debt-contagion-mcp.apify.actor/mcpを、Apify APIトークンをAuthorization: Bearerヘッダーに指定して、Claude Desktop、Cursor、またはWindsurfの設定に追加します（接続例は以下を参照）。
2. 自然言語で質問します — AIクライアントに「アルゼンチンのソブリンストレスを評価して」または「トルコの完全な伝染シナリオを実行して」と入力します。クライアントが適切なツールを自動的に呼び出します。
3. サーバーが最大8つのデータソースを並行して実行します — ツールに応じて、IMF、World Bank、UN COMTRADE、FRED、為替レートフィード、GDACSに同時に問い合わせます。国のデータの利用状況に応じて、15～60秒かかります。
4. 構造化された出力を確認します — AIクライアントに、数値スコア（0～100）、ラベル付きの判定、調整済みシグナル、各リスク次元に対する具体的なポートフォリオの推奨事項を含むJSON結果が表示されます。

MCP ツール

ツール	価格	データソース	説明
sovereign_stress_assessment	$0.045	IMF、World Bank、FRED	ソブリンストレス指数（0～100）：債務対GDP比、インフレ、ガバナンススコア、金利環境
contagion_network_analysis	$0.045	UN COMTRADE、OECD	貿易経路を通じた伝染の伝播、HHI集中度、国境を越えた金融統合
currency_crisis_probability	$0.045	Exchange Rate Tracker、Exchange Rate History、IMF	現在の通貨下落、過去の為替変動率、準備金の十分性に基づく通貨危機確率
fiscal_headroom_analysis	$0.045	IMF、OECD、FRED	債務余力、財政赤字の傾向、利払い負担、残された政策余地
disaster_fiscal_vulnerability	$0.045	GDACS、IMF、World Bank	自然災害へのエクスポージャーと財政バッファーの強さの比較。複合脆弱性のスコアリング
compare_sovereign_risks	$0.045	IMF、UN COMTRADE、Exchange Rate Tracker、GDACS	複合スコア、次元ごとのラベル、相対的な判定を含む複数国の比較
regional_contagion_scenario	$0.045	8つすべてのソース	ソブリンリスクの完全なレポート：INVESTMENT_GRADEからDEFAULT_RISKまでの4つすべての次元と推奨事項

ツールのパラメーター

パラメーター	ツール	型	必須	説明
country	すべてのツール	string	はい	国名または ISO コード（例：「Turkey」、「TUR」、「Argentina」）
period	sovereign_stress_assessment	string	いいえ	分析期間（例：「2024」、「last 5 years」）
currency	currency_crisis_probability	string	いいえ	通貨ペアの明示的な上書き（例：「USD/TRY」）
benchmark	compare_sovereign_risks	string	いいえ	相対比較のベンチマークとなる国（例：「Brazil」）
region	regional_contagion_scenario	string	いいえ	貿易ネットワークのクエリに使用する地域コンテキスト（例：「Latin America」）

入力のヒント

• 最良の結果を得るには、国名を省略せずに入力してください — ほとんどのデータソースでは、「AR」より「Argentina」の方がIMFと世界銀行のデータを幅広く取得できます。
• 正確なFX分析には通貨ペアを指定してください — currency_crisis_probability の使用時に currency: "USD/TRY" を指定すると、特に標準外の識別子を使用するEM通貨では、国名だけの場合より為替レートフィードを正確に対象化できます。
• 包括的な評価には regional_contagion_scenario を使用してください — 個別ツールと同じ $0.045 の料金で、8つすべてのソースを実行し、4つのスコアリング指標すべてを1回の呼び出しで返します。
• 波及効果のモデリングには地域引数を渡してください — regional_contagion_scenario で country: "Kenya" とともに region: "Sub-Saharan Africa" を設定すると、UN COMTRADE のクエリ範囲が広がり、地域の波及経路を捉えられます。
• バッチワークフローでは実行ごとの支出上限を設定してください — 多数の国を対象に一括処理する場合は、予期しない請求を防ぐため、Apify コンソールで実行ごとの最大コストを設定してください。

出力例

{
  "country": "Argentina",
  "compositeScore": 22,
  "verdict": "DISTRESSED",
  "sovereignStress": {
    "score": 74,
    "debtIndicators": 9,
    "inflationSignals": 8,
    "stressLevel": "DISTRESSED",
    "signals": [
      "Multiple debt distress indicators — elevated sovereign risk",
      "High inflation indicators — debt erosion and social pressure",
      "Elevated interest rate environment — refinancing risk"
    ]
  },
  "contagion": {
    "score": 52,
    "tradeLinks": 24,
    "concentratedPartners": 1,
    "contagionLevel": "MODERATE",
    "signals": [
      "24 trade partners — dense trade network (contagion transmission channels)",
      "Trade HHI 2800 — concentrated trade dependency",
      "Top partner controls 38% of trade — contagion channel"
    ]
  },
  "currencyCrisis": {
    "score": 68,
    "volatility": 11,
    "depreciationSignals": 7,
    "crisisLevel": "SEVERE",
    "signals": [
      "Significant currency depreciation — balance of payments stress",
      "11 volatile moves — unstable currency pattern",
      "Low reserve cover and/or current account deficit — currency defense limited"
    ]
  },
  "disasterFiscal": {
    "score": 34,
    "disasterExposure": 4,
    "fiscalBufferWeakness": 6,
    "vulnerabilityLevel": "MODERATE",
    "signals": [
      "Weak fiscal buffers — limited capacity to absorb disaster shocks"
    ]
  },
  "allSignals": [
    "Multiple debt distress indicators — elevated sovereign risk",
    "High inflation indicators — debt erosion and social pressure",
    "Elevated interest rate environment — refinancing risk",
    "24 trade partners — dense trade network (contagion transmission channels)",
    "Trade HHI 2800 — concentrated trade dependency",
    "Top partner controls 38% of trade — contagion channel",
    "Significant currency depreciation — balance of payments stress",
    "11 volatile moves — unstable currency pattern",
    "Low reserve cover and/or current account deficit — currency defense limited",
    "Weak fiscal buffers — limited capacity to absorb disaster shocks"
  ],
  "recommendations": [
    "Elevated sovereign stress — reduce exposure or hedge",
    "Currency crisis risk — consider FX hedging or local currency bond avoidance",
    "High sovereign risk — require credit default swap protection"
  ]
}

出力フィールド

フィールド	型	説明
country	string	クエリで指定された国名
compositeScore	number (0-100)	総合信用力スコア。値が高いほどリスクが低い（未加工のリスクスコアを反転した値）
verdict	string	INVESTMENT_GRADE / SPECULATIVE / HIGH_YIELD / DISTRESSED / DEFAULT_RISK
sovereignStress.score	number (0-100)	ソブリンストレス指数。値が高いほど財政ストレスが大きい
sovereignStress.debtIndicators	number	IMFデータから検出された債務危機シグナルの数
sovereignStress.inflationSignals	number	検出されたインフレストレスシグナルの数
sovereignStress.stressLevel	string	STABLE / WATCH / ELEVATED / DISTRESSED / CRISIS
sovereignStress.signals	string[]	ストレスモデルによる、人が読める形式のシグナル説明
contagion.score	number (0-100)	波及ネットワークリスクスコア。値が高いほど波及リスクが大きい
contagion.tradeLinks	number	COMTRADEデータで特定された異なる貿易相手国の数
contagion.concentratedPartners	number	HHI集中度のしきい値を超えると判定された相手国の数
contagion.contagionLevel	string	ISOLATED / LOW / MODERATE / HIGH / SYSTEMIC
currencyCrisis.score	number (0-100)	通貨危機の確率スコア
currencyCrisis.volatility	number	3%のしきい値を超える変動の大きいFX変動の数
currencyCrisis.depreciationSignals	number	リアルタイムの為替レートデータから得られた、現在の通貨下落シグナルの数
currencyCrisis.crisisLevel	string	STABLE / MILD_PRESSURE / MODERATE_STRESS / SEVERE / CRISIS
disasterFiscal.score	number (0-100)	災害と財政の複合脆弱性スコア
disasterFiscal.disasterExposure	number	当該国について返されたGDACSアラートの合計数
disasterFiscal.fiscalBufferWeakness	number	IMFデータから得られた財政バッファーの脆弱性シグナルの数
disasterFiscal.vulnerabilityLevel	string	RESILIENT / LOW / MODERATE / VULNERABLE / CRITICALLY_EXPOSED
allSignals	string[]	4つすべてのモデルのシグナルを1つの配列にまとめたもの
recommendations	string[]	スコアから導き出された、実行可能なポートフォリオの推奨事項

ソブリン債務の伝染分析には、どれくらいの費用がかかりますか？

この MCP サーバーはイベントごとの従量課金制です。ツール呼び出し1回につき0.045ドルをお支払いいただきます。プラットフォームのコンピューティング費用は含まれています。1回の呼び出しですべての基盤データソース8つを実行する regional_contagion_scenario を含め、7つのツールすべてが同じ料金です。

シナリオ	ツール呼び出し回数	1回あたりの料金	合計金額
国の簡易チェック	1	$0.045	$0.045
ストレス評価＋通貨ペア	2	$0.045	$0.090
国の4次元すべてを対象とする評価	4	$0.045	$0.180
10か国の月次モニタリング	10	$0.045	$0.45
50か国の週次ポートフォリオ調査	50	$0.045	$2.25

費用を管理するため、実行ごとに支出上限を設定できます。予算に達するとサーバーは処理を停止し、部分的な結果ではなく、構造化されたエラーを返します。

Bloomberg Terminalのソブリンリスクモジュールは年間24,000ドル以上、Moody's CreditViewは年間15,000～50,000ドルです。ほとんどのアナリストのワークフローでは、このサーバーの利用料は月額5ドル未満で、サブスクリプション契約も必要ありません。

この MCP サーバーへの接続方法

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "sovereign-debt-contagion": {
      "url": "https://sovereign-debt-contagion-mcp.apify.actor/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_TOKEN"
      }
    }
  }
}

Cursor / Windsurf / Cline

IDE の MCP サーバー設定パネルで、同じ URL と認証ヘッダーを追加します。このサーバーは標準の MCP Streamable HTTP トランスポートを使用しており、リモートサーバーに対応するあらゆる MCP クライアントと互換性があります。

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

# Run the full regional contagion scenario for Turkey
run = client.actor("ryanclinton/sovereign-debt-contagion-mcp").call(run_input={})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"Country: {item.get('country')}")
    print(f"Verdict: {item.get('verdict')} (Score: {item.get('compositeScore')})")
    print(f"Stress Level: {item.get('sovereignStress', {}).get('stressLevel')}")
    print(f"Currency Crisis: {item.get('currencyCrisis', {}).get('crisisLevel')}")
    for signal in item.get("allSignals", []):
        print(f"  Signal: {signal}")
    for rec in item.get("recommendations", []):
        print(f"  Recommendation: {rec}")

JavaScript

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "YOUR_API_TOKEN" });

const run = await client.actor("ryanclinton/sovereign-debt-contagion-mcp").call({});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
for (const item of items) {
  console.log(`Country: ${item.country}`);
  console.log(`Verdict: ${item.verdict} (Composite Score: ${item.compositeScore})`);
  console.log(`Stress Level: ${item.sovereignStress?.stressLevel}`);
  console.log(`Contagion Level: ${item.contagion?.contagionLevel}`);
  (item.recommendations || []).forEach(r => console.log(`  Recommendation: ${r}`));
}

cURL（MCP を直接呼び出す場合）

# Call the sovereign_stress_assessment tool directly
curl -X POST "https://sovereign-debt-contagion-mcp.apify.actor/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"sovereign_stress_assessment","arguments":{"country":"Turkey"}},"id":1}'

# Call the full regional_contagion_scenario tool for Argentina with regional context
curl -X POST "https://sovereign-debt-contagion-mcp.apify.actor/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"regional_contagion_scenario","arguments":{"country":"Argentina","region":"Latin America"}},"id":2}'

Sovereign Debt Contagion MCP Server の仕組み

データ収集：8つのデータソースを並列で統合

ツールが呼び出されると、runActorsParallel() は Promise.all を使用して、アクターの呼び出しを並行して実行します。各呼び出しは、内部 ID で指定された Apify アクターを対象とします。IMF Economic Data (gc3sx9TauOIK8qzuC)、World Bank Indicators (CbOYiMOHucFZsYgho)、OECD Statistics (e0JbdfmO4cqfO05tE)、UN COMTRADE (NJCh32GyIiVnSTzqO)、Exchange Rate Tracker (wsC4YmRmJJl5RAVVY)、Exchange Rate History (gh3BeaT9qw9MKrdPP)、FRED Economic Data (gz0VOFSLZkFwhqOS8)、GDACS Disaster Alerts (pmweI2ngI1bo4l6KD) です。基盤となるすべてのアクターは、512MB のメモリと120秒のタイムアウトで実行されます。失敗したアクターは例外をスローせず、空の配列を返すため、スコアリングパイプラインから常に部分的な結果が返されます。

スコアリング：個別に調整されたしきい値を持つ4つの独立モデル

ソブリンストレス指数（最大100点）は、4つのサブスコアを組み合わせます。IMFの債務指標（最大35点。債務/GDP比率が80％を超えると3点、100％を超えると合計5点、財政赤字が-5％を下回ると3点）、世界銀行のガバナンス百分位が30未満（4倍の倍率で最大25点）、FREDの米国債10年利回りが4％超またはスプレッドが2％超（最大20点）、IMFのインフレ指標が5％超（最大20点）です。5段階の深刻度は、スコアのしきい値0、20、40、60、80に対応します。

連鎖ネットワーク（最大100点）は、UN COMTRADEの二国間フローを使用し、パートナー数をリンク密度スコアとして算出します（最大35点）。また、取引額に占めるパートナー別シェアからハーフィンダール・ハーシュマン指数を算出します（最大30点。HHIが2,500を超えた場合、および最大パートナーのシェアが30％を超えた場合は、それぞれ明示的なシグナルを発します）。さらに、OECDの国境を越える金融フローのシグナル（最大20点）と、パートナー数が15を超え、かつHHIが1,500を超えた場合に加算される15点のネットワーク増幅ボーナスで構成されます。

通貨危機確率（最大100点）は、為替レートトラッカーによる現在の下落率をスコア化します（最大30点。変動率が5％、10％、20％を超えるごとに段階的に加点）。また、変動率が3％および10％を超える値動きをカウントした価格系列に基づく過去のボラティリティ（最大30点）、IMFの外貨準備カバー月数と経常収支データ（最大25点。外貨準備カバーが3か月未満の場合は3点、経常収支が-5％を下回る場合は2点）を評価します。下落率とボラティリティが同時に発生し、外貨準備カバーが低い場合は、15点の加速ボーナスが加算されます。

災害・財政脆弱性（最大100点）は、GDACSのアラートを数え、赤・オレンジ・深刻の分類ごとに5点を加算します（最大35点）。さらに、債務と外貨準備のシグナルによるIMFの財政余力の弱さ（4倍の倍率で最大30点）、世界銀行の貧困および一人当たりGDPのシグナル（最大20点）、災害への曝露と財政の弱さがどちらもしきい値を超えた場合に加算される15点の複合脆弱性スコアで構成されます。

複合スコアと判定の割り当て

複合スコアは、100 - riskScore として算出します。ここで、riskScore = 0.35 × stress + 0.25 × currency + 0.20 × contagion + 0.20 × disaster です。リスクスコアを反転することで、債券格付けの慣例に沿った結果（高いほど良好）になります。これは債券運用の実務者が格付けを読み取る方法と一致します。判定のしきい値は、75以上＝INVESTMENT_GRADE、55～74＝SPECULATIVE、35～54＝HIGH_YIELD、15～34＝DISTRESSED、15未満＝DEFAULT_RISKです。危機時の上書きルールでは、sovereignStress.stressLevel === 'CRISIS' と currencyCrisis.crisisLevel === 'CRISIS' が同時に成立した場合、複合スコアの平均化を適用せず、加重スコアにかかわらずDEFAULT_RISKを強制します。

最良の結果を得るためのヒント

1. なじみのない国には、まず regional_contagion_scenario を使用します。 どの単一ツールとも同じ料金で、4つすべてのスコアリング指標に加えて、総合判定、シグナル、推奨事項を1回の呼び出しで取得できます。これにより、どの指標をさらに詳しく調査するかを決める前に、全体像を把握できます。

2. スコアは絶対確率ではなく、相互に比較して解釈します。 同じ手法とデータ時点を用いた場合、ブラジルのソブリンストレススコアが60であれば、スコアが40の国よりもブラジルのストレスが高いことを意味します。説明にはラベル付きの段階（WATCH、ELEVATED、DISTRESSED）を使い、ポートフォリオの順位付けには生のスコアを使います。

3. ストレス下にある国を特定したら、contagion_network_analysis を使用します。 sovereign_stress_assessment がある国について DISTRESSED または CRISIS を返した場合、その国の主要な貿易相手国トップ3を対象に contagion_network_analysis を実行し、ストレスが次にどこへ伝わるかを把握します。これが、実際に伝染が波及する仕組みです。単一国のストレスは、まず貿易経路を通じて広がります。

4. EM 通貨には通貨ペアを明示します。 currency_crisis_probability ツールでは、為替データソースは「Turkey」よりも「USD/TRY」のほうが正確に応答します。管理相場制の通貨では、モデルが実際の圧力を過小評価することがあります。結果を解釈する際は、この点に留意してください。

5. ポートフォリオのモニタリングには、毎月の一括チェックを実行します。 1回の呼び出しが0.045ドルの場合、各国につき regional_contagion_scenario を1回実行して20か国のソブリンを毎月チェックすると、費用は0.90ドルです。Apify Scheduler でスケジュールし、Webhook を使って Google Sheet または Slack チャンネルに結果を送信します。

6. 融資判断では、財政余力と災害脆弱性を組み合わせます。 fiscal_headroom_analysis は、IMF の債務・歳入データと OECD の予算系列を対象に検索します。開発金融の評価では、これと併せて disaster_fiscal_vulnerability を実行し、構造的な債務余力とショックによるリスクの両方を1つのワークフローで把握します。

7. 出力を判断に用いる際は、データの鮮度を考慮します。 IMF World Economic Outlook は半年ごと（4月と10月）に更新されます。World Bank の年次指標は年1回、FRED は1営業日以内に更新され、為替レートデータはほぼリアルタイムで、GDACS のアラートはリアルタイムです。ソブリンストレススコアは、直近に公表された公式データを反映しているため、状況が急速に悪化している場合、実情より6～12か月遅れることがあります。

他の Apify アクターとの組み合わせ

アクター	組み合わせ方
FRED Economic Data	信用スプレッドやイールドカーブの形状など、追加の米国マクロ系列を取得し、sovereign_stress_assessment の借り換えリスクリスクシグナルに世界的な金利動向のコンテキストを加えます
IMF Economic Data	IMF WEO の特定の系列に直接クエリを実行し、fiscal_headroom_analysis の対象国のうち、データの網羅性が低い国について、データを補完またはバックフィルします
World Bank Indicators	ストレスモデルや災害モデルで使用されるデフォルトの世界銀行クエリでは十分にカバーされていないフロンティア市場について、詳細なガバナンスと貧困の時系列データを取得します
UN COMTRADE Search	商品レベルの貿易フローを抽出し、contagion_network_analysis の集計貿易額では把握できない、特定の商品経路を通じた伝染経路を特定します
Exchange Rate History	関心のある通貨の過去5～10年分のデータを取得し、currency_crisis_probability で使用されるデフォルトの遡及期間よりも詳細なボラティリティのベースラインを構築します
GDACS Disaster Alerts	GDACS をリアルタイムで監視し、ポートフォリオ内の国で新たに重大度が赤のイベントが公開されるたびに、Webhook 経由で新しい disaster_fiscal_vulnerability 呼び出しをトリガーします
OECD Statistics Search	OECD の特定の財政または金融系列にクエリを実行し、詳細な資本勘定データを使って、contagion_network_analysis で使用される国境を越えた金融シグナルのセットを拡充します

制限事項

• データの鮮度は情報源によって異なります。 IMF World Economic Outlook と World Bank の年次系列は、四半期ごとから年次で更新されます。スコアは最新の公式公開データを反映しますが、ハイパーインフレーションや急性の通貨危機のように状況が急速に変化する場合、現在の経済状況から6～12か月遅れることがあります。
• フロンティア市場ではデータの欠落があります。 IMF 第4条協議の実績が限られている国、COMTRADE への報告が少ない国、または OECD のパートナーシップ資格を持たない国のうち、小規模な主権主体や近年成立した主権主体では、取得できる指標が少なくなります。データが欠落している場合、リスクを過大評価するのではなく、保守的にスコアを算出します（ポイントは加算されません）。このため、データの乏しい国では実際のリスクが過小評価される可能性があります。
• 閾値はシグナルに基づいており、回帰モデルで調整されていません。 閾値（例：債務／GDP比が80％超、最大貿易相手国のシェアが30％超）は、過去の危機の先行兆候を参考に設定されていますが、予測モデルとして正式にバックテストされていません。出力は人間の判断を支援する構造化されたシグナルとして扱い、特定の信頼区間を伴う定量的なデフォルト確率として扱わないでください。
• リアルタイムの市場価格やニュースのセンチメントは含まれません。 このサーバーは、ソブリンCDSスプレッド、債券利回り、ニュースのセンチメントを取り込みません。こうした先行指標は、公式統計に反映される前に大きく変動する可能性がありますが、4つのスコアリングモデルのいずれにも反映されません。
• 通貨データはFX通貨ペアの照合に依存します。 標準的でないペア表記、過去のデータが限られている通貨、または管理相場制の通貨では、通貨危機モデルが実際の圧力を過小評価する可能性があります。ペアを明示すると（例：「USD/ARS」）、データの照合精度が向上します。
• 貿易ネットワークが捉えるのは報告された取引フローのみです。 制裁対象の経済でよく見られる非公式貿易、迂回輸出入、報告が不十分な二国間取引フローは、COMTRADE データに基づく実際の波及リスクを過小評価させます。HHI は構造的な集中度を適切に特定しますが、最近の未報告の貿易多角化は反映されない可能性があります。
• 法律上または投資上の助言に代わるものではありません。 出力は、多国間機関が公開しているデータに基づく分析シグナルです。信用格付け、投資推奨、または規制遵守の評価を構成するものではありません。

インテグレーション

• Apify API — Python、JavaScript、または任意のHTTPクライアントからソブリンリスク評価をプログラムで実行し、データセットエンドポイントから構造化JSONを取得します
• Webhooks — 監視対象の国のスコアが事前設定した閾値を超えた際に、Slackまたは内部システムにアラートを送信します
• Zapier — ソブリンリスクレポートを Google Sheets、Airtable、または Notion に連携し、コード不要でポートフォリオをリアルタイムに追跡するダッシュボードを作成します
• Make — 毎月の国別スイープを実行し、構造化された要約をアナリストの受信トレイに配信する自動ワークフローを構築します
• Google Sheets — 主権主体の対象全体について、総合スコアと各評価軸の判定結果をリアルタイムのスプレッドシートに反映し、継続的に監視します
• LangChain / LlamaIndex — ソブリンリスクの出力を、マクロ調査やレポート作成を行う RAG パイプラインまたは AI エージェントで、構造化されたコンテキストとして使用します

トラブルシューティング

• 明らかに国のストレスが見られるのに、スコアが低い、またはゼロになる — 最もよくある原因は、公式データの対象範囲が限られていることです。非常に小規模な国、制裁対象国、またはデータを報告していない国については、IMF、World Bank、COMTRADE のデータが限られています。国名に加えて ISO 国コードも試し、その国について IMF が第 IV 条協議のデータを公開しているか確認してください。データが欠けている場合、リスクスコアは引き上げられず、保守的にゼロとして評価されます。

• regional_contagion_scenario の実行に予想以上に時間がかかる — このツールは、タイムアウトをそれぞれ 120 秒に設定して、基盤となる 8 つのアクターすべてを並列で実行します。全体の所要時間は最も遅い単一のデータソースによって決まり、COMTRADE データセットが大きい国や GDACS に負荷がかかっている場合は、45～90 秒に達することがあります。これは想定された動作です。より速く結果を得るには、使用するデータソースが少ない sovereign_stress_assessment や contagion_network_analysis などの個別ツールを使用してください。

• 結果の代わりに支出上限エラーが返される — データ収集が始まる前に Actor.charge() の呼び出しが実行されます。Apify アカウントの支出上限または実行ごとの予算にすでに達している場合、ツールはクエリを試行せずに {"error": true, "message": "Spending limit reached for ..."} を返します。Apify コンソールの設定で実行予算を増やしてから、再試行してください。

• 通貨に既知の圧力があるのに、通貨危機スコアが低い — このモデルは為替レートフィードの対象範囲と、IMF の外貨準備高・経常収支統計に依存しています。対象通貨のフィード対象範囲が限られている場合は、明示的に通貨ペアを指定してください（例："currency": "USD/NGN"）。公式レートが人為的に固定されている管理フロート制の為替レートでは、モデルが実際の圧力を過小評価するため、結果を解釈する際はこの注意点を考慮してください。

• 貿易相手国が多い国の感染スコアが低い — HHI が評価するのは相手国の数ではなく、集中度です。貿易相手国 40 か国に均等に分散している国では HHI が低く、集中度スコアも低くなります。これは適切な解釈です。貿易エクスポージャーの多様化により、単一チャネルを通じた感染リスクが実際に低下するためです。間接的な感染が懸念される場合は、その国の主要な個別貿易相手国を対象に contagion_network_analysis を実行してください。

責任ある利用

• この MCP サーバーが取得するすべてのデータは、研究および商用利用を認めるオープンデータポリシーの下で公開されている、多国間国際機関（IMF、World Bank、OECD、UN COMTRADE、FRED）のデータです。
• このサーバーから得られる国別リスクスコアは分析上の指標であり、適切な専門家の監督なしに、信用格付け、投資推奨、または規制上の評価として公表してはなりません。
• 国別リスクの出力を、本来の金融・マクロ経済分析という目的を逸脱して、個人、組織、またはコミュニティへの差別に使用しないでください。
• 為替レートおよびマクロ経済データは情報提供のみを目的としており、金融アドバイスを構成するものではありません。
• 公開データの利用に関する法的な案内については、Apify のガイドを参照してください。

FAQ

国債の感染分析は、信用格付け機関とどう違いますか？ 格付け機関が公表するのは、更新頻度が低く、悪化がすでに周知された後に更新されることも多い序数尺度の格付けです。このサーバーは、リアルタイムおよび最近更新された公開データから 0～100 の定量スコアを生成し、継続的なモニタリングと、指標悪化の早期検知を可能にします。これは正式な信用分析を補完するものであり、代替するものではありません。

1 回のセッションで、国別債務感染ツールを使って何か国を分析できますか？ 1 回のセッションで分析できる国数に上限はありません。各ツール呼び出しの料金は 0.045 ドルなので、regional_contagion_scenario を使って（1 回の呼び出しで 4 つすべての側面を）20 か国分析する場合、料金は 0.90 ドルです。Apify API を使用してプログラムから一括スイープを実行するか、Apify Scheduler で定期的なスイープをスケジュールしてください。 ソブリン債の伝染分析はフロンティア市場の債務も対象にしていますか？ 対象範囲は、IMF、世界銀行、UN COMTRADE のデータが利用可能かどうかによって異なります。国際的に取引されているソブリン債がある国の大半は、IMF と世界銀行のデータが十分にそろっています。第4条協議の履歴が限られている国や、COMTRADE の報告に欠落がある真のフロンティア市場では、スコアの信頼度が低くなります。その場合、サーバーは欠損データに対してスコアを不当に高くするのではなく、低いスコアを返します。

伝染ネットワークの HHI スコアの精度はどの程度ですか？ HHI は、貿易統計の権威ある国際情報源である UN COMTRADE が報告する二国間貿易フローから直接算出されます。精度は、COMTRADE の報告の遅れ（通常12～18か月）や、非公式取引または制裁対象の取引における過少報告によって制限されます。このモデルは構造的な集中を正しく特定しますが、ごく最近の貿易の多角化を捉えられない場合があります。

ソブリンリスクのスコアリングに使われるマクロ経済データは、どの程度最新ですか？ 為替レートデータはほぼリアルタイムです。FRED は1営業日以内に更新されます。IMF の世界経済見通しは年2回（4月と10月）更新されます。世界銀行の年間指標は年1回更新されます。GDACS の災害アラートはリアルタイムです。リスクスコアには、クエリ実行時に各データソースから入手可能な最新データが反映されます。

ソブリン債の伝染分析を通貨取引の判断に利用できますか？ currency_crisis_probability ツールは、為替変動パターンと準備金データに基づく分析シグナルを提供するものであり、取引シグナルシステムではありません。市場のマイクロストラクチャー、ポジションデータ、短期的な材料は考慮されません。執行のタイミングではなく、中期的なリスク評価やポートフォリオのポジショニングにご利用ください。

ソブリン分析に IMF や世界銀行のデータを商用利用することは合法ですか？ はい。IMF、世界銀行、OECD、UN COMTRADE、FRED のデータは、出典明記の要件に従うことを条件に、研究、分析、商用目的での利用を明示的に認めるオープンデータポリシーに基づいて公開されています。各機関の利用規約とデータの合法性に関する Apify のガイドをご確認ください。

DEFAULT_RISK 判定は何を意味しますか？ デフォルトの予測ですか？ DEFAULT_RISK は、複合スコアが15を下回り、4つすべてのリスク次元が同時に極度のストレスを示していることを意味します。これは、状況が過去のデフォルト前の環境に類似していることを示す構造化されたシグナルであり、特定の信頼区間を伴う確率的予測ではありません。追加調査と専門家による信用評価が緊急に必要であることを示すフラグとして扱ってください。

ソブリン債の伝染分析ツールを使って、2か国を直接比較できますか？ country と任意の benchmark パラメーターを指定して compare_sovereign_risks を使うと、並行して評価できます。数値を直接比較するには、各国について regional_contagion_scenario を実行し、複合スコアと次元ごとのラベルを並べて比較してください。

ソブリン債のスコアリングエンジンにおける危機時の上書きルールは、どのように機能しますか？ sovereignStress.stressLevel === 'CRISIS' と currencyCrisis.crisisLevel === 'CRISIS' が同時に成立すると、加重複合スコアにかかわらず、複合判定は DEFAULT_RISK に強制されます。これにより、財政危機と通貨危機が同時発生する、最も危険で歴史的にも予測力の高い構成において、災害リスクや伝染リスクのスコアが低いことで急性の二重危機が覆い隠されるのを防ぎます。

このサーバーでソブリンリスクの定期的な監視をスケジュールできますか？ はい。Apify Scheduler を使って、毎日、毎週、または毎月の間隔で実行をトリガーできます。Apify Webhooks と組み合わせると、複合スコアがポートフォリオ運用のために設定したしきい値を超えた際に、結果を Slack チャンネル、Google Sheet、または社内のアラートシステムに送信できます。 災害に対する財政的脆弱性は、気候関連のソブリンリスクをどのように捉えますか？ disaster_fiscal_vulnerability ツールは、GDACS のリアルタイムアラート（洪水、サイクロン、干ばつ、地震）と、IMF の財政バッファーデータおよび世界銀行の貧困指標を組み合わせて使用します。GDACS アラートの頻度が高く、深刻度が赤またはオレンジに分類され、財政準備金が乏しく、貧困率が高い国は、「脆弱」または「極めて高いリスクにさらされている」と評価されます。これは、小島嶼開発途上国や低所得国にとって特に重要です。大規模な気候イベントが一度発生しただけで、債務再編につながる可能性があるためです。

改善にご協力ください

問題が発生した場合、Apify アカウントで実行の共有を有効にすると、より迅速なデバッグに役立ちます。

1. アカウント設定 > プライバシーに移動します
2. 実行を公開 Actor 作成者と共有するを有効にします

これにより、問題が発生した際に実行の詳細を確認できるため、より迅速に修正できます。お客様のデータは Actor の開発者にのみ表示され、一般公開されることはありません。

サポート

バグを見つけた場合や機能リクエストがある場合は、この Actor のページにあるIssues タブでイシューを作成してください。独自のソブリンリスクワークフロー、地域的な波及シナリオのモデリング、またはエンタープライズ統合については、Apify プラットフォームからお問い合わせください。