用途:在已识别 Our World in Data 图表 URL(如 https://ourworldindata.org/grapher/literate-and-illiterate-world-population)后,获取该图表的数据。
主要能力:可取得两类文件:元数据 JSON,地址为 $CHARTURL.metadata.json;数据 CSV,地址为 $CHARTURL.csv。应先获取元数据再获取数据,以便了解上下文,并特别留意 descriptionKey 字段(由专家整理的重要信息或注意事项,可能适合呈现给用户)。
查询参数:两端点均支持筛选数据、减小响应体积。useColumnShortNames(使用不含空格的短列名,如 true)、csvType(用 filtered 以遵循国家/时间筛选)、country(按 ISO3 代码以 ~ 连接,如 USA~GBR~CHN)、time(时间范围如 2000..2020 或 2015)、tab(图表类型如 map、line、table)。推荐基础参数:?useColumnShortNames=true&csvType=filtered。示例:https://ourworldindata.org/grapher/life-expectancy.csv?useColumnShortNames=true&csvType=filtered&country=USA~GBR&time=2000..2020
Token 优化:可移除 Entity 列,仅保留 Code 列用于分析连接,如 curl -s "$URL" | cut -d',' -f2-;元数据可只提取 chart.title、chart.subtitle、chart.note、chart.citation、columns..titleShort、columns..descriptionShort、columns..unit、columns..shortUnit,跳过 titleLong、citationLong、fullMetadata、owidVariableId、lastUpdated、nextUpdate 等冗长字段。
CSV 结构:每行为某实体(通常国家或地区)在某时间点的观测。前两列为 Entity 与 Code,第三列为 Year(年度整数)或 Day(YYYY-MM-DD),其余为数据列。建议将 CSV 与元数据下载到文件后处理。
限制:资料未提供收费、价格与平台信息;元数据类型各字段的可选性以文中 TypeScript 定义为准。