0yukali0/taipei-open-data-list

輸入參數

| 參數 | 必填 | 說明 | |------|------|------| | urls | 否 | JSON 格式的城市→API URL 對照表；不填則同時查詢台北市與新北市 |

Taipei Open Data List Skill

當使用者要查詢台北市或新北市開放資料集時，依需求選擇以下功能執行。

---

查詢資料集清單（describe_wf）

步驟 1 — 確認輸入

從使用者的描述中判斷要查詢哪個城市：

• 不指定：查詢兩市（使用預設值，不需傳 --urls）
• 僅台北市：--urls '{"taipei": "https://data.taipei/api/frontstage/tpeod/dataset.download?format=json"}'
• 僅新北市：--urls '{"new-taipei": "https://data.ntpc.gov.tw/api/datasets/info/json"}'

步驟 2 — 執行指令

在 plugins/taipei-open-data-list/commands 目錄下執行：

cd plugins/taipei-open-data-list/commands
UV_PROJECT_ENVIRONMENT=/tmp/.taipei-open-data-list-venv uv sync --locked && source /tmp/.taipei-open-data-list-venv/bin/activate

查詢全部（兩市）：

flyte run --local wf.py describe_wf

僅查詢台北市：

flyte run --local wf.py describe_wf --urls '{"taipei": "https://data.taipei/api/frontstage/tpeod/dataset.download?format=json"}'

僅查詢新北市：

flyte run --local wf.py describe_wf --urls '{"new-taipei": "https://data.ntpc.gov.tw/api/datasets/info/json"}'

步驟 3 — 回報結果

告知使用者查詢到的資料集清單，說明各城市的資料集總數。

---

取得資料集下載連結（links_wf）

回傳所有資料集的下載連結，格式為 {資料集名稱: url}。

cd plugins/taipei-open-data-list/commands
UV_PROJECT_ENVIRONMENT=/tmp/.taipei-open-data-list-venv uv sync --locked && source /tmp/.taipei-open-data-list-venv/bin/activate && flyte run --local wf.py links_wf

僅查台北市：

flyte run --local wf.py links_wf --urls '{"taipei": "https://data.taipei/api/frontstage/tpeod/dataset.download?format=json"}'

僅查新北市：

flyte run --local wf.py links_wf --urls '{"new-taipei": "https://data.ntpc.gov.tw/api/datasets/info/json"}'

連結格式：

• 台北市：https://data.taipei/<資料存取網址>（若已是完整 URL 則直接使用）
• 新北市：https://data.ntpc.gov.tw/api/datasets/<識別碼>/<提供格式>

---

依關鍵字查詢資料集連結（keyword_links_wf）

輸入關鍵字，回傳名稱包含該關鍵字的資料集連結，格式為 {資料集名稱: url}。關鍵字比對不區分大小寫。

| 參數 | 必填 | 說明 | |------|------|------| | urls | 否 | 城市→API URL 對照表；不填則查詢兩市 | | keyword | 是 | 過濾用關鍵字（比對資料集名稱） |

查詢含特定關鍵字的資料集：

flyte run --local wf.py keyword_links_wf --keyword '交通'

限定城市查詢：

flyte run --local wf.py keyword_links_wf --urls '{"taipei": "https://data.taipei/api/frontstage/tpeod/dataset.download?format=json"}' --keyword '空氣品質'