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 灾害预警），生成综合主权风险判定，范围从 INVESTMENT_GRADE 到 DEFAULT_RISK。用自然语言提问，即可在几秒内收到包含数值评分、校准信号和投资组合建议的结构化 JSON。

该服务运行 7 种不同的 MCP 工具，涵盖主权风险的各个维度：财政压力、贸易渠道传染、货币危机概率、财政空间、灾害与财政复合脆弱性、多国比较，以及完整的区域情景规划。所有 8 个底层数据源均通过 Promise.all 并行调用，将总延迟缩短至最慢的单个数据源所需时间。一次性完成设置后，无需编写代码。

可以提取哪些数据？

数据点	来源	示例
📊 债务占 GDP 比率、财政余额、经常账户赤字	IMF 世界经济展望	债务/GDP：87.4%，赤字：-6.2%
🏛️ 政府效能、政治稳定、法治	World Bank 指标	政府效能：第 28 百分位
🏦 跨境资本流动、金融一体化信号	OECD 统计数据	资本外流：标记为 -$4.2B
🔗 双边贸易流量、贸易伙伴网络、HHI 集中度	UN COMTRADE	34 个贸易伙伴，HHI：3,200 — 集中度高
💱 实时汇率、贬值百分比变化	汇率追踪器	USD/TRY：变化信号 +18.3%
📉 历史汇率波动序列、危机模式匹配	汇率历史数据	90 天内出现 12 次大幅波动
🇺🇸 美国 10 年期国债利差、全球利率环境	FRED 经济数据	GS10：4.8%，利差：5.4%
🌍 自然灾害预警、严重程度分类	GDACS 灾害预警	3 条预警，其中 2 条为 ORANGE 级别
⚠️ 综合主权风险评分和判定	4 模型评分引擎	评分：38，判定：HIGH_YIELD
📋 所有校准信号和可执行建议	合并全部 8 个数据源	10 条信号，3 条投资组合建议

为什么使用 Sovereign Debt Contagion MCP 服务？

传统主权信用分析需要一个团队从 IMF 门户、World Bank API、COMTRADE 和 FRED 获取数据，然后手动计算债务可持续性指标、贸易集中度指数和汇率波动信号。每个国家的分析都要耗费数小时，不同分析师的结果也不一致，而 Bloomberg Terminal 或 Moody's CreditView 订阅每年要花费数万美元。

此服务可自动完成整个流程。提供一个国家名称后，它会并行调用最多 8 个数据源，应用四种经过验证的评分模型，并通过你现有的 AI 客户端返回结构化判定——完成设置后，无需编写任何代码即可使用。

• 定时调度 — 通过 Apify Scheduler 每周对投资组合进行主权压力扫描，在新兴风险登上新闻之前及时发现
• API 访问 — 使用 Apify API 和完整 JSON 输出，通过 Python、JavaScript 或任何 HTTP 客户端触发评估
• 代理轮换 — 所有底层数据收集均使用 Apify 的代理基础设施，确保可靠访问国际数据门户
• 监控 — 当主权压力评分超过指定阈值时，通过 Apify Webhook 设置 Slack 或电子邮件提醒
• 集成 — 将输出连接到 Zapier、Make、Google Sheets 或 Webhook，以支持下游投资组合监控工作流

功能

• 四种独立评分模型 — 主权压力指数、传染网络图、货币危机概率和灾害—财政脆弱性模型各自生成一个 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 个数据源，并在一次调用中以相同价格返回全部四个维度及综合评估
• 经过校准的信号文本 — 每种评分模型都会生成易于理解的信号（例如“贸易 HHI 为 3,200 — 贸易依赖度集中”），并汇总到 allSignals 中，供分析师审阅
• MCP 待机模式 — 在 Apify 的基础设施上持续运行，消除同一会话中连续查询不同国家时的冷启动延迟

主权债务传染分析的使用场景

主权信用研究

资产管理公司的固定收益分析师和信用团队会使用此服务生成量化压力评分，作为传统评级机构评估的补充。由于此服务近乎实时地从 IMF 和 FRED 获取先行指标，因此能够在正式评级行动前数月发出财政状况恶化的信号。每周对主权债券投资组合进行压力扫描，可在信号演变为 DISTRESSED 之前发现 WATCH 或 ELEVATED 信号。

新兴市场货币风险管理

外汇交易员和新兴市场基金经理使用 currency_crisis_probability 持续监测货币。该工具将当前贬值信号与已知危机先兆的历史波动模式匹配结合起来。当得分超过 50 且储备覆盖低于 3 个月的进口额时，输出会明确建议进行外汇对冲或避免持有本币债券；这些可执行建议直接依据数据得出。

贸易渠道传染映射

拥有跨境敞口的投资组合经理使用 contagion_network_analysis，了解某国发生主权危机时会如何传导至其贸易伙伴。HHI 集中度评分可识别哪些国家最容易受到单一贸易伙伴违约引发的连锁冲击；对于在土耳其、阿根廷或撒哈拉以南非洲前沿市场有集中区域敞口的新兴市场投资组合，这一点尤为重要。

发展融资贷款评估

多边开发银行和双边贷款方使用 fiscal_headroom_analysis，评估一国在触及压力阈值前还能承受多少新增主权债务。该工具结合 IMF 债务可持续性指标和 OECD 财政统计数据，生成财政空间评分，并提供具体的赤字和债务信号。

灾害与财政复合风险分析

气候融资团队和灾难债券发行方使用 disaster_fiscal_vulnerability，识别自然灾害暴露会加剧财政疲弱的国家。GDACS 警报频率高且财政储备有限的小岛屿发展中国家面临复合风险，一次灾害事件就可能触发债务重组。该工具根据实时 GDACS 数据，对这种交互影响进行明确评分。

区域传染情景规划

首席投资官和宏观策略师使用 regional_contagion_scenario 运行完整的区域压力测试。提供一个国家和可选的区域背景信息；服务会查询全部 8 个数据源，并返回完整报告，涵盖全部四个风险维度、所有信号和投资组合建议。可用于季度情景规划，或应对特定的宏观事件。

如何使用主权债务传染分析

1. 将 MCP 服务连接到 AI 客户端 — 将服务 URL https://sovereign-debt-contagion-mcp.apify.actor/mcp 添加到 Claude Desktop、Cursor 或 Windsurf 配置中，并在 Authorization: Bearer 标头中填入 Apify API token（参见下方连接示例）。
2. 用自然语言提问 — 在 AI 客户端中输入“评估阿根廷的主权压力”或“对土耳其运行完整的传染情景”。客户端会自动调用相应工具。
3. 服务并行运行最多 8 个数据源 — 根据所用工具，服务会同时查询 IMF、World Bank、UN COMTRADE、FRED、汇率数据源和 GDACS。根据该国的数据可用性，预计耗时 15-60 秒。
4. 查看结构化输出 — AI 客户端会显示 JSON 结果，其中包含数值评分（0-100）、标签化结论、校准后的信号，以及针对各个风险维度的具体投资组合建议。

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，涵盖全部四个维度及建议

工具参数

参数	工具	类型	必填	描述
country	所有工具	字符串	是	国家名称或 ISO 代码（例如，“Turkey”“TUR”“Argentina”）
period	sovereign_stress_assessment	字符串	否	分析期间（例如，“2024”“过去 5 年”）
currency	currency_crisis_probability	字符串	否	明确指定的货币对覆盖项（例如，“USD/TRY”）
benchmark	compare_sovereign_risks	字符串	否	用于相对比较的基准国家（例如，“Brazil”）
region	regional_contagion_scenario	字符串	否	贸易网络查询的区域背景（例如，“Latin America”）

输入提示

• 使用完整国家名称可获得最佳结果——对于大多数来源，“Argentina”比“AR”能返回更全面的 IMF 和 World Bank 数据。
• 提供货币对可进行精确的外汇分析——使用 currency_crisis_probability 时，指定 currency: "USD/TRY" 比单独使用国家名称能更准确地定位汇率数据源，尤其是货币标识符不常见的新兴市场货币。
• 使用 regional_contagion_scenario 进行全面评估——价格与单独使用工具时相同，均为 $0.045；它会运行全部 8 个数据源，并在一次调用中返回全部四个评分维度。
• 传入区域参数以进行传染建模——对于 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	字符串	查询中提供的国家名称
compositeScore	数字（0-100）	综合信用质量评分；分数越高＝风险越低（与原始风险评分方向相反）
verdict	字符串	INVESTMENT_GRADE / SPECULATIVE / HIGH_YIELD / DISTRESSED / DEFAULT_RISK
sovereignStress.score	数字（0-100）	主权压力指数；分数越高＝财政压力越大
sovereignStress.debtIndicators	数字	IMF 数据中触发的债务困境信号数量
sovereignStress.inflationSignals	数字	触发的通胀压力信号数量
sovereignStress.stressLevel	字符串	STABLE / WATCH / ELEVATED / DISTRESSED / CRISIS
sovereignStress.signals	字符串[]	压力模型生成的易读信号描述
contagion.score	数字（0-100）	传染网络风险评分；分数越高＝传导风险越大
contagion.tradeLinks	数字	在 COMTRADE 数据中识别出的不同贸易伙伴数量
contagion.concentratedPartners	数字	HHI 集中度超过阈值的合作伙伴数量
contagion.contagionLevel	字符串	ISOLATED / LOW / MODERATE / HIGH / SYSTEMIC
currencyCrisis.score	数字（0-100）	货币危机概率评分
currencyCrisis.volatility	数字	超过 3% 阈值的波动性外汇变动次数
currencyCrisis.depreciationSignals	数字	实时汇率数据中当前贬值信号的数量
currencyCrisis.crisisLevel	字符串	STABLE / MILD_PRESSURE / MODERATE_STRESS / SEVERE / CRISIS
disasterFiscal.score	数字（0-100）	灾害与财政复合脆弱性评分
disasterFiscal.disasterExposure	数字	该国收到的 GDACS 警报总数
disasterFiscal.fiscalBufferWeakness	数字	IMF 数据中的财政缓冲薄弱信号数量
disasterFiscal.vulnerabilityLevel	字符串	RESILIENT / LOW / MODERATE / VULNERABLE / CRITICALLY_EXPOSED
allSignals	字符串[]	汇总四个模型全部信号的数组
recommendations	字符串[]	根据评分生成的可执行投资组合建议

运行主权债务传染分析需要多少费用？

此 MCP 服务采用按事件付费模式——每次工具调用收费 $0.045。平台计算费用已包含在内。所有 7 个工具的定价都相同，包括 regional_contagion_scenario，它会在一次调用中运行全部 8 个底层数据源。

场景	工具调用次数	每次调用费用	总费用
快速检查国家	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}'

主权债务传染 MCP 服务的工作原理

数据收集：并行编排 8 个数据源

调用工具时，runActorsParallel() 会使用 Promise.all 并发分发 Actor 调用。每次调用都会根据内部 ID 指向特定的 Apify Actor：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）。每个底层 Actor 都使用 512MB 内存，超时时间为 120 秒。Actor 调用失败时会返回空数组，而不是抛出异常，以确保评分流程始终能返回部分结果。

评分：四个独立模型，采用校准后的阈值

主权压力指数（最高 100 分）综合四项子分数：IMF 债务指标（最高 35 分——债务/GDP 高于 80% 得 3 分，高于 100% 总计得 5 分；赤字低于 -5% 得 3 分）、世界银行治理百分位低于 30（采用 4× 倍数，最高 25 分）、FRED 美国国债 10 年期收益率高于 4% 或利差高于 2%（最高 20 分），以及 IMF 通胀信号高于 5%（最高 20 分）。五个严重程度等级分别对应 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+ = 投资级，55-74 = 投机级，35-54 = 高收益级，15-34 = distressed，低于 15 = 违约风险。如果 sovereignStress.stressLevel === 'CRISIS' 和 currencyCrisis.crisisLevel === 'CRISIS' 同时成立，则危机覆盖规则会跳过综合加权，强制判定为违约风险，无论加权分数如何。

获得最佳结果的提示

1. 对于不熟悉的国家，请从 regional_contagion_scenario 开始。 价格与任何单个工具相同，但它在一次调用中返回全部四个评分维度、综合判定、信号和建议，让你全面了解情况后，再决定哪些维度需要深入调查。

2. 比较分数时应关注相对高低，而非将其视为绝对概率。 按照相同的方法和数据版本，巴西的主权压力评分为 60，表示巴西的压力高于评分为 40 的国家。对外沟通时使用标注的等级（WATCH、ELEVATED、DISTRESSED）；进行投资组合排名时使用原始分数。

3. 识别出承压国家后，使用 contagion_network_analysis。 如果 sovereign_stress_assessment 将某个国家评为 DISTRESSED 或 CRISIS，请对该国排名靠前的 3 个贸易伙伴运行 contagion_network_analysis，以梳理压力接下来会传导到哪里。这才是传染扩散的实际方式——单个国家的压力首先会通过贸易渠道扩散。

4. 为新兴市场货币提供明确的货币对。 对于 currency_crisis_probability 工具，与其输入“Turkey”，汇率数据源对“USD/TRY”的响应会更精确。对于实行管理汇率的货币，模型可能会低估真实压力；解读结果时请注意这一点。

5. 每月进行一次扫描，以监控投资组合。 每次调用的费用为 $0.045，对 20 个主权国家每个运行一次 regional_contagion_scenario，每月压力扫描的总费用为 $0.90。可通过 Apify Scheduler 安排此任务，并通过 webhook 将结果发送到 Google Sheet 或 Slack 频道。

6. 在贷款决策中，结合财政余裕与灾害脆弱性。 fiscal_headroom_analysis 专门查询 IMF 债务收入数据系列和 OECD 预算数据系列。进行发展融资评估时，请同时运行 disaster_fiscal_vulnerability，以便在一个工作流中同时评估结构性债务能力和冲击驱动的风险。

7. 根据数据时效性谨慎采取行动。 IMF《世界经济展望》每半年更新一次（4 月和 10 月）；世界银行年度指标每年更新一次；FRED 在 1 个工作日内更新；汇率数据接近实时；GDACS 警报实时发布。主权压力评分反映最近发布的官方数据，在情况迅速恶化时，这些数据可能会滞后 6-12 个月。

与其他 Apify Actor 结合使用

Actor	组合方式
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《世界经济展望》和世界银行年度数据序列的更新频率为每季度至每年一次。评分反映最新发布的官方数据；对于恶性通胀或急性货币危机等快速变化的情况，数据可能滞后当前经济状况 6-12 个月。
• 前沿市场存在覆盖缺口。 IMF《协定》第四条磋商记录有限、COMTRADE 报告稀少或没有 OECD 合作伙伴资格的小型或新成立主权实体，返回的指标会更少。缺失数据会按保守方式处理（不增加分数），而非夸大风险；对于数据稀缺的国家，这可能低估实际风险。
• 阈值基于信号，而非经过回归校准的模型。 阈值（例如，债务/GDP 高于 80%、最大贸易伙伴占比高于 30%）参考了历史危机先兆设定，但尚未作为预测模型进行正式回溯测试。请将输出视为供人工判断的结构化信号，而非带有特定置信区间的量化违约概率。
• 不包含实时市场定价或新闻情绪。 服务不会纳入主权 CDS 利差、债券收益率或新闻情绪。这些领先指标可能在官方统计数据反映变化之前就出现显著波动，四种评分模型均未涵盖这些指标。
• 货币数据依赖外汇货币对匹配。 对于货币对表示法不规范、历史数据覆盖有限或实行管理浮动汇率制度的货币，货币危机模型可能会低估实际压力。提供明确的货币对（例如，“USD/ARS”）有助于更精准地定位数据。
• 贸易网络仅反映已报告的贸易流。 非正式贸易、贸易改道以及未充分报告的双边贸易流（在受制裁经济体中较为常见）会导致基于 COMTRADE 数据的实际传染风险敞口被低估。HHI 能正确识别结构性集中度，但可能无法反映近期未公开记录的贸易多元化。
• 不能替代法律或投资建议。 输出是根据多边机构发布的公开数据得出的分析信号，不构成信用评级、投资建议或监管合规评估。

集成

• Apify API — 使用 Python、JavaScript 或任何 HTTP 客户端以编程方式触发主权风险评估；从数据集端点获取结构化 JSON
• Webhooks — 当受监测国家集合的压力评分超过预设阈值时，向 Slack 或内部系统发送告警
• Zapier — 将主权风险报告发送到 Google Sheets、Airtable 或 Notion，无需编写代码即可创建实时投资组合跟踪仪表板
• Make — 构建自动化工作流，每月扫描各国情况，并将结构化摘要发送到分析师收件箱
• Google Sheets — 将主权国家范围内的综合评分和各维度判定结果推送到实时电子表格，以便持续监测
• LangChain / LlamaIndex — 在 RAG 流水线或执行宏观研究和报告生成的 AI Agent 中，将主权风险输出用作结构化上下文

故障排除

• 尽管某国显然承受压力，但得分较低或为零 — 最常见的原因是官方数据覆盖稀疏。IMF、World Bank 和 COMTRADE 针对规模极小、受制裁或未提交数据的经济体的数据有限。请尝试使用 ISO 国家代码，而不仅是完整国家名称，并确认 IMF 是否发布该国的 Article IV 磋商数据。缺失数据会保守地记为零，而不会抬高风险得分。

• regional_contagion_scenario 耗时超出预期 — 此工具会并行触发全部 8 个底层 Actor，每个超时时间为 120 秒。总延迟取决于响应最慢的数据源；对于 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 的指南。

常见问题

主权债务传染分析与信用评级机构的评级有何不同？ 评级机构发布的是序数评级，更新频率较低，往往在情况恶化已成为公开信息后才更新。此服务根据实时和近期更新的公开数据生成 0-100 的量化得分，从而支持持续监测，并更早发现指标恶化。它可补充正式的信用分析，但不能取代后者。

使用主权债务传染工具时，一次会话中可以分析多少个国家？ 每次会话可分析的国家数量没有硬性限制。每次工具调用费用为 $0.045，因此使用 regional_contagion_scenario 分析 20 个国家（一次调用涵盖全部四个维度）共需 $0.90。可使用 Apify API 以编程方式批量扫描，也可通过 Apify Scheduler 定期安排扫描。 主权债务传染分析是否涵盖前沿市场债务？ 覆盖范围取决于 IMF、世界银行和 UN COMTRADE 数据的可用性。大多数拥有国际交易主权债券的国家都有充足的 IMF 和世界银行数据。真正的前沿市场往往缺少足够的第四条款磋商记录，或存在 COMTRADE 报告缺口，因此得分置信度较低；对于缺失数据，服务会返回较低而非虚高的得分。

传染网络 HHI 评分的准确度如何？ HHI 直接根据 UN COMTRADE 报告的双边贸易流量计算，这些数据是国际贸易统计的权威来源。准确度受 COMTRADE 报告滞后（通常为 12-18 个月）以及非正式贸易或受制裁贸易的少报影响。该模型能够正确识别结构性集中度，但可能无法反映近期的贸易多元化。

主权压力评分使用的宏观经济数据有多新？ 汇率数据接近实时。FRED 会在 1 个工作日内更新。IMF《世界经济展望》每年更新两次（4 月和 10 月）。世界银行年度指标每年更新一次。GDACS 灾害警报为实时数据。压力评分会在查询时反映各数据源中最新可用的数据。

我可以使用主权债务传染分析来做货币交易决策吗？ currency_crisis_probability 工具根据外汇波动模式和储备数据提供分析信号，而非交易信号系统。它不考虑市场微观结构、持仓数据或短期催化因素。请将其用于中期风险评估和投资组合配置，而非择时执行。

将 IMF 和世界银行数据用于商业主权分析是否合法？ 合法。IMF、世界银行、OECD、UN COMTRADE 和 FRED 发布的数据遵循开放数据政策，明确允许将其用于研究、分析和商业用途，但须遵守署名要求。请参阅各机构的使用条款，以及 Apify 关于数据合法性的指南。

DEFAULT_RISK 判定是什么意思——这是违约预测吗？ DEFAULT_RISK 表示综合得分低于 15，即四个风险维度同时显示极端压力。这是一种结构化信号，表明当前状况类似于历史上的违约前环境，并非带有特定置信区间的概率预测。请将其视为需要进一步调查和专业信用评估的高紧急程度警示。

我可以使用主权债务传染工具直接比较两个国家吗？ 使用 compare_sovereign_risks，并设置 country 和可选的 benchmark 参数，即可并行评估。若要直接比较数值，请分别对每个国家运行 regional_contagion_scenario，并逐项对照综合得分和各维度标签。

主权债务评分引擎中的危机覆盖规则如何运作？ 当 sovereignStress.stressLevel === 'CRISIS' 和 currencyCrisis.crisisLevel === 'CRISIS' 同时为真时，无论加权综合得分如何，综合判定都会被强制设为 DEFAULT_RISK。这样可以避免较低的灾害或传染得分掩盖财政危机与货币危机同时发生的严重双重危机——这是最危险、且在历史上最具预测性的组合。

我可以使用此服务定期安排主权风险监测吗？ 可以。使用 Apify Scheduler 按日、周或月触发运行。结合 Apify Webhooks，当综合得分越过为投资组合操作设定的阈值时，可将结果推送到 Slack 频道、Google Sheet 或内部警报系统。 灾害财政脆弱性如何捕捉气候相关的主权风险？ disaster_fiscal_vulnerability 工具会结合 GDACS 实时警报（洪水、气旋、干旱、地震）、IMF 财政缓冲数据和世界银行贫困指标进行分析。GDACS 警报频率高、严重程度被划分为红色或橙色、财政储备薄弱且贫困率高的国家，会被评为 VULNERABLE（脆弱）或 CRITICALLY_EXPOSED（极度暴露）。这对小岛屿发展中国家和低收入国家尤其重要，因为一次重大气候事件就可能引发债务重组。

帮助我们改进

如果您遇到问题，可以在 Apify 账户中启用运行共享，帮助我们更快地调试：

1. 前往 账户设置 > 隐私
2. 启用 与公开的 Actor 创建者共享运行记录

这样一来，出现问题时我们就能查看您的运行详情，从而更快地修复问题。您的数据仅对 Actor 开发者可见，不会公开。

支持

发现错误或希望添加功能？请在此 Actor 页面上的 问题选项卡中提交问题。如需定制主权风险工作流、区域传染情景建模或企业集成，请通过 Apify 平台联系我们。