SuperAPI AI 工具集

datasette

数据与分析

查看项目

更新于 10-16 09:49

技能介绍

用途:该技能用于访问 Our World In Data(OWID)内部 Datasette 实例,查询主 MySQL 数据库镜像(图表、变量、数据集、实体等元数据)以及分析数据存储(页面浏览与使用分析数据)。该实例通过 tailscale 在网络层控制访问,地址为 http://analytics/,无需 API key 或 token,但所有请求必须携带 User-Agent 头,否则返回 502,例如 curl 时使用 -H "User-Agent: Claude"。

主要能力:可用数据库有 private(主 MySQL 镜像,含 charts、variables、datasets、entities 等)与 analytics(页面浏览与使用分析)。URL 层级为 /(列数据库)、/{database}(表列表)、/{database}/{table}(浏览行)、/{database}/{table}/{pk}(按主键取行)、/{database}.json?sql=... 或 .csv?sql=...(执行 SQL)。名字含特殊字符时用波浪号编码而非百分号编码,空格编码为 +,其余用 ~ 加两位十六进制,如 . 为 ~2E、/ 为 ~2F。

使用方式:写查询前应先取元数据,不要猜测表名或列名。步骤一:curl -s -H "User-Agent: Claude" "http://analytics/private.json" 获取表、列、主键、行数与外键;步骤二:查询 sqlite_master 或 information_schema 获取列类型,例如 curl -s -G -H "User-Agent: Claude" "http://analytics/private.json" --data-urlencode "sql=SELECT sql FROM sqlite_master WHERE name = 'charts'" --data-urlencode "_shape=array";步骤三:curl -s -H "User-Agent: Claude" "http://analytics/-/metadata.json" 查看人类可读描述。运行 SQL 时用 .json 或 .csv 结尾,配合 -G 与 --data-urlencode 安全传参。JSON 的 _shape 可选 objects(默认推荐)、arrays、array、arrayfirst、object。也可不写 SQL 直接浏览表,并支持 ?column__operator=value 过滤,如 state__exact=CA、planet_int__gt=1、name__contains=energy、id__in=1,2,3。常用参数包括 sql、_shape、_size(max 为 1000 行)、_sort、_sort_desc、_col、_nocol、_where,CSV 还支持 _stream=on(最大 100MB)与 _header=off。

适用场景与限制:适合查询 OWID 图表、变量、数据集等目录元数据,或按主题、名称定位已发布图表、查看驱动图表的变量、统计图表类型,以及查询分析数据。限制:实例定期镜像,可能不反映生产库最新变更;仅允许 SELECT,INSERT、UPDATE、DELETE 与 PRAGMA 会被拒绝;大结果集需用 LIMIT/OFFSET 分页或 CSV 流式获取;grapher_configs 表中的图表配置 JSON 结构可参考 https://files.ourworldindata.org/schemas/grapher-schema.latest.json。