OE
政策统计OECD SDMX REST APIOECD
经合组织(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 自己的引用要求来写。
用到 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 积分 / 次。
