SuperAPI AI 工具集

datagouv-apis

数据与分析

查看项目

更新于 10-15 20:34

技能介绍

用途:面向 data.gouv.fr 开放数据平台的 API 使用参考,覆盖目录检索、元数据读取、资源下载、CSV 行级查询与外部数据服务发现。

主要能力:主 API(https://www.data.gouv.fr/api/1/)提供数据集、资源、组织、用户、复用、讨论、通知、站点统计等路径,如 GET /datasets/、GET /datasets/{id}/、GET /datasets/{id}/resources/、GET /datasets/r/{rid} 下载资源;Metrics API(https://metric-api.data.gouv.fr)按模型返回使用统计,如 GET /api/{model}/data/ 与 /data/csv/;Tabular API(https://tabular-api.data.gouv.fr)对平台托管的 CSV 资源做筛选、排序、分页与聚合,流程为 GET /api/resources/{rid}/、/profile/、/swagger/、/data/,page_size 最大 50,聚合需先查 /api/aggregation-exceptions/。dataservices 表示平台登记的外部 HTTP API,先 GET /dataservices/ 或 MCP search_dataservices 检索,再取 machine_documentation_url 与 base_api_url 调用上游。

使用方式:优先使用 MCP(https://mcp.data.gouv.fr/mcp)做交互式探索,脚本场景用 HTTP 端点。读取公开数据无需鉴权;写入需 X-API-KEY,且仅在用户明确要求时使用。列表响应含 data、page、page_size、total、next_page,应跟随 next_page 翻页;注意 X-RateLimit-* 限流头。Tabular 的 {rid} 需从主 API 资源中取 UUID。

限制:不要臆造数据集或资源 ID;演示环境 https://demo.data.gouv.fr/api/1/ 仅用于测试;各 dataservice 的鉴权与配额规则不同,以官方 OpenAPI 为准;本技能不构成法律意见。Python 客户端见 https://github.com/etalab/datagouv-client-python。