Get dataset

tw_get_dataset

TW-specificMIT

**關鍵字 / Keywords**: 資料集 metadata 描述欄位 schema 授權 license dataset info fields

取得資料集完整 metadata 與樣本資料列。

參數：
    dataset_id: 從 tw_search_datasets 取得的 dataset_id
    sample_rows: 樣本列數（v1.45.0: 預設 3，硬 cap 3）。設 0 跳過樣本

回傳：metadata（含 schema.columns、schema.row_count、license、source.url、
    join_keys、provenance）以及 sample（columns 與 rows）。若資料集尚未
    normalise，metadata 會是 None（用 tw_query_rows 觸發 lazy fetch）。

注意：v1.45.0 起 `sample_rows` 硬 cap 3（原 5、可自訂）— 防止 scraper
用 `tw_get_dataset` 一次拉多筆繞過 rate limit。 想拉完整資料用 tw_query_rows。

Input schema

{
  "properties": {
    "dataset_id": {
      "title": "Dataset Id",
      "type": "string"
    },
    "sample_rows": {
      "default": 3,
      "title": "Sample Rows",
      "type": "integer"
    }
  },
  "required": [
    "dataset_id"
  ],
  "title": "tw_get_datasetArguments",
  "type": "object"
}

How to call

Once your Twinkle Hub MCP client is configured, your agent will see tw_get_dataset. Just ask it to call — example:

# Ask Claude / any MCP client:
請用 tw_get_dataset 處理 "…"。

# It will call:
tw_get_dataset(input="…")

Haven't set up a client yet?

Claude Desktop in 3 minutes — download the .mcpb and double-click, or see docs for other clients.

See user docs