資料集目錄

歐噴整理的台灣公共資料集，含立法院、標案、選舉等主題

搭配 AI Agent 使用 需使用支援工具呼叫（tool use）的 AI Agent，例如 Claude Code、Cursor、Copilot Agent 等

使用說明（複製後貼入 AI）

# 歐噴資料庫（data.openfun.tw）

台灣公共資料 API 平台，提供稅籍登記、立法院議事、採購標案等公共資料的全文搜尋與結構化查詢。所有 API 需要 Bearer Token 認證，請前往 https://data.openfun.tw/user 免費申請帳號與 Token。

## 搜尋資料集

GET https://data.openfun.tw/api/v1/datasets?q={關鍵字}

回應的每筆記錄包含：slug、title、description，以及 skill_md_url（若該資料集有 AI 使用指引）。

## AI 使用指引（skill.md）

每個資料集若有 AI 使用指引，可在以下 URL 取得完整說明（欄位、查詢語法、範例）：
https://data.openfun.tw/datasets/{slug}/skill.md

## 讀取 skill.md 的正確方式

skill.md 端點回傳 `Content-Type: text/plain`，內容為純文字 Markdown。

**必須用 Bash 工具執行 curl：**
```
curl -s https://data.openfun.tw/datasets/{slug}/skill.md
```

**禁止使用 WebFetch 工具**讀取 skill.md。WebFetch 使用 HTML 提取工具（trafilatura 等），
即使回傳的是純文字，仍可能截斷內容、遺漏欄位名稱、查詢參數、curl 範例等關鍵細節。
唯一可靠的方式是 Bash + curl 取得原始內容。

## 核心 API 端點

### 查詢記錄
GET https://data.openfun.tw/api/v1/datasets/{slug}/records
支援參數：q（全文搜尋）、q[欄位名]（欄位搜尋）、{欄位名}=值（精確篩選）、{衍生欄位名}=值（點號欄位精確篩選）、page、per_page、sort、fields
回應：{ total, page, per_page, records[], schema[] }

### 統計聚合
GET https://data.openfun.tw/api/v1/datasets/{slug}/agg
支援參數：group_by（必填，keyword 欄位）、field（選填，數值欄位）、{欄位名}=值（篩選）
回應：{ total_records, total_groups, groups[].key, groups[].stats.count }
field 有傳時 stats 額外含 sum/avg/min/max/percentiles
完整文件：https://data.openfun.tw/api-docs.md

## 資料邊界與來源標示

每筆事實必須來自實際 API 查詢結果。

**歐噴查得到** → 以查詢結果回答 + 標明原始資料來源（不是「歐噴資料庫提供」就帶過。每份 skill.md / knowledge.md 的「資料來源」section 都有原始機關名稱與網址，例如：「資料來源：監察院 ardata.cy.gov.tw／經歐噴資料庫整理」、「資料來源：中央選舉委員會 db.cec.gov.tw／經歐噴資料庫整理」）。

**歐噴查無** → 禁止生成「貌似資料庫紀錄」的回答。明示「歐噴資料庫未收錄此資料」，並擇一處理：
- 引用公開常識時：標明「以下為一般知識，非歐噴 API 查得」
- 已知有其他公開來源時：建議使用者去原始機關查
- 無法回答時：直接說無法回答

## 精選資料集

以下為常用資料集，有完整 AI 使用指引。找不到合適的，再下載完整清單（見下方）。

### 選舉
- `tw.gov.cec~ref~election-event`：查歷次投票事件清單，含選舉類型、投票日期、屆次（需 Token）
- `tw.gov.cec~ref~candidates`：查歷屆候選人資料，含姓名、政黨、選區、當選與否（每週更新；需 Token）
- `tw.gov.cec~txn~candidates-votes`：查各候選人在各行政區（全國／縣市／鄉鎮／村里）的得票數，跨縣市或鄉鎮分析必備（需 Token）

### 商業登記
- `tw.gov.fia.eip~ref~business-tax`：查全國公司、行號稅籍登記，含統一編號、行業別、地址（需 Token）

### 行業分類
- `tw.gov.mof~ref~industry-tax`：查財政部稅務行業標準分類代碼與名稱（需 Token）
- `tw.gov.mof~ref~industry-tax~history`：同上，含歷史版本對照，可追蹤分類碼變遷（需 Token）

### 政府組織
- `tw.gov.dgpa~ref~gov-org`：查政府機關代碼與名稱，適合代碼轉換為機關全名；若需 OID 識別碼請改用 `tw.gov.moda~ref~oid`（需 Token）

### 政黨
- `tw.gov.moi~ref~party`：查全國政黨登記資料，含黨主席、黨員數、成立日期（每日更新；需 Token）

### 法律
- `tw.gov.moj~ref~law`：全文搜尋現行法律條文，含法規名稱、條號、條文內容（每週更新；需 Token）

### 立法院
- `tw.openfun~api~legislation`：查立法委員、法案、公報、質詢等立法院資料（即時；**免 Token**）

### 政府採購
- `tw.openfun~api~procurement`：搜尋政府採購標案、決標資訊、得標廠商（每日更新；**免 Token**）

### 預算
- `tw.openfun~bulk~budget-central`：查中央政府各部會年度預算（Google Sheets；**免 Token**）
- `tw.openfun~bulk~budget-local`：查各縣市地方政府年度預算（Google Sheets；**免 Token**）
- `tw.openfun~bulk~budget-detail`：查預算詳細科目，含計畫別與用途別明細（不定期；靜態 CSV；**免 Token**）

### 競選財務
- `tw.openfun~bulk~campaign-finance`：歷屆選舉政治獻金申報明細，可分析候選人各類選舉支出（餐飲、文宣、人力、交通等）與捐款來源（靜態 CSV；**免 Token**）

### 行政區劃
- `tw.openfun~entity~geo`：查全國行政區代碼，含縣市、鄉鎮市區、村里三層；支援 GIS API 取得各行政區地理邊界 polygon，可用於地圖繪製（需 Token）

### 不動產交易
- `tw.gov.moi.segis~txn~_wildcard_`：查全台各地政事務所不動產交易實價登錄，依地段、區段篩選（需 Token）

## 資料集目錄

精選清單以外，完整清單（144 筆）可下載到本機搜尋：

下載公開資料集（存至 /tmp，不污染家目錄）：
curl -s -o /tmp/openfun-datasets.jsonl https://data.openfun.tw/datasets.jsonl

下載含授權私有資料集（需 Token）：
curl -s -H "Authorization: Bearer YOUR_TOKEN" -o /tmp/openfun-datasets.jsonl https://data.openfun.tw/datasets.jsonl

搜尋範例：
grep "娃娃機" /tmp/openfun-datasets.jsonl

找到 slug 後取得 AI 使用指引：
curl https://data.openfun.tw/datasets/{slug}/skill.md

貼入 AI Agent 的 system prompt 或對話起始，搭配下方 Token 使用。

貼入後，你可以這樣問：

我是記者，想查查看政府最近有哪些採購標案，金額最大的是哪些？

台北市有多少家夾娃娃機店？哪個區最多？

統一編號 22555003 是哪家公司？登記地址在哪裡？

全台灣有哪些精釀啤酒相關業者？大概有幾家？