Taiwan Government Dataset Search
Purpose and entry point
Use the user's existing Codex in-app browser tab on https://data.gov.tw/. If it is not already on the site, navigate the same in-app tab to the homepage and verify the page heading before continuing. Use the current UI as the source of truth; do not replace this workflow with API calls, scraping, or an external browser.
Procedure
- Choose the entry point from the request: homepage search,
/datasets/search, a homepage service category,/datasets/search?type=pop,/datasets/search?dt=openapi, or a provider link. - For keyword discovery, fill
請輸入關鍵字, wait for autocomplete, and either select the exact intended suggestion or click搜尋. Verify資料集列表 | Datasets, the encodedrftquery, and visible result cards. - For structured discovery, open
進階搜尋; fill dataset ID, provider, child-agency inclusion, and repeatable AND/OR field rows. Use新增for another condition, submit with the advanced搜尋, and verify the resulting state. Use清空when resetting only the advanced form. - Open
展開過濾條件for agency, topic, service category, file format, data-provision property, and keyword facets. Apply the smallest relevant safe filter and verify the result state; facet counts are dynamic. - Use
選擇排序and選擇一頁幾個項目when ranking or pagination matters. Verify the selected label and URL query (s,size,p) before reading results. - For every candidate, capture title, provider, description, major field notes, current metadata update time, provision property, formats, and the
/dataset/<nid>link. Hand off detail/resource questions to$tw-gov-data-dataset. - Trigger
搜尋結果匯出only when the user requested a downloadable inventory. Treat the browser download UI and the downloaded artifact as the evidence; do not claim an export from a button label alone.
Verification and freshness
- Re-fetch the search for every live request. Never reuse current result counts, rankings, usage counters, or update timestamps from this skill.
- Verify at least the current URL/query, heading or control state, and one result card after search, filter, sort, or pagination.
- If a control does not change the visible state, inspect the page before retrying and report the control as unconfirmed rather than looping.
Safety and limits
- Keep exploration read-only and reversible. Do not submit comments, login, register on external API platforms, create API keys, or enter secrets.
- A format label such as CSV or JSON is metadata, not proof that the external resource is reachable or that its rows are valid.
- Do not write dynamic facet counts, result lists, rankings, URLs with live tokens, or one-off search results into instructions.
Drift maintenance
- Compare the current visible UI, route, labels, controls, permissions, and first-party explanations with this procedure before acting.
- If a stable search control or query encoding changes, record the public/authenticated variant, page type, old and observed behavior, evidence source, and date; update this skill or its reference only when the change is clear.
- Re-run a safe keyword search and
quick_validate.pyafter editing. Keep ambiguous or broad changes as a maintenance gap.
References
- search-controls.md — query paths, advanced fields, facets, sorting, pagination, and safe export boundaries.
- site-map.md — confirmed first-party routes and exploration limits.