如何在歐噴資料庫找到需要的資料集

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

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

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

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 資訊），可用輕量版：

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

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

# 列出所有頂層主題
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——它包含欄位說明、查詢範例、注意事項：

# 必須用 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，透過目錄資料集來找：

# 第一步：在 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 使用指引：

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

📄 查看原始 Markdown