Our World in Data
Our World in Data 是一个以图表形式呈现全球性问题研究和数据的出版项目，数据来自许多原始提供方。通过 ScholarMuse，agent 可以用 find_series 搜索这些图表，再用 get_series 下载某张图表背后某个国家、全球或欧盟的数据，同时拿到原始来源的引用信息。
对应的 ScholarMuse 工具：find_series、get_series。每次成功调用都会扣积分。
可以这样问你的 agent
你的 agent 会拿到什么
每条记录都带有 id、source、title、url、license、attribution 和 retrievedAt。下面是来自 Our World in Data 的数据字段。
find_series
候选结果是 Our World in Data 自身搜索返回的图表，所以这一步还不知道频率和单位。
- seriesId
- 如 owid:life-expectancy?country=JPN
- title
- 图表标题，如有变体名也会带上
- geography
- 查询中提到的国家（如有）
- description
- 图表副标题，前 400 个字符
- updated
- 图表最近更新的日期
get_series
只有图表包含多个数据列时才返回 otherColumns；在 seriesId 后加 &column=<名称> 可以换一列。
- seriesId
- 图表 slug，带国家，必要时带列名
- title
- 图表标题，多列时加上列标题
- units
- 所选数据列的单位
- frequency
- 年度或日度
- geography
- Our World in Data 使用的实体名称
- description
- 数据列的简短说明
- citation
- 底层数据来源的引用
- lastUpdated
- 该列数据最近更新的时间
- otherColumns
- 图表中其他数据列，最多 10 个
- count
- 返回的观测值个数
- observations
- 日期与数值组成的列表
覆盖范围
- 发布在 ourworldindata.org/grapher 下的图表。序列编号就是图表的 slug，例如 owid:life-expectancy。
- 地理范围是按 ISO 代码指定的单个国家、全球或 EU27。不指定国家时返回全球序列。
- 大多数图表是年度数据；带有 day 或 date 列的图表会作为日度序列返回。
限制
- Our World in Data 转载了其他机构的数据。CC BY 许可只适用于它自己的成果；请引用 citation 字段里的来源，并查看该来源的使用条款。
- 每次调用只取一个国家、一个数据列。图表有多列时默认取第一列，除非你指定其他列。
- 只搜索图表，文章、专题页和 explorer 视图会被过滤掉。
- 除全球和 EU27 外，各大洲和收入分组没有做代码映射。每次下载最长可等 45 秒。
ScholarMuse 怎么访问 Our World in Data
连接器直接调用 ourworldindata.org，不发送任何 key。find_series 使用该站的搜索 API，并限定为图表；get_series 从 /grapher/<slug> 下载图表的 .metadata.json 和 .csv 文件，只保留所请求国家的行。
图表数据和元数据最多缓存 1 天，搜索结果缓存 12 小时。
API key：上游 API 不用 key 也能调用，你不用申请。
许可与署名
许可：CC-BY-4.0 (OWID’s own work; third-party data keeps its original licence)
Our World in Data (ourworldindata.org), CC BY. Cite the underlying sources listed in data.citation.
来自 Our World in Data 的记录都带这段许可和署名。 在论文里引用时，请按 Our World in Data 自己的引用要求来写。
