ES
欧盟统计Eurostat dissemination APIEurostat
Eurostat 是欧盟的统计局,以多维数据集的形式发布欧盟成员国及其他欧洲国家的统一口径统计数据。通过 ScholarMuse,agent 可以用 find_series 搜索 Eurostat 的数据目录,再用 get_series 按数据集代码(如 une_rt_m)取某个国家或欧盟整体的一条序列。
对应的 ScholarMuse 工具:find_series、get_series。每次成功调用都会扣积分。
可以这样问你的 agent
从 Eurostat 取 2019 年以来西班牙的月度失业率。
找 Eurostat 的房价指数数据集,取荷兰的季度序列。
2010 年以来波兰每年 1 月 1 日的人口是多少?
你的 agent 会拿到什么
每条记录都带有 id、source、title、url、license、attribution 和 retrievedAt。下面是来自 Eurostat 的数据字段。
find_series
每条候选是一整个数据集。查询里提到欧洲以外的国家时,会跳过 Eurostat。
- seriesId
- 如 eurostat:une_rt_m?geo=ES
- title
- 数据目录中的数据集标题
- frequency
- 根据数据集最新时期的格式推断
- geography
- 查询中提到的国家(如有)
- coverageStart
- 数据集的起始时期
- coverageEnd
- 数据集的最新时期
- note
- 提示该数据集包含多个维度
get_series
只有在某个维度未指定且存在多个代码时,才会返回 otherOptions。
- seriesId
- 写明全部维度的数据集代码
- title
- 数据集名称加所选的细分项
- units
- unit 维度的名称
- frequency
- freq 维度的名称
- geography
- geo 维度的名称
- dimensions
- 每个维度实际使用的代码和名称
- otherOptions
- 每个未指定维度最多 25 个可选代码
- lastUpdated
- Eurostat 最近更新该数据集的时间
- start
- 返回的首个时期
- end
- 返回的最后时期
- count
- 返回的观测值个数
- observations
- 时期与数值组成的列表
覆盖范围
- Eurostat 数据目录中类型为 dataset 或 table 的条目,按数据集代码取数,如 une_rt_m、nama_10_gdp、demo_pjan。
- find_series 的国家匹配覆盖 27 个欧盟成员国和另外 15 个欧洲国家(包括挪威、瑞士、英国、土耳其),以及 EU27 和欧元区合计。
- 频率随数据集而定:年度、半年度、季度、月度、周度和日度的时期格式都能读取。
限制
- 搜索只匹配英文数据集标题,不能在数据集内部搜索某一项指标。
- 未指定的维度会用合计项或第一个可用代码填充,地区在可用时默认取 EU27。请查看 dimensions 和 otherOptions,确认拿到的是什么。
- 数据集中不存在的筛选值会被拒绝,并返回可用代码列表。Eurostat 把希腊写作 EL、英国写作 UK,连接器会自动转换 ISO 代码。
- 每次调用只取一条序列,两个数据请求各自最长可等 45 秒。
ScholarMuse 怎么访问 Eurostat
连接器直接调用 Eurostat dissemination API,不发送任何 key。find_series 搜索的是从 catalogue 接口下载的英文数据目录;get_series 会调用两次 Statistics API(JSON-stat),一次只取最新时期以了解维度,一次取所选序列的完整历史。
数据响应最多缓存 6 小时,数据目录缓存 1 天。
API key:上游 API 不用 key 也能调用,你不用申请。
许可与署名
许可:Eurostat reuse policy (free reuse with attribution, CC BY 4.0 terms)
Source: Eurostat (ec.europa.eu/eurostat).
来自 Eurostat 的记录都带这段许可和署名。 在论文里引用时,请按 Eurostat 自己的引用要求来写。
用到 Eurostat 的功能
常见问题
ScholarMuse 不是 Eurostat 的官方产品。它是一个面向学术数据的 MCP server,其中的 find_series、get_series 工具会查询 Eurostat。agent 连上 ScholarMuse 后就能用 Eurostat,不用再单独装一个 server。
不需要。Eurostat 的 API 不用 key 也能调用,ScholarMuse 也不会向你要 key。登录一次 ScholarMuse,agent 就能调用工具。
连接器直接调用 Eurostat dissemination API,不发送任何 key。find_series 搜索的是从 catalogue 接口下载的英文数据目录;get_series 会调用两次 Statistics API(JSON-stat),一次只取最新时期以了解维度,一次取所选序列的完整历史。数据响应最多缓存 6 小时,数据目录缓存 1 天。
许可:Eurostat reuse policy (free reuse with attribution, CC BY 4.0 terms)。署名:Source: Eurostat (ec.europa.eu/eurostat). 来自 Eurostat 的记录都带这段许可和署名。
需要。每次成功调用 find_series、get_series 都会扣积分,调用失败不扣。当前价格:经济与社会统计,1 积分 / 次。
