免费了解积分 →
OE
政策统计OECD SDMX REST API

OECD

经合组织(OECD)通过 OECD Data Explorer 发布成员国和伙伴国的统计数据。每个数据集都是一个多维数据立方体,维度包括国家、度量、单位、频率等。通过 ScholarMuse,agent 可以用 find_series 搜索数据集名称,再用 get_series 从数据集中取出一条序列,没有指定的维度会默认取合计项。

对应的 ScholarMuse 工具:find_series、get_series。每次成功调用都会扣积分。

可以这样问你的 agent

找 OECD 的月度失业率数据集,取韩国的那条序列。
OECD 有哪些关于卫生支出的数据集?第一个数据集有哪些维度?
从 OECD 取墨西哥的季度 GDP,并告诉我用的是哪种单位和调整方式。

你的 agent 会拿到什么

每条记录都带有 id、source、title、url、license、attribution 和 retrievedAt。下面是来自 OECD 的数据字段。

find_series

每条候选是一整个数据集,而不是单条序列,所以这一步还不知道频率和单位。

seriesId
oecd:<agency>,<dataflow>,可带 ?REF_AREA=ISO3
title
数据集名称
geography
查询中提到的国家(如有)
note
提示该数据集包含多个维度

get_series

只有在某个维度未指定且存在多个代码时,才会返回 otherOptions。

seriesId
写明全部维度的数据集编号
title
数据集名称加度量名称
units
计量单位及数量级
frequency
所选序列的频率
geography
参考地区名称
dimensions
每个维度实际使用的代码和名称
otherOptions
每个未指定维度最多 25 个可选代码
start
返回的首个时期
end
返回的最后时期
count
返回的观测值个数
observations
时期与数值组成的列表

覆盖范围

  • OECD 各部门在 OECD Data Explorer 中发布的数据集,覆盖 OECD 成员国和伙伴国。
  • 序列编号由部门和 dataflow 组成,例如 oecd:OECD.SDD.TPS,DSD_LFS@DF_IALFS_UNE_M?REF_AREA=USA,任何维度都可以用 ?DIMENSION=CODE 固定。
  • 频率取决于数据集。未指定时优先取月度,其次季度,再次年度。

限制

  • 搜索只匹配数据集名称,不能在数据集内部搜索某个度量或指标。
  • 未指定的维度会用合计项或第一个可用代码填充,所以一定要看 dimensions 和 otherOptions,确认拿到的是什么。
  • 速度可能较慢:请求之间间隔 1.5 秒,每个数据请求最长可等 45 秒,而每次调用要发两个。
  • 每次调用只取一条序列。查询中的国家只对单个国家自动填入;OECD 的分组合计需要自己指定 REF_AREA 代码。

ScholarMuse 怎么访问 OECD

连接器直接调用 sdmx.oecd.org 上公开的 OECD SDMX REST API,不发送任何 key。它先列出全部 OECD dataflow 用于按名称搜索;每次 get_series 会发两个数据请求:一个取所有匹配序列的最新观测值以便选出一条,另一个取这条序列的完整历史。

数据响应最多缓存 12 小时,数据集清单缓存 7 天。

API key:上游 API 不用 key 也能调用,你不用申请。

许可与署名

许可:CC-BY-4.0

Source: OECD Data Explorer (data-explorer.oecd.org), CC BY 4.0.

来自 OECD 的记录都带这段许可和署名。 在论文里引用时,请按 OECD 自己的引用要求来写。

常见问题

ScholarMuse 不是 OECD 的官方产品。它是一个面向学术数据的 MCP server,其中的 find_series、get_series 工具会查询 OECD。agent 连上 ScholarMuse 后就能用 OECD,不用再单独装一个 server。

不需要。OECD 的 API 不用 key 也能调用,ScholarMuse 也不会向你要 key。登录一次 ScholarMuse,agent 就能调用工具。

连接器直接调用 sdmx.oecd.org 上公开的 OECD SDMX REST API,不发送任何 key。它先列出全部 OECD dataflow 用于按名称搜索;每次 get_series 会发两个数据请求:一个取所有匹配序列的最新观测值以便选出一条,另一个取这条序列的完整历史。数据响应最多缓存 12 小时,数据集清单缓存 7 天。

许可:CC-BY-4.0。署名:Source: OECD Data Explorer (data-explorer.oecd.org), CC BY 4.0. 来自 OECD 的记录都带这段许可和署名。

需要。每次成功调用 find_series、get_series 都会扣积分,调用失败不扣。当前价格:经济与社会统计,1 积分 / 次。