版本紀錄

重點

• ✓**⏳ 法條時光機** — 給定任一日期，回傳當時生效的法條原文。分析老判決時直接看「案發當時」的條文，不會誤用現行法。（`tw_statute_at_date`）
• ✓**📜 修法沿革 + 新舊法 diff** — 每一條的完整 revision 歷史，新舊版本以 unified diff 逐字對照。（`tw_statute_history` / `tw_statute_diff`）
• ✓**🔎 法規全文檢索** — BM25 關鍵字搜尋法條內文，一句話找到相關條文。（`tw_statute_search_text`）
• ✓**🕸️ 條文關聯圖** — 相關 / 引用 / 姊妹條文、定義章與主題錨點；涵蓋 **935 部現行中央法規、35,454 條、81,868 條關聯**。（`tw_statute_related` / `tw_statute_definitions` / `tw_list_supported_statutes`，Pro 開放）
• ✓免費即可用：法條時光機、修法沿革、diff、全文檢索、統計；關聯圖與定義查詢為 Pro 方案。
• ✓**授權**：法規原文取自政府公開之全國法規資料庫，屬公眾得自由利用之政府資訊。

範例 prompt

• 民國 100 年 3 月時的個資法第 6 條長什麼樣
• 勞基法第 84 條之 1 的修法沿革
• 個資法這幾年新舊版本差在哪
• 搜尋法規裡提到「特定目的外利用」的條文

重點

• ✓**📘 教檢（教師資格考試）** — 429 份試卷 / **12,731 題**、民國 094-115（2005-2026）、**97.6% 含標準答案**。涵蓋 5 應試類科：幼兒園 / 身心障礙組 / 資賦優異組 / 國民小學 / 中等學校。主辦：教育部受託國立臺灣師範大學心理與教育測驗研究發展中心
• ✓**📗 教甄（教師甄試）** — 90 份試卷 / **2,421 題**、民國 109-115（主力近 7 年）、10 縣市實際內容（主力台北市 + 中部策略聯盟 10 縣市）。主辦：各縣市政府教育局/處
• ✓新 MCP tool：`search_teacher_exam_questions` / `search_teacher_recruit_questions`（語意搜尋題目）、`search_teacher_exam` / `search_teacher_recruit`（試卷 metadata 篩選）、`get_teacher_exam_paper` / `get_teacher_recruit_paper`（完整試卷 + 答案）
• ✓兩個 corpus 嚴格分開、互不混淆：找「取得教師資格的考試」用教檢、找「應徵某校特定缺的考試」用教甄
• ✓**License：著作權法 §9 第 1 項第 5 款 法定豁免** — 「依法令舉行之各類考試試題及其備用試題」不得為著作權之標的。我們只收試題本 + 選擇題答案，不收申論題詳解（那些才是命題人著作）
• ✓為何教甄少於教檢 6x？各縣市公開狀況差異大、很多縣市只放簡章/錄取名單、不放試題本身。新北（SPA 爬不到）+ 連江（無正式聯合甄選）目前缺。我們把能找到的都拿到了

範例 prompt

• 教檢有沒有皮亞傑的題目
• 113 年中等學校學習者發展那份考卷給我看
• 中策聯盟音樂科教甄考過什麼
• 教檢幼兒園 113+ 年的試卷
• 教甄音樂科最近 3 年常考什麼

Dataset IDs

teacher_examteacher_recruit

重點

• ✓**SHP loader infra**（`twopendata/shp.py`）— 純 Python（pyshp + pyproj，不依賴 GDAL）讀取 SHP 圖資、自動 TWD97 → WGS84 座標轉換、Big5/CP950 編碼 fallback。長期解鎖 **478 個 SHP datasets** 進入 corpus mirror pipeline
• ✓**臺北市淹水互動地圖 v4.1**（demo artifact）— 對標臺北市災害應變中心地圖化資訊展示系統的 17 個 functional items **10/10 完成**：水庫即時水位、雨量觀測、河川水情、避難所定位、降雨情境模擬、易積水地區、抽水站等
• ✓對 SHP `.prj` 錯誤標註做了防禦式 detection + WARNING log + fallback（已踩到 `28028 土石流潛勢溪流圖` 標 EPSG:3822 但 data 是 EPSG:3826 TM2 的 bug）
• ✓demo 地圖 size 1.02 MB，純前端 HTML、不依賴 MCP gateway

範例 prompt

• 我家在內湖、下大雨時會淹到嗎
• 信義區最近的避難所在哪
• 翡翠水庫現在的水位 + 蓄水量
• 全國河川目前哪邊水位告警

重點

• ✓**11 個新 tool**（`rt_*` namespace）— 整合中央氣象署 CWA、國家災害防救中心 NCDR、水利署 WRA 的官方公開 API，讓 MCP client 直接問即時問題、不用查 dataset
• ✓氣象：`rt_cwa_realtime_rainfall`（10 分鐘更新的自動雨量站）、`rt_cwa_24h_rainfall`、`rt_cwa_typhoon_status`、`rt_cwa_radar_image_url`（雷達回波圖）、`rt_cwa_36h_forecast`（縣市天氣預報）
• ✓災害：`rt_ncdr_active_alerts`（整合 CWA + 水利署 + 公路局的即時告警 RSS）
• ✓水文：`rt_reservoir_live`（翡翠 / 曾文 / 阿公店 / 牡丹 4 大水庫即時）、`rt_wra_water_level`（全國 375 河川測站）、`rt_wra_groundwater_level`、河川 / 雨量測站清單
• ✓MCP tool 總數從 31 個 → **42 個**
• ✓資料源：中央氣象署 / 水利署 / NCDR，授權 OGDL；CWA 部分需註明出處

範例 prompt

• 現在臺北的雨量
• 翡翠水庫目前狀態
• 今天有沒有颱風警報
• 現在全國有哪些災害告警
• 近 24h 高雄哪邊雨下最大

Dataset IDs

rt_*

重點

• ✓165 個新資料集（`tp-*` 前綴），鏡像自臺北市政府資料大平臺 [data.taipei](https://data.taipei/)
• ✓**89 個是臺北市獨家**（data.gov.tw 沒有），**89 個跟淹水 / 水利 / 災防相關**（含 13 個跨組）
• ✓重點包含：**易積水地區** (`tp-00003975`)、**降雨積水模擬** (78.8/100/130mm 三情境，`tp-00000862`)、**翡翠水庫即時水情**（每小時更新，`tp-00000422`）、**雨水下水道 17,408 段**（`tp-00001207`）、抽水站、雨量站、12 區疏散避難地圖、6 種災時供水站
• ✓立刻可用案例：「內湖淹水熱區」「我家附近抽水站」「翡翠水庫今天水位」「災時可以去哪取水」「下大雨會淹哪裡」
• ✓上游每月 1 號自動 cron diff sync，新資料自動進來不必手動更新
• ✓資料源：**臺北市政府資料大平臺**（[data.taipei](https://data.taipei/)），授權 **OGDL v1**（政府資料開放授權條款第 1 版，可商用、需註明出處）

範例 prompt

• 內湖淹水的時候我家會淹嗎
• 翡翠水庫現在的水位跟蓄水量
• 信義區的災時供水站在哪
• 下 130mm 大雨時臺北哪裡淹最深
• 我家附近雨水下水道有沒有問題

Dataset IDs

tp-*

重點

• ✓**6 個新 dataset**（`dronegis-*` 前綴），鏡像自民航局 [dronegis.caa.gov.tw](https://dronegis.caa.gov.tw/) ArcGIS Server。**9,740 個 polygon 圖資**
• ✓**主資料 `dronegis-uav-zones`**（4,424 row × 30 中文欄位）— UAV 紅黃綠分區、空域名稱 / 類別 / 顏色 / 主管 / 會商機關 / 罰則 / 說明完整
• ✓補 `dronegis-nfz`（5,095，NFZ raw schema）、`dronegis-emg-area`（110，緊急 / 國安臨時管制含有效期間）、`dronegis-national-park`（66）、`dronegis-taipei-fir`（23）、`dronegis-county`（22 行政邊界）
• ✓data.gov.tw 上民航局只放了 2 個圖資（機場禁區 + 臺北 FIR）— 縣市公告區、警戒區、國安管制、火炮射擊全部沒有，這次補滿
• ✓**OpenData Extension 系列正式上線** — 所有「非 data.gov.tw」的 Twinkle AI 自家鏡像（ly / pcc / lvr / tad / dronegis / jud / kh）統一加 `is_extension=True` flag、catalog 可單獨篩
• ✓每日 04:30 UTC 自動 cron diff sync

範例 prompt

• 我家附近有沒有禁飛區
• 陽明山國家公園範圍內可以空拍嗎
• 桃園機場 5 公里內的禁航區
• 今天哪邊有臨時航空管制

Dataset IDs

dronegis-uav-zonesdronegis-nfzdronegis-emg-areadronegis-national-parkdronegis-taipei-firdronegis-county

重點

• ✓37 個新資料集（`tad-*` 前綴），鏡像交通部觀光署官方統計報表，民國 45 年（1956）至今 **70 年完整時間序列**
• ✓4 大主題：**來臺旅客**（國籍 / 居住地 / 年齡 / 性別 / 來台目的 / 停留天數 / 觀光支出 多維度）、**出境國人**（前往地 / 性別 / 年齡 / 交通方式）、**郵輪旅客**、**觀光遊憩據點**年度人次
• ✓**月度 + 年度雙時序**：可拉「同月 YoY」（2025-05 vs 2024-05）也可看「年總覽」（2019 / 2024 / 2025 三年比較）
• ✓新 skill `tw-opendata-tourism-stat`（v1.0.0）已上 `/skills` 並提供 `.skill.zip` 下載；典型 query 範例見該頁
• ✓跟既有「觀光 / 國家公園」（`tw-opendata-tourism`）**互補不重複**：景點 / 民宿 / 國家公園 POI 走原 skill；統計 / 時序 / 多維度交叉走新 skill
• ✓上游每月 1 號自動 sync，新資料 release 不必手動 refresh
• ✓資料源：交通部觀光署 stat.taiwan.net.tw 觀光統計資料庫（公開統計報表；重新散布請保留來源歸屬）

範例 prompt

• 2025 年來臺旅客國籍前 10 名，跟 2019 年比較
• 日本旅客來臺停留天數歷年分布
• 2024 出境國人去日本 vs 韓國月度趨勢
• 玉山國家公園歷年遊客人次

Dataset IDs

tad-*

重點

• ✓藥品仿單檢索後端整個改寫成預建索引，3 個查詢工具實測延遲降到 1-3 毫秒：`opendata-search_drug_label`（仿單欄位精準搜尋）、`opendata-check_drug_interaction`（多藥交互作用掃描）、`opendata-get_drug_details` 的仿單合併段
• ✓實測 warm-cache 延遲：仿單欄位搜尋 1.78 ms（原本 50-200 ms）；2 藥交互作用掃描 0.27 ms
• ✓藥品許可證行政欄位的搜尋（`opendata-search_drug` 等）仍走原路徑、下一個版本一起搬，本次先把使用最多的仿單路徑解掉
• ✓對使用者 0 改動：tool 簽名、回傳格式、env vars 都不變，agent 不用重連、prompt 不用改
• ✓資料源：藥品仿單來自 `twinkle-ai/tw-drug-labels-vision`（CC-BY-4.0，44,663 件結構化仿單）

範例 prompt

• 仿單裡同時提到 warfarin 跟 NSAIDs 的藥（會明顯更快）
• 搜尋仿單禁忌欄位含「妊娠」的藥
• 比對這 3 個許可證字號的藥之間有沒有交互作用

Dataset IDs

tfda-drug-leaflets

重點

• ✓ICD-10-CM 中文版 96,803 碼：`opendata-lookup_icd10` 支援代碼 prefix 比對與中／英文關鍵字模糊搜尋（資料源：衛福部 data.gov.tw 177507，OGDL v1）
• ✓TFDA 全部藥品許可證 71,836 件：`opendata-search_drug` 按品名／適應症／許可證字號／是否仍有效查詢；`opendata-get_drug_details` 一次拿到行政欄位 + 仿單結構化欄位（資料源：data.gov.tw 9122，OGDL v1）
• ✓藥品仿單 44,663 件結構化（適應症、禁忌、警告、交互作用、不良反應、用法用量 6 欄）：`opendata-search_drug_label` 直接在仿單欄位內精準搜尋；`opendata-check_drug_interaction` 對 2–10 個藥同時掃交互作用（資料源：我們自家 HF dataset `twinkle-ai/tw-drug-labels-vision`，CC-BY-4.0）
• ✓食品營養成分 226,825 行：`opendata-query_food_nutrition` 內建學術／日常用語對應（蛋白質 ↔ 粗蛋白 等）；TFDA 健字號健康食品 562 件：`opendata-search_health_supplements`（資料源：data.gov.tw 8543 / 6951，OGDL v1）
• ✓全部新工具皆 sub-100ms 純 SQL 查詢，無外部 API 依賴
• ✓0 部署改動：升 image 即用，tool 簽名與回傳格式都不變
• ✓⚠ Disclaimer：`check_drug_interaction` 為文字 substring 掃描，僅供研究／教育用途，非臨床決策工具

範例 prompt

• 查 ICD-10 第二型糖尿病的所有編碼
• TFDA 含「Metformin」的藥品許可證有哪些、適應症是什麼
• 把仿單裡同時提到 warfarin 和 NSAIDs 的藥列出來
• 鮭魚跟鮪魚 omega-3 含量哪個高
• 看一下這幾個健字號是哪一類保健功效

Dataset IDs

tfda-drug-licencestfda-health-supplementsmoa-food-nutritionmoh-icd10-zh-tw

重點

• ✓對外查詢用的 embedding 服務切到專屬 managed endpoint，p99 延遲降到接近零超時
• ✓Bulk preprocessing（chunk embed、backfill）跟對外 query 分流、互不影響 — 資料庫 backfill 時對外 query 不再退化
• ✓對使用者 0 改動：tool 簽名、回傳格式、env vars 都不變
• ✓新版 OpenData container (v1.22) 已 ship 並在 Twinkle Hub 後端跑著、所有人自動受益

範例 prompt

• 找 2024 高雄地院關於商標侵權的判決（會明顯更快）
• 找律師考試考過「董事責任」的題目
• 台積電 2023 後 EUV 相關專利

Dataset IDs

judicial-judgmentsmoex-examtipo-patents

重點

• ✓Anthropic Agent Skills 標準（.claude/skills/<slug>/SKILL.md），下載到 ~/.claude/skills/ 就生效
• ✓20 個 skill 對應每個資料領域：實價登錄、政府採購、立法院、司法判決、國家考試、TIPO 專利、地理、交通、健保、金融、環境、農漁、教育、勞動、能源、文化、人口、觀光、通用 catalog + 工具導覽 meta
• ✓Claude Desktop / Claude Code / GitHub Copilot CLI / OpenAI Codex CLI 等 MCP client 載入後可直接「知道什麼問題用哪個 tool、用什麼 filter」
• ✓每個 skill 內含使用範例、tool 簽名、邊界條件、跟其他 skill 的關係
• ✓一次下載：hub.twinkleai.tw/skills/twinkle-hub-skills-all.zip；單獨下載：/skills/<slug>

範例 prompt

• （載入 skills 後）幫我看信義區去年買賣案件均價
• （載入 skills 後）找 2024 高考三級民法相關考題
• （載入 skills 後）查台積電最近 3 年 EUV 微影相關專利

重點

• ✓考選部 MOEX 全部公開考卷：民國 101–114（西元 2012–2025）共 14 年
• ✓64,815 份試卷、320,663 題（測驗題切 A/B/C/D、申論題切大題，全部結構化）
• ✓白話語意搜尋：直接問「土壤液化」「公司法 董事責任」「環境影響評估」即可
• ✓可下鑽到單份試卷看每題題幹（測驗題含官方答案；申論題官方不公布答案）
• ✓新工具：`opendata-search_exam` + `opendata-get_exam_paper`
• ✓現有用戶請完全 Quit Claude Desktop（Cmd+Q）再開，connector 才會載入新工具
• ✓資料源：考選部考畢試題（data.gov.tw 170565、OGDL v1，商用 + redistribute OK）

範例 prompt

• 找台灣國考考過環境影響評估的題目
• 歷屆律師考試提到「董事責任」的題目
• 民國 113 年高考三級有哪些土壤力學相關題目

Dataset IDs

moex-exam

重點

• ✓內政部 TGOS 地理工具：座標 ↔ 門牌 / 6 碼郵遞區號互查
• ✓9 主題環域查詢：避難收容處所、寺廟、測速執法、歷史交通事故…
• ✓LVR 實價 + PCC 採購補上行政區代碼 — 終於能一個 town_code 跨庫 JOIN
• ✓範例：信義區 2024 房價 3,485 件、均價 2,718 萬，可直接對照同區政府採購熱絡度
• ✓資料源：內政部國土測繪中心 data.tgos.tw（OGDL v1，須註明出處）

範例 prompt

• 臺北市信義區 2024 平均房價
• 座標 (121.57, 25.03) 在哪個行政區
• 信義區政府採購熱度跟房價有關嗎

Dataset IDs

lvr-tradeslvr-presalelvr-rentalspcc-tender

重點

• ✓119 場 2026 高雄技術社群活動（GDG / TOOCON / PyLadies / KIMU / Build with AI…）
• ✓13 個社群 + 集章獎勵 + 贊助商清單
• ✓零安裝：不用裝 npm、不用 GitHub token，Claude Desktop 直接問
• ✓twinkle-hub 首個社群維護的外部 dataset partner — 生態系開門
• ✓資料源：高雄社群名牌卡（由 GDG 高雄社群維護，MIT 授權，須註明出處）

範例 prompt

• 高雄 5 月有什麼軟體活動
• GDG 高雄這個月辦什麼
• 列出有集章獎勵的社群

Dataset IDs

kh-community-eventskh-community-list

重點

• ✓Company 360：一個公司名 → 跨公司登記 / 董監事 / 政府採購 / 出進口 / 稅籍 4 個政府庫精確串接
• ✓司法判決統計室：判決結果分布、審判長判決傾向、刑度與求償統計
• ✓全台農村秘境地圖：254 個農村景點＋在地美食灑在真實地圖（OSM）
• ✓全台房價熱力圖、政府採購戰情室
• ✓不用註冊、不用接 MCP，直接在網頁上玩

Dataset IDs

company-360judicial-statsvillages-mapreal-estate-heatmapprocurement-warroomplayground-gallery

重點

• ✓69,499 件判決書（2026-02 PoC 單月，全 30 年 backfill 進行中）
• ✓37 欄結構化：案號 / 法院 / 審級 / 案由 + LLM 抽爭點 / 勝負方 / 刑度 / 判決理由
• ✓sub-second 查詢，可按審判長、案由、法條聚合
• ✓資料源：司法院 裁判書（政府開放資料，統計分析用途）

範例 prompt

• 紀文惠審判長判過的損害賠償案
• 2026 年 2 月民事原告勝率
• 被引用最多的法條 Top 10

Dataset IDs

jud-rulings

重點

• ✓公司行號營業項目代碼 → 中文（788 條,支援 7 碼 GCIS / 4-6 碼 DGBAS / 大分類 1 碼全部 fallback）
• ✓公司狀態 / 商業組織類別 / 資本額區間 三組 in-process lookup（sub-ms,零成本）
• ✓公司董監事 / 分公司 / 名稱模糊查統編 三組 live API(經濟部商業司 data.gcis.nat.gov.tw)
• ✓資料源:經濟部商業司 OData v3 官方 API,授權公開可商用

範例 prompt

• 永貿汽車租賃的統一編號是多少
• 台積電的董監事名單
• 鴻海有哪些分公司
• 行業代碼 2611 是什麼

Dataset IDs

lookup_industry_codelookup_company_status_codelookup_business_unit_typelookup_capital_rangelookup_company_executiveslookup_company_branchessearch_company_by_name

重點

• ✓修了 parser bug:pcc-tender 的「廠商名稱」欄位先前 100% null,現在 99.998% 有值
• ✓實測樣本:永貿汽車租賃 46 筆得標、合計 NT$5,886 萬,廠商查詢路徑完整通路
• ✓資料源:政府電子採購網 web.pcc.gov.tw 官方半月公開資料,全國彙整 mirror

範例 prompt

• 永貿汽車租賃過去得標案合計多少
• 臺北市政府 2024 年得標廠商 top 10
• 某廠商過去 11 年得標案件依機關分佈

Dataset IDs

pcc-tender

重點

• ✓lvr-trades 4.75M row 買賣 / lvr-presale 554k row 預售（含解約）/ lvr-rentals 726k row 租賃
• ✓涵蓋 22 縣市 × 2012-Q3 至 2026-Q1 共 55 季完整歷史
• ✓保留全 33-35 個原始繁中欄位 + 3 個 enrichment 欄位（city / season / ISO 交易日期）
• ✓授權：政府資料開放授權條款 v1（OGDL），可商用、可再授權，須註明出處

範例 prompt

• 信義區 2024 年最高總價的房屋交易前 5 名
• 桃園市中壢區去年買賣件數
• 臺北市辦公型態的租金行情
• 預售屋解約案件按季統計

Dataset IDs

lvr-tradeslvr-presalelvr-rentals

重點

• ✓pcc-tender 從 135k → 162,189 row（涵蓋 2015-04 以後 11 年完整歷史）
• ✓schema 從 9 欄擴充到 19 欄：採購類型、招標方式、得標價、機關電話、機關地址、廠商地址、未得標廠商等
• ✓資料源：政府電子採購網 web.pcc.gov.tw 官方

範例 prompt

• 臺北市政府上月決標清單（含得標廠商 + 金額）
• 某廠商過去 11 年得標總金額
• 百萬以上招標公告 + 機關聯絡電話
• 某機關採購類型分布（工程/財物/勞務）

Dataset IDs

pcc-tender

重點

• ✓ly-councilors：22 個縣市議員資料 603 row（內政部 OGDL v1）
• ✓ly-votes：第 11 屆記名表決 850 event（會議記錄抽取）
• ✓資料源：內政部 + 立法院 data.ly.gov.tw 官方

範例 prompt

• 臺北市市議員名單 + 黨團
• 第 11 屆某能源議案的記名表決傾向
• 民進黨在某重大表決的投票分布

Dataset IDs

ly-councilorsly-votes

重點

• ✓議案、立委個資、公報、議程、質詢、IVOD、會議、委員會 共 8 個 dataset
• ✓資料源：立法院 data.ly.gov.tw 官方,每天自動同步
• ✓授權：立法院政府資料開放宣告（須註明出處）

範例 prompt

• 立法院的委員會有哪些？各掌什麼？
• 第 11 屆民進黨立委名單
• 第 11 屆能源相關議案目前狀態

Dataset IDs

ly-billsly-legislatorsly-gazettesly-gazette_agendasly-interpellationsly-ivodsly-meetsly-committees

重點

• ✓藥品許可證 71k、藥品成分 125k、藥品 ATC 分類 80k、食品營養 226k row
• ✓修了 6 個 FDA endpoint：endpoint 用 .csv 副檔名實際回 ZIP，補了 magic-byte sniff
• ✓授權：政府資料開放授權條款 v1（OGDL）零授權風險

範例 prompt

• 含 metformin 成分的藥品許可證依劑型分布
• 蛋白質最高的 10 種食物
• 白米的營養成分
• 目前核可的健康食品依保健功效分類

Dataset IDs

91179119912091219122695184528543

重點

• ✓全國招標、決標、廠商查詢，每日同步
• ✓資料源：政府電子採購網 web.pcc.gov.tw 官方
• ✓授權：須註明出處（非 OGDL 明列，商業用前法務 review）

範例 prompt

• 某機關上月決標清單
• 某廠商得標案統計
• 百萬以上招標公告

Dataset IDs

pcc-tender

重點

• ✓19 個 domain 涵蓋全台 open data：交通、醫療食品、不動產、農林漁牧、教育、稅務、政府預決算、環境、文化觀光 等
• ✓52,960 個 dataset 從 data.gov.tw + 各部會 OData / API 自動每日同步
• ✓5 個 MCP tool（list_domains / search_datasets / get_dataset / query_rows / materialize_dataset）
• ✓37 個台灣本地 utility（身分證/統編驗證、民國/西元轉換、地址正規化、捷運站查詢、銀行/機關代碼、農曆轉換 等）
• ✓免費 alpha：Google / GitHub 一鍵註冊 → API key → Claude Desktop / Cursor / claude CLI 直接接

範例 prompt

• 台北市信義區的健保特約藥局
• 驗證統編 12345678 並查公司登記資料
• 115 年國定假日 + 補班日
• 從中文地址推郵遞區號