Agent skill · data analytics · aiskillstore
datadata-api
通过 CLI 查询 Datadata — 运行临时 SQL、检查数据源元数据、列表和描述表、下载 NDJSON/CSV 格式结果。当用户提到 Datadata、想查询数据、探索数据源或表 schema、获取查询结果时使用此 skill。触发：Datadata、数据探索、SQL查询、表检查、执行结果。
Why this skill is useful
Adds specific commands for querying and managing data sources in Datadata that the AI wouldn't reliably generate on its own.
What it needs
Requires datadata account access. About 2k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
功能概览 本 skill 围绕两大核心功能： 查询数据 搜索数据源 — 支持社区公开搜索（无需登录）、私有数据源搜索、username/name 精确查找 元数据查询 — 检查数据源信息、列出表、描述列结构 执行 SQL 查询 — 通过 execute-adhoc 执行 SELECT 查询，支持 DuckDB 和 ClickHouse 引擎，DuckDB 引擎可跨数据源关联 结果下载 — 以 NDJSON 或 CSV 格式下载查询结果 Schema 扫描 — 触发异步扫描，刷新数据源的表元数据 录入数据 Data Spaces 表管理 — 在 ducklake 数据空间中创建表、批量插入数据、删除表 录入的数据同样可通过 execute-adhoc 查询 用户信息 当前用户及 API Key 权限 — 通过 whoami 获取用户资料、API Key 元数据及权限列表，用于验证可用性 生成脚本 提供 urllib.request 直接调用示例，零额外依赖（详见 references/api.md） 使用场景 当用户提出以下需求时，应激活本 skill： 场景 示例 --------------------------- -------------------------------------------------------------------------------- 查询 Datadata 中的数据 "帮我查一下销售数据"、"统计上个月的用户增长" 搜索数据源 "搜索名叫 customers 的数据源"、"找一下 hungtcs 的公开数据"、"看看我有哪些数据源" 探索数据源结构 "看看这个 datasource 有哪些表"、"描述一下 customers 表的字段" 跨数据源关联分析 "把 MySQL 的订单表和 CSV 的用户信息 join 一下" 数据写入与持久化 "把爬虫结果存到 data space 里"、"批量插入这些数据" 获取查询结果 "下载上次查询的 NDJSON 结果" 以编程方式调用 Datadata API "帮我写一个 Python 脚本直接调 Datadata API" 验证 API Key "检查一下当前 Key 是否有效" 概念 Datasource — 查询目标的数据源。不同类型的 datasource（ducklake、MySQL、ClickHouse、CSV 等）有不同的表命名约定。 Data space — 录入数据的目标。ducklake 类型 datasource 独有的能力，支持创建表、批量插入和删除表。data-space 名称为 datasource 的 name（通过 get-datasource-info 获取）。录入后可通过 execute-adhoc 像查询普通数据源一样查询其中的数据。 Query (execute-adhoc) — 只读抽象，包含 SQL 脚本（SELECT 仅），datasource 绑定和查询引擎类型。查询不会立即执行，直到创建一个 execution。 Execution (get-execution-result) — 运行查询的抽象。每次调用 execute-adhoc 创建一个 execution 并返回 executionId。使用该 ID 异步获取结果。 环境变量 变量名 必填 默认值 对应 CLI 标志 描述 ------------------- ---- -------------------------- ------------- ---------------------------------------------------------- DATADATAAPIKEY 否 — --api-key API 认证密钥，始终以 ak 开头 DATADATABASEURL 否 https://www.datadata.com --base-url API 基础地址，仅本地开发或测试时需覆盖（不要询问用户此值） 提示： CLI 全局标志（--base-url、--api-key）必须在子命令之前出现，否则报"unrecognized arguments"。 获取 API Key 设备授权（推荐）：CLI 缺少 API Key 时，Agent 在同一轮对话中执行三步：device-flow-start → 浏览器打开 verificationUriComplete → device-flow-complete。成功后 Key 自动持久化，有效期 90 天。详见 references/cli.md。 手动设置（备选）：登录 datadata.com → Settings → API Keys → 创建（权限勾选 qu …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/datadata-api