IMF
宏观统计IMF DataMapper API v1IMF
国际货币基金组织（IMF）通过 IMF DataMapper 发布主要宏观经济指标，数据来自《世界经济展望》、《财政监测报告》等 IMF 数据集。通过 ScholarMuse，agent 可以用 find_series 搜索 DataMapper 的指标清单，再用 get_series 取某个国家的一项指标，其中包括 IMF 标为估计或预测的年份。
对应的 ScholarMuse 工具：find_series、get_series。每次成功调用都会扣积分。
可以这样问你的 agent
IMF 对印度未来三年的实际 GDP 增速预测是多少？
取 2000 年以来意大利一般政府总债务占 GDP 的比重。
找 IMF 的通胀指标，列出最近十年每年的全球数值。
你的 agent 会拿到什么
每条记录都带有 id、source、title、url、license、attribution 和 retrievedAt。下面是来自 IMF 的数据字段。
find_series
匹配依据是 DataMapper 的指标名称。查询里写的国家会以 ?country=ISO3 的形式加到 seriesId 里。
- seriesId
- 如 imf:NGDP_RPCH?country=IND
- title
- 指标名称及单位
- frequency
- 该来源固定为 Annual
- units
- IMF 给出的单位
- geography
- 查询中提到的国家（如有）
- dataset
- 指标所属的 IMF 数据集
- description
- IMF 的指标说明，前 400 个字符
get_series
- seriesId
- 带有已解析地区代码的指标编号
- title
- 指标名称
- units
- IMF 给出的单位
- frequency
- 年度
- geography
- 国家名称，或 World
- dataset
- 指标所属的 IMF 数据集
- projectionsFrom
- 从哪一年起视为估计或预测值
- start
- 返回的首个年份
- end
- 返回的最后年份
- count
- 返回的观测值个数
- observations
- 年份与数值组成的列表
覆盖范围
- IMF DataMapper 列出的指标，来自《世界经济展望》、《财政监测报告》等 IMF 数据集。
- 地理范围是按 ISO 代码指定的单个国家，或全球合计。序列为年度数据。
- 序列通常会延伸到当前年份之后，因为 IMF 会把估计值和预测值与历史数据一起发布。
限制
- 只有年度数据。IMF 的月度和季度数据库不在这个连接器的范围内。
- 当前年份及以后的数值和历史数据一样以普通数字返回。请用 projectionsFrom 字段或设置 end 把它们和历史数据分开。
- 每次调用只取一项指标、一个地区。不指定国家时返回全球合计。除全球外的区域分组需要使用 DataMapper 自己的地区代码。
- 搜索只匹配英文指标名称，find_series 每次最多返回 8 条 IMF 候选。
ScholarMuse 怎么访问 IMF
连接器直接调用 IMF DataMapper API v1，不发送任何 key。它先下载指标清单，用你的查询匹配指标名称，再请求 /{indicator}/{area} 取数值。
数值最多缓存 1 天，指标清单缓存 7 天，IMF 的新发布可能要这么久才会出现。
API key：上游 API 不用 key 也能调用，你不用申请。
许可与署名
许可：IMF Data Terms and Conditions (free reuse with attribution)
Source: International Monetary Fund, IMF DataMapper (imf.org/external/datamapper).
来自 IMF 的记录都带这段许可和署名。 在论文里引用时，请按 IMF 自己的引用要求来写。
用到 IMF 的功能
常见问题
ScholarMuse 不是 IMF 的官方产品。它是一个面向学术数据的 MCP server，其中的 find_series、get_series 工具会查询 IMF。agent 连上 ScholarMuse 后就能用 IMF，不用再单独装一个 server。
不需要。IMF 的 API 不用 key 也能调用，ScholarMuse 也不会向你要 key。登录一次 ScholarMuse，agent 就能调用工具。
连接器直接调用 IMF DataMapper API v1，不发送任何 key。它先下载指标清单，用你的查询匹配指标名称，再请求 /{indicator}/{area} 取数值。数值最多缓存 1 天，指标清单缓存 7 天，IMF 的新发布可能要这么久才会出现。
许可：IMF Data Terms and Conditions (free reuse with attribution)。署名：Source: International Monetary Fund, IMF DataMapper (imf.org/external/datamapper). 来自 IMF 的记录都带这段许可和署名。
需要。每次成功调用 find_series、get_series 都会扣积分，调用失败不扣。当前价格：经济与社会统计，1 积分 / 次。