tw-opendata-tourism-stat — 觀光署統計報表(stat.taiwan.net.tw mirror)

與 tw-opendata-tourism 的分工

問「九份景點清單」用前者;問「2024 來臺旅客國籍前 10」用後者。

Corpus 概況

更新:每月 1 號 cron 從上游 lastOpenYearMonth diff sync(若無新月份直接 skip,idempotent)。

完整 dataset_id 列表(37 筆)

年表(14 個 — 民國 45 / 1956 起完整時間序列)

tad-inbound-year-residence       入境旅客年別 × 居住地
tad-inbound-year-nationality     入境旅客年別 × 國籍
tad-inbound-year-age             入境旅客年別 × 年齡
tad-inbound-year-gender          入境旅客年別 × 性別
tad-inbound-year-purpose         入境旅客年別 × 來台目的
tad-inbound-year-lengthofstay    入境旅客年別 × 停留天數
tad-inbound-year-transport       入境旅客年別 × 交通方式
tad-inbound-year-expenditure     入境旅客年別 × 觀光支出
tad-outbound-year-destination    出境國人年別 × 目的地
tad-outbound-year-age            出境國人年別 × 年齡
tad-outbound-year-gender         出境國人年別 × 性別
tad-outbound-year-lengthofstay   出境國人年別 × 停留天數
tad-cruise-year                  郵輪旅客年別
tad-scenicspot-year              觀光遊憩據點年別

月表(12 個 — 民國 100 / 2011 起每年逐月,首欄 民國年度)

tad-inbound-month-residence              入境月別 × 居住地
tad-inbound-month-nationality            入境月別 × 國籍
tad-inbound-month-age                    入境月別 × 年齡
tad-inbound-month-gender-purpose         入境月別 × 性別 × 來台目的
tad-inbound-month-lengthofstay           入境月別 × 停留天數
tad-inbound-month-transport              入境月別 × 交通方式
tad-outbound-month-destination           出境月別 × 目的地
tad-outbound-month-gender-age            出境月別 × 性別 × 年齡
tad-outbound-month-lengthofstay          出境月別 × 停留天數
tad-cruise-month-residence-port-gender   郵輪月別 × 居住地 × 港口 × 性別
tad-scenicspot-month-single              觀光遊憩據點月別(單一景點)
tad-scenicspot-month-progressive         觀光遊憩據點月累計

首頁儀表板(11 個 — 上月即時 / 近期 trend)

tad-index-inbound-lastmonth      上月入境 5 大客源群
tad-index-inbound-near           入境近期趨勢
tad-index-inbound-nearyears      入境近 10 年 × top 國家
tad-index-inbound-byresidence    入境居住地排行
tad-index-inbound-visitorsstats  入境累計統計
tad-index-outbound-lastmonth     上月出境概況
tad-index-outbound-near          出境近期趨勢
tad-index-outbound-bydestination 出境目的地排行
tad-index-outbound-travelerstotal 出境累計人次
tad-index-access                 本站訪問統計
tad-index-banner                 首頁輪播

何時用本 skill

觀光統計 / 來台旅客 / 入境統計 / 出境統計 / 觀光客源 / 觀光局統計 / 觀光署統計 / 國家觀光統計 / 觀光支出 / 郵輪旅客 / 觀光遊憩據點人次 / inbound tourists / outbound visitors / TBROC stats / Taiwan tourism statistics 字眼。

不適用:個別景點名錄(用 tw-opendata-tourism)、商業訂房數據(不開放)、逐日數據(觀光署只發到月粒度)。

MCP Tools

query_rows(dataset_id, where?, columns?, limit?) — 主要用法。 get_dataset(dataset_id) — 看完整 metadata + 樣本。

範例 query

Schema 注意事項

XLSX 來源的 dataset(tad-*-year-*)有以下慣例:

1. 欄位名稱以 _ 連接 — 多列表頭被攤平成 region_dimension 格式,例如 "亞洲地區_馬來西亞 Malaysia"、"歷年來臺旅客按居住地分_年 度_Year"。
2. 年度欄位:第一個欄位幾乎都是 "年 度_Year"(注意中間有空格),內容 形如 "113年2024"、"114年2025",需要 ILIKE / LIKE 過濾。
3. 資料型別:全部欄位以字串保存(faithful 原始 XLSX),數字也是字串。 做數字比較或聚合時 cast: CAST("某欄" AS DOUBLE)。
4. 缺值:歷史早年某些維度為 0.0 或空字串(不是 NULL),例如民國 45 年 的「印度」「中東」欄位都是 0.0 因為那時沒分這些細項。

JSON 來源的 dataset(tad-index-*)是 dashboard 即時聚合,schema 各異:

• lastmonth 系列:{name, value} 5 row(5 大客源群 / 5 大目的地)
• nearyears:{name, value} 60 row(6 國 × 10 年攤平 → 平面 table)
• byresidence / bydestination:{code, name, count, nameEn} 30 row
• visitorsstats:單一 row 含累計值

來源 / License 注意

原始 API: https://stat.taiwan.net.tw/data/api/statistics/* + /data/api/index/*。 非 OGDL、也不在 data.gov.tw 上架。我們以政府機關公開資料慣例 + 公益研究 用途鏡像。下游 commercial use 前請聯繫 acerit@tad.gov.tw 取得書面同意。

技術機制 / 反爬機制細節請見 OpenData repo docs/survey-2026-06-25-stat-taiwan-net-tw-api.md。