主权债务传染MCP服务器
查看ApifyForge | 在Apify商店中使用
______________________________________________________________________
快速开始
添加到您的MCP客户端(Claude Desktop、Cursor、Windsurf):
{
"mcpServers": {
"sovereign-debt-contagion-mcp": {
"url": "https://ryanclinton--sovereign-debt-contagion-mcp.apify.actor/mcp"
}
}
}______________________________________________________________________
为信贷分析师、宏观基金经理和发展金融机构提供主权债务传染分析——通过任何兼容MCP的人工智能客户端提供。该服务器协调8个国际数据源(国际货币基金组织、世界银行、经合组织、联合国商品贸易组织、FRED、实时和历史汇率、GDACS灾难警报),以生成从INVESTMENT_GRADE到DEFAULT_risk的综合主权风险判断。用自然语言提问,在几秒钟内收到带有数字分数、校准信号和投资组合建议的结构化JSON。
该服务器运行7个不同的MCP工具,涵盖主权风险的各个方面:财政压力、贸易渠道传染、货币危机概率、财政净空、灾害财政复合脆弱性、多国比较和全面的区域情景规划。所有8个底层数据源通过并行方式启动 Promise.all,将总延迟降至最慢的单个源。一次性设置后不需要代码。
你能提取哪些数据?
| 数据点 | 来源 | 示例 |
|---|---|---|
| 📊 债务与国内生产总值之比、财政平衡、经常账户赤字 | IMF世界经济展望 | 债务/GDP:87.4%,赤字:-6.2% |
| 🏛️ 治理有效性、政治稳定性、法治 | 世界银行指标 | 治理:第28百分位 |
| 🏦 跨境资本流动,金融一体化信号 | 经合组织统计数据 | 资本外流:-42亿美元 |
| 🔗 双边贸易流量、伙伴网络、HHI集中度 | UN COMTRADE | 34个伙伴,HHI:3200——集中 |
| 💱 实时汇率、折旧百分比变化 | 汇率跟踪器 | 美元/土耳其里拉:+18.3%变化信号 |
| 📉 历史外汇波动序列,危机模式匹配 | 汇率历史 | 90天内12次波动 |
| 🇺🇸 美国国债10年期利差,全球利率环境 | FRED经济数据 | GS10:4.8%,利差:5.4% |
| 🌍 自然灾害警报,严重程度分类 | GDACS灾害警报 | 3个警报,2个橙色严重程度 |
| ⚠️ 综合主权风险评分和判定 | 4模型评分引擎 | 评分:38,判定:高收益 |
| 📋 所有校准信号和可操作建议 | 所有8个来源组合 | 10个信号,3个投资组合建议 |
为什么要使用主权债务传染MCP服务器?
主权信用分析传统上需要一个团队从国际货币基金组织门户网站、世界银行API、COMTRADE和FRED中提取数据,然后手动计算债务可持续性指标、贸易集中度指数和外汇波动信号。这个过程在每个国家需要几个小时,在分析师之间产生不一致的输出,每年在彭博终端或穆迪信贷视图订阅中花费数万美元。
此服务器自动化了整个过程。提供一个国家名称,它将并行运行多达8个数据源,应用四个经过验证的评分模型,并通过现有的人工智能客户端返回一个结构化的判决——设置后无需编写一行代码即可访问。
- 调度 --通过Apify Scheduler对您的投资组合进行每周主权压力扫描,以便在新出现的风险到达新闻专线之前发现它们
- API访问 -使用Apify API从Python、JavaScript或任何HTTP客户端触发评估,并提供完整的JSON输出
- 代理旋转 --所有底层数据收集都使用Apify的代理基础设施,以可靠地访问国际数据门户
- 监控 --当主权压力分数超过设定的阈值时,通过Apify webhooks设置Slack或电子邮件警报
- 集成 --将输出连接到Zapier、Make、Google Sheets或webhooks,以实现下游投资组合监控工作流
特性
- 四种独立的评分模型 --主权压力指数、传染网络图、货币危机概率和灾难财政脆弱性各产生0-100分和标记的严重程度等级(例如,稳定、升高、沮丧、危机)
- 综合主权风险判断 --加权复合公式(35%主权压力+25%货币危机+20%传染+20%灾难)产生一个单一的INVESTMENT_GRADE/SPECTIVE/HIGH_YIELD/DRESSED/DEFAULT_RISK信用质量读数
- 危机压倒逻辑 --当主权压力和货币危机同时达到危机水平时,无论其他子分数如何,判决都被迫为DEFAULT_RISK,从而防止综合平均值掩盖严重的双重危机
- HHI贸易集中度评分 --联合国商品贸易委员会的双边流量被汇总以计算赫芬达尔-赫希曼指数;份额超过30%的合作伙伴被明确标记为单点传染渠道
- 历史外汇波动模式匹配 --货币危机模型根据汇率历史构建波动时间序列,计算超过3%和10%的波动,以识别不稳定的货币制度
- 并行8源数据采集 --所有actor调用通过以下方式并发运行
Promise.all,将总延迟减少到最慢的单个源,而不是按顺序对所有源求和 - 优美的部分结果 --失败或空的数据源返回空数组,而不是使评分管道崩溃;数据缺失得分保守(零分),而不是夸大风险
- 支出限额执行 --每次工具调用检查
Actor.charge()在启动数据收集之前,如果达到预算上限,则返回结构化错误对象,而不是部分完成 - 7种不同的MCP工具 --每个风险维度都可以独立调用;
regional_contagion_scenario运行所有8个源,并在一次调用中以相同的价格返回所有四个维度加上综合判断 - 校准信号文本 --每个评分模型都会发出人类可读的信号(例如,“贸易HHI 3200——集中贸易依赖性”),这些信号被捆绑在
allSignals供分析师审查 - MCP待机模式 --在Apify的基础设施上持续运行,消除了同一会话中连续国家查询之间的冷启动延迟
主权债务传染分析用例
主权信用研究
资产管理公司的固定收益分析师和信贷团队使用此服务器生成量化的压力评分,作为对传统评级机构输出的补充。由于该服务器近乎实时地从IMF和FRED获取领先指标,因此可以在正式评级行动前几个月标记财政恶化。每周对你的主权债券投资组合进行一次压力扫描,在信号变得沮丧之前发现“观察”或“提升”信号。
新兴市场货币风险管理
外汇交易员和新兴市场基金经理使用 currency_crisis_probability 持续监控货币。该工具将当前的折旧信号与与已知危机前兆相匹配的历史波动模式相结合。当得分超过50且储备覆盖率低于3个月的进口时,产出明确建议外汇套期保值或避免本币债券——这是直接从数据中得出的可操作指导。
贸易渠道传染映射
使用跨境风险敞口的投资组合经理 contagion_network_analysis 了解一个国家的主权危机将如何传递给其贸易伙伴。HHI集中度得分确定了哪些国家最容易受到单一合作伙伴违约级联的影响,这与集中在土耳其、阿根廷或撒哈拉以南边境市场的新兴市场投资组合尤其相关。
发展融资贷款评估
多边开发银行和双边贷款人使用 fiscal_headroom_analysis 评估一个国家在跨过压力阈值之前可以吸收多少额外的主权债务。该工具利用国际货币基金组织的债务可持续性指标和经合组织的财政统计数据,得出具有特定赤字和债务信号的净空得分。
灾害财政复合风险分析
气候融资团队和灾难债券发行人使用 disaster_fiscal_vulnerability 确定自然灾害暴露加剧财政疲软的国家。GDACS警报频率高、财政储备有限的小岛屿发展中国家面临着复合风险,单一灾难事件可能引发债务重组。该工具根据实时GDACS数据对这种相互作用进行了明确评分。
区域传染情景规划
首席投资官和宏观策略师使用 regional_contagion_scenario 进行全面的区域压力测试。提供国家和可选区域背景;服务器查询所有8个来源,并返回一份包含所有四个风险维度、所有信号和投资组合建议的完整报告。用于季度情景规划或应对特定宏观事件。
如何使用主权债务传染分析
- 将MCP服务器连接到您的AI客户端 --添加服务器URL
https://sovereign-debt-contagion-mcp.apify.actor/mcp到您的Claude Desktop、Cursor或Windsurf配置,并在中使用Apify API令牌Authorization: Bearerheader(见下面的连接示例)。 - 用自然语言提问 --在您的人工智能客户端中键入“评估阿根廷的主权压力”或“对土耳其进行全面传染情景”。客户端会自动调用相应的工具。
- 服务器最多并行运行8个数据源 --根据工具的不同,它可以同时查询国际货币基金组织、世界银行、联合国商品贸易组织、FRED、汇率信息和GDACS。预计15-60秒,具体取决于该国的数据可用性。
- 审查结构化输出 --您的AI客户端会显示一个JSON结果,其中包含数字分数(0-100)、标记的判断、校准的信号以及每个风险维度的具体投资组合建议。
MCP工具
| 工具 | 价格 | 数据来源 | 描述 |
|---|---|---|---|
sovereign_stress_assessment | 0.045美元 | 国际货币基金组织、世界银行、FRED | 主权压力指数(0-100):债务与国内生产总值、通货膨胀、治理得分、利率环境 |
contagion_network_analysis | 0.045美元 | 联合国商品贸易组织、经合组织 | 贸易渠道传染传播、HHI集中、跨境金融一体化 |
currency_crisis_probability | 0.045美元 | 汇率跟踪器、汇率历史、国际货币基金组织 | 当前贬值、历史外汇波动、储备充足率导致的货币危机概率 |
fiscal_headroom_analysis | 0.045美元 | 国际货币基金组织、经合组织、FRED | 债务能力、赤字趋势、利息负担和剩余政策空间 |
disaster_fiscal_vulnerability | 0.045美元 | GDACS、IMF、世界银行 | 自然灾害风险与财政缓冲强度;复合漏洞评分 |
compare_sovereign_risks | 0.045美元 | 国际货币基金组织、联合国商品贸易组织、汇率追踪机构、GDACS | 综合评分、按维度标签和相对判断的多国比较 |
regional_contagion_scenario | $0.045 | 全部8个来源 | 完整的主权风险报告:INVESTMENT_GRADE至DEFAULT_risk,包括所有四个维度和建议 |
刀具参数
| 参数 | 工具 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
country | 所有工具 | 字符串 | 是 | 国家名称或ISO代码(例如,“土耳其”、“TUR”、“阿根廷”) |
period | sovereign_stress_assessment | string | 否 | 分析期(例如,“2024”、“过去5年”) |
currency | currency_crisis_probability | string | 否 | 显式货币对覆盖(例如,“USD/TRY”) |
benchmark | compare_sovereign_risks | string | 否 | 用于相对比较的基准国家(例如“巴西”) |
region | regional_contagion_scenario | string | 否 | 贸易网络查询的区域上下文(例如“拉丁美洲”) |
输入提示
- 使用完整的国家名称以获得最佳效果 --在大多数来源中,“阿根廷”的IMF和世界银行数据覆盖率高于“AR”。
- 提供货币对以进行精确的外汇分析 --使用时
currency_crisis_probability,指定currency: "USD/TRY"比仅使用国家名称更准确地定位汇率信息,特别是对于具有非标准标识符的新兴市场货币。 - 使用
regional_contagion_scenario进行全面评估 --以与单个工具相同的0.045美元价格,它运行所有8个来源,并在一次调用中返回所有四个评分维度。 - 传递传染建模的区域参数 --For
regional_contagion_scenario,设置region: "Sub-Saharan Africa"一起country: "Kenya"扩大了联合国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 | 数字(0-100) | 综合信用质量评分;较高=风险较低(与原始风险评分相反) |
verdict | string | 投资等级/投机/高收益/亏损/违约 |
sovereignStress.score | 数字(0-100) | 主权压力指数;更高=财政压力更大 |
sovereignStress.debtIndicators | 数字 | 根据国际货币基金组织数据发出的债务困扰信号计数 |
sovereignStress.inflationSignals | 数字 | 发出的通胀压力信号计数 |
sovereignStress.stressLevel | string | 稳定/观察/升高/沮丧/危机 |
sovereignStress.signals | string\[\] | 来自应力模型的人类可读信号描述 |
contagion.score | 数字(0-100) | 传染网络风险评分;更高=传播风险更大 |
contagion.tradeLinks | number | COMTRADE数据中确定的不同贸易伙伴 |
contagion.concentratedPartners | 数量 | 标记为高于HHI浓度阈值的合作伙伴 |
contagion.contagionLevel | string | 隔离/低/中等/高/系统 |
currencyCrisis.score | 数字(0-100) | 货币危机概率得分 |
currencyCrisis.volatility | number | 波动性外汇超过3%阈值的计数 |
currencyCrisis.depreciationSignals | number | 来自实时费率数据的当前折旧信号计数 |
currencyCrisis.crisisLevel | 管柱 | 稳定/轻度_压力/中度_压力/严重/危机 |
disasterFiscal.score | 数字(0-100) | 灾害财政复合脆弱性得分 |
disasterFiscal.disasterExposure | number | 返回该国的GDACS警报总数 |
disasterFiscal.fiscalBufferWeakness | number | 来自IMF数据的财政缓冲疲软信号计数 |
disasterFiscal.vulnerabilityLevel | string | 弹性/低/中等/脆弱/危险_暴露 |
allSignals | string\[\] | 来自所有四个模型的所有信号组合成一个阵列 |
recommendations | string\[\] | 根据分数得出的可操作的投资组合建议 |
进行主权债务传染分析需要多少成本?
此MCP服务器使用 按活动付费定价 --你付钱 每次工具调用0.045美元。包括平台计算成本。所有7个工具的价格相同,包括 regional_contagion_scenario 它在一次调用中运行所有8个底层数据源。
| 场景 | 工具调用 | 每次调用成本 | 总成本 |
|---|---|---|---|
| 快速国家检查 | 1 | 0.045 | 0.045美元 |
| 压力评估+货币对 | 2 | $0.045 | $0.090 |
| 完整的四维国家评估 | 4 | 0.045 | 0.180美元 |
| 每月监测扫描,10个国家 | 10 | 0.045 | 0.45美元 |
| 每周投资组合扫描,50个国家 | 50 | 0.045 | 2.25美元 |
您可以设置 最高支出限额 每次运行以控制成本。当达到预算时,服务器会停止,并返回结构化错误,而不是部分结果。
将其与彭博终端主权风险模块的24000美元/年或穆迪CreditView的15000-50000美元/年进行比较。使用此服务器的大多数分析师工作流的成本低于每月5美元,没有订阅承诺。
如何连接此MCP服务器
克劳德桌面版
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"sovereign-debt-contagion": {
"url": "https://sovereign-debt-contagion-mcp.apify.actor/mcp",
"headers": {
"Authorization": "Bearer YOUR_APIFY_TOKEN"
}
}
}
}光标/风帆/克莱恩
在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.每个调用都针对一个特定的Apify参与者(按内部ID):国际货币基金组织经济数据(gc3sx9TauOIK8qzuC),世界银行指标(CbOYiMOHucFZsYgho),经合组织统计(e0JbdfmO4cqfO05tE),联合国贸易(NJCh32GyIiVnSTzqO),汇率跟踪器(wsC4YmRmJJl5RAVVY),汇率历史(gh3BeaT9qw9MKrdPP)FRED经济数据(gz0VOFSLZkFwhqOS8),以及GDACS灾难警报(pmweI2ngI1bo4l6KD).每个底层参与者都以512MB内存和120秒超时运行。失败的参与者返回空数组而不是抛出,确保始终从评分管道返回部分结果。
评分:四个具有校准阈值的独立模型
主权压力指数 (最高100)结合了四个子分数:国际货币基金组织债务指标(最高35分——债务/GDP高于80%得3分,高于100%得5分;赤字低于-5%得3分),世界银行治理百分位数低于30分(4倍乘数时最高25分),FRED财资10年期收益率高于4%或利差高于2%(最高20分),国际货币基金组通胀信号高于5%(最高20点)。五个严重性等级分别对应0、20、40、60和80分阈值。
传染网络 (最高100)使用联合国商品贸易组织双边流量计算合作伙伴数量,作为链接密度得分(最高35分)、合作伙伴贸易价值份额的赫芬达尔-赫希曼指数(最高30分;HHI高于2500,顶级合作伙伴份额高于30%,均发出明确信号)、经合组织跨境金融流量信号(最高20分),以及当两个合作伙伴数量超过15且HHI同时超过1500时的15分网络放大奖金。
货币危机概率 (最高100)从汇率跟踪器中获得当前贬值的分数(最高30分——5%、10%和20%以上的变化会获得递增的分数),从计算3%和10%以上波动的价格序列中获得历史波动性的分数(最多30分),以及国际货币基金组织储备覆盖率和经常账户数据(最高25分——3个月以下的储备覆盖率会获得3分;低于-5%的经常账户会获得2分)。当折旧和波动性与低准备金率同时发生时,15点加速奖金就会发放。
灾害财政脆弱性 (最高100)计算GDACS警报,每个红色/橙色/严重分类有5分奖励(最高35分),国际货币基金组织债务和储备信号导致的财政缓冲疲软(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=沮丧,低于15=违约。在以下情况下,危机覆盖规则绕过了综合平均值 sovereignStress.stressLevel === 'CRISIS' 和 currencyCrisis.crisisLevel === 'CRISIS' 同时,无论加权分数如何,都强制执行DEFAULT_RISK。
获得最佳效果的提示
- 从开始
regional_contagion_scenario对于陌生的国家。 与任何单一工具的价格相同,它在一次通话中返回所有四个评分维度以及综合判断、信号和建议,在决定哪些维度需要更深入的调查之前,为您提供全面的情况。
- 将分数解释为相对的,而不是绝对概率。 巴西的主权压力得分为60,这意味着在相同的方法和数据年份下,巴西的压力比得分为40的国家更大。使用标有标签的层级(观察、上升、下降)进行沟通;使用原始分数进行投资组合排名。
- 使用
contagion_network_analysis在确定一个有压力的国家之后。 如果sovereign_stress_assessment返回一个国家的困境或危机,运行contagion_network_analysis在其前三大贸易伙伴中,绘制压力下一步将流向何处。这就是传染传播的实际运作方式——单一国家的压力首先通过贸易渠道传播。
- 为新兴市场货币提供明确的货币对。 外汇数据源对“美元/土耳其里拉”的反应比对“土耳其”的反应更准确
currency_crisis_probability工具。对于汇率受到管理的货币,该模型可能低估了真实的压力——在解释结果时请注意这一点。
- 每月进行一次投资组合监控。 每次通话0.045美元,每月压力席卷20个主权国家
regional_contagion_scenario每个国家花费0.90美元。通过Apify Scheduler安排此操作,并通过webhook将结果路由到Google Sheet或Slack频道。
- 在贷款决策中,将财政空间与灾难脆弱性相结合。
fiscal_headroom_analysis具体查询国际货币基金组织债务收入和经合组织预算系列。对于发展融资评估,请同时运行disaster_fiscal_vulnerability在一个工作流程中同时捕捉结构性债务能力和冲击驱动风险。
- 在处理输出时考虑数据新鲜度。 国际货币基金组织《世界经济展望》每半年更新一次(4月和10月);世界银行年度指标每年更新一次;FRED在1个工作日内更新;汇率数据接近实时;GDACS警报是实时的。主权压力评分反映了最近公布的官方数据,这些数据可能会使迅速恶化的情况滞后6-12个月。
与其他Apify演员组合
| 演员 | 如何组合 |
|---|---|
| FRED经济数据 | 拉动额外的美国宏观系列——信贷息差、收益率曲线形状——为 sovereign_stress_assessment 再融资风险信号 |
| 国际货币基金组织经济数据 | 直接查询特定的IMF WEO系列,以补充或回填覆盖率较低的国家的数据 fiscal_headroom_analysis |
| 世界银行指标 | 为压力和灾难模型使用的默认世界银行查询中未完全涵盖的前沿市场提取细粒度治理和贫困时间序列 |
| 联合国商品贸易搜索 | 提取商品层面的贸易流量,以确定除总贸易价值之外的特定商品渠道传染途径 contagion_network_analysis |
| 汇率历史记录 | 为感兴趣的货币设定5-10年的历史窗口,以建立比默认回溯更丰富的波动基线 currency_crisis_probability |
| GDACS灾难警报 | 实时监控GDACS并触发新的 disaster_fiscal_vulnerability 每当您的投资组合中的某个国家发布新的红色严重性事件时,通过webhook调用 |
| 经合组织统计数据搜索 | 查询特定的经合组织财政或金融系列,以扩展所使用的跨境金融信号集 contagion_network_analysis 具有精细的资本账户数据 |
局限性
- 数据新鲜度取决于来源。 国际货币基金组织《世界经济展望》和世界银行年度系列每季度至每年更新一次。分数反映了最近公布的官方数据,对于恶性通货膨胀事件或严重货币危机等快速变化的情况,这些数据可能会落后于当前经济状况6-12个月。
- 前沿市场的覆盖缺口。 小型或最近创建的主权实体,其国际货币基金组织第四条咨询历史有限,COMTRADE报告单薄,或没有经合组织伙伴关系状态,返回的指标较少。数据缺失得分保守(加零分),而不是夸大风险——这可能低估了数据稀疏国家的真实风险。
- 基于信号的阈值,而不是回归校准模型。 阈值(例如,债务/GDP高于80%,顶级合作伙伴份额高于30%)是参考历史危机前兆设定的,但尚未作为预测模型进行正式的回溯测试。将输出视为人类判断的结构化信号,而不是具有特定置信区间的定量默认概率。
- 没有实时市场定价或新闻情绪。 该服务器不包含主权信用违约掉期利差、债券收益率或新闻情绪。这些领先指标在官方统计数据反映之前可能会发生重大变化,并且不会被四种评分模型中的任何一种所捕捉。
- 货币数据依赖于外汇对匹配。 对于具有非标准货币对表示法、有限历史覆盖范围或管理汇率制度的货币,货币危机模型可能低估了真实压力。提供明确的配对(例如“USD/ARS”)可以改善数据定位。
- 贸易网络仅捕获报告的流量。 非正式贸易、改道和报告不足的双边流动——在受制裁经济体中很常见——将低估COMTRADE数据的真实传染风险。HHI正确地识别了结构性集中,但可能无法反映最近未记录的贸易多样化。
- 不能代替法律或投资建议。 产出是从多边机构公布的公开数据中得出的分析信号。它们不构成信用评级、投资建议或监管合规评估。
集成
- Apify API --从Python、JavaScript或任何HTTP客户端以编程方式触发主权风险评估;从数据集端点检索结构化JSON
- 网络钩子 --当压力分数超过受监控国家集的预定义阈值时,向Slack或内部系统发出火灾警报
- 扎皮尔 --将主权风险报告发送到谷歌表格、Airtable或Notion,以便无需代码即可实时跟踪投资组合仪表板
- 制造 --构建自动化工作流程,每月进行国家/地区扫描,并向分析师收件箱提供结构化摘要
- 谷歌表格 --将主权宇宙的综合得分和每个维度的判断推送到实时电子表格中,以进行持续监控
- LangChain/LlamaIdex --在RAG管道或执行宏观研究和报告生成的AI代理中使用主权风险输出作为结构化上下文
故障排除
- 尽管国家压力明显,但得分很低或为零 --最常见的原因是官方数据覆盖率低。国际货币基金组织、世界银行和COMTRADE对非常小、受制裁或未报告经济体的数据有限。除了完整的国家名称外,还可以尝试使用ISO国家代码,并验证国际货币基金组织是否发布了该国的第四条咨询数据。缺失数据得分保守地为零,而不是提高风险得分。
regional_contagion_scenario花费的时间比预期的要长 --该工具并行启动所有8个底层参与者,每个参与者超时120秒。总延迟等于最慢的单一来源,对于拥有大型COMTRADE数据集的国家或GDACS负载时,延迟可达45-90秒。这是意料之中的。为了获得更快的结果,请使用单独的工具,如sovereign_stress_assessment或contagion_network_analysis,使用更少的资源。
- 返回支出限额错误,而不是结果 --The
Actor.charge()在数据收集开始之前呼叫火灾。如果您的Apify帐户支出限额或每次运行预算已经达到,该工具将返回{"error": true, "message": "Spending limit reached for ..."}而不是尝试查询。在Apify控制台设置中增加跑步预算,然后重试。
- 尽管已知存在货币压力,但货币危机得分较低 --该模型依赖于汇率馈送覆盖率和国际货币基金组织储备/经常账户统计数据。如果目标货币的馈送覆盖范围有限。,
"currency": "USD/NGN").对于官方汇率人为挂钩的管理汇率,该模型将低估真实压力——在解释结果时请注意这一警告。
- 对于一个有许多贸易伙伴的国家来说,传染性得分很低 --HHI奖励专注,而不是原始合作伙伴数量。一个拥有40个均匀分布的贸易伙伴的国家具有较低的HHI和较低的集中度得分,这是正确的解释:多样化的贸易敞口真正降低了单渠道传染风险。如果你怀疑间接传染,跑
contagion_network_analysis该国最大的个人合作伙伴。
责任的使用
- 根据允许研究和商业使用的开放数据政策,该MCP服务器提供的所有数据都可以从多边国际组织(国际货币基金组织、世界银行、经合组织、联合国商品贸易组织、FRED)公开获取。
- 从该服务器得出的国家风险评分是分析信号,在没有适当的专业监督的情况下,不应作为信用评级、投资建议或监管评估发布。
- 不要使用主权风险输出来歧视个人、组织或社区,超出其金融和宏观经济分析的预期目的。
- 汇率和宏观经济数据仅供参考,不构成财务建议。
- 有关公共数据使用合法性的指导,请参阅 Apify指南.
常见问题解答
主权债务传染分析与信用评级机构有何不同? 评级机构发布的顺序评级不经常更新,通常在恶化后已经是众所周知的了。该服务器根据实时和最近更新的公共数据生成量化的0-100分,从而能够持续监控和早期检测恶化的指标。它是对正式信用分析的补充,而不是替代。
在一次会议中,我可以用主权债务传染工具分析多少个国家? 每届会议对国家没有硬性限制。每次工具调用的费用为0.045美元,因此使用 regional_contagion_scenario (一次通话中的所有四个维度)费用为0.90美元。使用Apify API以编程方式批处理扫描,或通过Apify调度程序安排定期扫描。
主权债务传染分析是否涵盖前沿市场债务? 覆盖范围取决于国际货币基金组织、世界银行和联合国商品贸易数据的可用性。大多数拥有国际交易主权债券的国家都有足够的国际货币基金组织和世界银行保险。具有有限的第四条历史或COMTRADE报告差距的真正前沿市场会产生较低的置信度得分,服务器通过对缺失数据返回较低而非夸大的得分来处理。
传染网络HHI评分有多准确? HHI直接根据联合国商品贸易委员会报告的双边贸易流量计算,该流量是贸易统计的权威国际来源。准确性受到COMTRADE报告滞后(通常为12-18个月)和非正式或受制裁贸易报告不足的限制。该模型正确地识别了结构性集中,但可能无法捕捉到最近的贸易多样化。
用于主权压力评分的宏观经济数据有多新? 汇率数据近乎实时。FRED在1个工作日内更新。国际货币基金组织《世界经济展望》每半年更新一次(4月和10月)。世界银行年度指标每年更新一次。GDACS灾难警报已启动。压力评分反映了查询时每个来源的最新可用数据。
我可以在货币交易决策中使用主权债务传染分析吗? 这 currency_crisis_probability 该工具提供外汇波动模式和储备数据的分析信号,而不是交易信号系统。它没有考虑市场微观结构、定位数据或短期催化剂。将其用于中期风险评估和投资组合定位,而不是用于执行时机。
使用国际货币基金组织和世界银行的数据进行商业主权分析合法吗? 对。国际货币基金组织、世界银行、经合组织、联合国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频道、谷歌表格或内部警报系统。
灾害财政脆弱性如何捕捉与气候相关的主权风险? 这 disaster_fiscal_vulnerability 该工具使用实时GDACS警报(洪水、飓风、干旱、地震)以及国际货币基金组织财政缓冲数据和世界银行贫困指标。GDACS警报频率高、严重程度为红色/橙色、财政储备薄弱和贫困率高的国家得分为脆弱或严重暴露。这对于小岛屿发展中国家和低收入国家尤其重要,因为一次重大气候事件就可能引发债务重组。
帮助我们改进
如果您遇到问题,可以通过在Apify帐户中启用运行共享来帮助我们更快地进行调试:
- 首选 帐户设置>隐私
- 启用 与公共Actor创建者共享跑步记录
这使我们可以在出现问题时查看您的跑步详细信息,以便我们更快地解决问题。您的数据仅对演员开发人员可见,不公开。
支持
发现错误或有功能请求?在中打开一个问题 问题选项卡 在这个演员的页面上。对于自定义主权风险工作流程、区域传染情景建模或企业集成,请通过Apify平台联系。
