---
group: AI 使用指引
order: 10
---
# 如何在歐噴資料庫找到需要的資料集

> 給 AI Agent 的全域資料集發現指南。有 3000+ 個資料集，本文教你最有效率的搜尋策略。

---

## 方法一：統一搜尋 API（最快，首選）

一次請求，同時回傳「相關資料集」＋「資料主體出現在哪些資料集」：

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/search?q=關鍵字"
```

回應結構：
- `datasets.results`：哪些資料集與關鍵字相關（含 `skill_md_url`，可直接讀查詢指南）
- `entities.groups`：真實世界的人/公司/機關出現在哪些資料集（依資料集分組，附 entity 頁面連結）

**選用參數：**
- `per_dataset=N`（預設 5）：每個資料集最多顯示幾筆 entity
- `max_datasets=N`（預設 30）：entity 搜尋最多橫跨幾個資料集

**搜尋技巧：**
- 用白話自然語言：`?q=台北市人口`、`?q=候選人得票`、`?q=開放文化基金會`
- 試機關名：`?q=內政部SEGIS`、`?q=中選會`、`?q=財政部`
- 試概念詞：`?q=實價登錄`、`?q=稅籍登記`、`?q=政治獻金`
- 如果 `entities.groups` 有結果但 `datasets.results` 沒有（或反之），兩者都值得查看
- 最多嘗試 2 次，若仍無結果，停下來告訴使用者找不到

如果只想搜**資料集**（不需要 entity 資訊），可用輕量版：

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets?q=關鍵字"
```

---

## 方法二：主題瀏覽（知道大方向時）

```bash
# 列出所有頂層主題
curl "https://data.openfun.tw/api/v1/categories"

# 取某主題底下的資料集（無需 Token）
curl "https://data.openfun.tw/api/v1/datasets?category=tw.stat"
```

目前頂層主題：`tw.politics`（政治）、`tw.stat`（社會）、`tw.kyc`（經濟產業）、`tw.land`（土地戶政）、`tw.finance`（金融）、`tw.transport`（交通）。

---

## 找到資料集後：讀取 AI 使用指引

找到 `slug` 後，優先讀 skill.md——它包含欄位說明、查詢範例、注意事項：

```bash
# 必須用 curl，不能用 WebFetch（WebFetch 會截斷內容）
curl -s "https://data.openfun.tw/datasets/{slug}/skill.md"
```

`skill_md_url` 欄位不空代表此資料集有 skill.md。

---

## Slug 命名慣例（看 slug 就能推斷資料集性質）

格式：`{倒置網域}~{類型}~{識別碼}`

| 類型 | 意義 | 範例 |
|------|------|------|
| `ref` | 參考/對照資料（靜態清單） | `tw.gov.cec~ref~candidates` |
| `txn` | 統計交易資料（有時間序列） | `tw.gov.moi.pip~txn~sale-price` |
| `bulk` | 大包下載（非逐筆 API） | `tw.openfun~bulk~budget-central` |
| `api` | 外部 API 包裝 | `tw.openfun~api~legislation` |
| `entity` | 實體資料（可查個別記錄） | `tw.openfun~entity~geo` |

網域部分規律：`tw.gov.moi`=內政部、`tw.gov.cec`=中選會、`tw.gov.moj`=法務部、`tw.openfun`=歐噴自製。

---

## SEGIS 統計資料（2969 個資料集）特別說明

SEGIS（社會經濟資料服務平台）是內政部的大型統計庫，涵蓋人口、住宅、就業等多個主題。

**不要猜 slug**，透過目錄資料集來找：

```bash
# 第一步：在 ref~product 找到你需要的統計產品
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moi.segis~ref~product/records?q=人口"

# 第二步：從回傳記錄的 dataset_slugs 欄位取得正確 slug
# 例如：["tw.gov.moi.segis~txn~tw-04-301000000a-010001.u01co", ...]
```

SEGIS 所有 txn 資料集共用同一份 AI 使用指引：

```bash
curl -s "https://data.openfun.tw/datasets/tw.gov.moi.segis~txn~_wildcard_/skill.md"
```

---

## 找不到時的處理原則

1. **換關鍵字再試一次**：白話換成專業術語，或反過來（「稅籍」試「登記」，「死亡率」試「死亡人數」）
2. **試主題瀏覽**：不確定叫什麼名字時，從 `?topic=` 進去看有哪些
3. **最多 2 次**：兩次都找不到就停下來，告訴使用者：「歐噴資料庫目前未收錄此類資料，建議至原始機關查詢」
4. **不要亂猜 slug**：slug 不能用猜的，一定要從搜尋結果或 skill.md 的關聯資料集取得

---

## 常見資料集快查表

| 需求 | 資料集 slug |
|------|------------|
| 歷屆候選人、得票數 | `tw.gov.cec~ref~candidates`、`tw.gov.cec~txn~candidates-votes` |
| 公司稅籍登記 | `tw.gov.fia.eip~ref~business-tax` |
| 現行法律條文 | `tw.gov.moj~ref~law` |
| 政府機關代碼 | `tw.gov.dgpa~ref~gov-org` |
| 政黨登記 | `tw.gov.moi~ref~party` |
| 不動產實價登錄 | `tw.gov.moi.land~ref~plvr` |
| 政府預算 | `tw.openfun~bulk~budget-central`、`tw.openfun~bulk~budget-local` |
| 政治獻金 | `tw.openfun~bulk~campaign-finance` |
| 行政區代碼/地圖 | `tw.openfun~entity~geo` |
| 立法院議事 | `tw.openfun~api~legislation` |
| 政府採購標案 | `tw.openfun~api~procurement` |
| SEGIS 人口統計 | 先查 `tw.gov.moi.segis~ref~product`，再依 dataset_slugs 找 txn |