Marketplace · Tools
Tools
Utility tool marketplace for TW agents — pure functions, ms-level responses, no external API needed. Call directly with your existing API key, no re-registration.
53 tools available.
TW-specific
ID / Tax ID / ROC year / addresses / districts / phones / postal codes
Address English to Chinese (partial)
twtools-address_en_to_zh英文地址 → 中文（**有限版**：縣市區做 reverse lookup，路名留英文）。
Schema and examples
Address to postal code
twtools-address_to_postal_code從中文地址推 3 碼郵遞區號 + 縣市區（district-precision）。
Schema and examples
Address Chinese to English
twtools-address_zh_to_en中文地址 → 英文標準格式（中華郵政 Hanyu Pinyin 慣例）。
Schema and examples
Align legacy county
twtools-align_legacy_county升格/改制前舊名對齊到現名（高雄縣→高雄市；臺北縣→新北市； 桃園縣→桃園市；台中市→臺中市等）。回傳改制年 + 說明。
Schema and examples
Extract admin code from address
twtools-extract_admin_code_from_addr從中文自由文字地址 regex 抽 縣市/鄉鎮 → admin code (sub-ms).
Schema and examples
Generate test Taiwan ID
twtools-generate_test_taiwan_id產生通過 checksum 的身分證字號（測試 fixture，非真實 PII）。 sex: 'male'|'female'|None；city_letter: A-Z 起始字母；seed: deterministic。
Schema and examples
Generate test tax ID
twtools-generate_test_tax_id產生通過 checksum 的 8 位統一編號（測試 fixture，非真實註冊）。 rule="post-2023" (default mod 5) | "pre-2023" (mod 10)。 seed 可使結果 deterministic。
Schema and examples
Is Taiwan business day
twtools-is_taiwan_business_day判定指定日期是否為台灣公務上班日（含補班/補假規則）。
Schema and examples
List districts in county
twtools-list_districts_in_county列出指定縣市下所有鄉鎮市區（含 town code + 3 碼郵遞區號）。 舊名 → 現名自動對齊（高雄縣 → 高雄市 等）。
Schema and examples
List TGOS geo themes
twtools-list_geo_themes列出 TGOS (data.tgos.tw) 9 個圖資主題.
Schema and examples
Lookup MOI admin code
twtools-lookup_admin_code縣市 [+ 鄉鎮市區] → 內政部 8 碼法定行政區代碼 (sub-ms in-process).
Schema and examples
Lookup administrative district
twtools-lookup_administrative_district三向行政區 lookup：依名稱 / 郵遞區號 / 縣市過濾。 必須至少給 name= 或 postal_code= 一項。
Schema and examples
Lookup bank code
twtools-lookup_bank_code以代號或銀行名稱查詢台灣金融機構代號（涵蓋 ~37 家主要銀行 + 純網銀 + 郵政）。
Schema and examples
Lookup business unit type
twtools-lookup_business_unit_type商業組織類別代碼 → 中文 (Tier A).
Schema and examples
Lookup capital range
twtools-lookup_capital_range資本額區間代碼 → 中文範圍 (Tier A).
Schema and examples
Lookup company branches
twtools-lookup_company_branches以統編查詢公司全部分公司列表（Tier B）。
Schema and examples
Lookup company by tax ID
twtools-lookup_company_by_tax_id以統一編號查詢公司登記資料（經濟部商業司開放 API）。
Schema and examples
Lookup company executives
twtools-lookup_company_executives以統編查詢公司董監事名單（Tier B, data.gcis OData API）。
Schema and examples
Lookup company status code
twtools-lookup_company_status_code公司狀態代碼 → 中文描述 (Tier A).
Schema and examples
Lookup county basic info
twtools-lookup_county_basic_info查詢台灣 22 個直轄市/縣市基本資料（人口/面積/首府/ISO/區碼）。 舊名（高雄縣等）會自動對齊到現名。
Schema and examples
Lookup district code by coord
twtools-lookup_district_by_coord座標 → 行政區代碼 (縣市/鄉鎮市區/村里).
Schema and examples
Lookup government agency code
twtools-lookup_government_agency_code以代碼或機關名稱查詢台灣政府機關（總統府/五院/中央二級+22 縣市政府）。
Schema and examples
Lookup holidays
twtools-lookup_holidays列出指定西元年所有國定假日 + 補班日（內建 2024-2026 資料）。
Schema and examples
Lookup industry code
twtools-lookup_industry_code經濟部商業司「公司行號營業項目代碼」查詢 (Tier A, sub-ms)。
Schema and examples
Lookup MRT line
twtools-lookup_mrt_line以站名（中英文 / 部分匹配）查台灣四大捷運系統路線。
Schema and examples
Lookup statistics unit by coord
twtools-lookup_statistics_by_coord座標 → 統計區 (census / 房價統計區 join key).
Schema and examples
Lookup zip33 by coord
twtools-lookup_zip33_by_coord座標 → 最近門牌 + 6 碼郵遞區號 (Zip33, reverse geocoding).
Schema and examples
Lookup zip33 by road
twtools-lookup_zip33_by_road路名/地區名 → 6 碼郵遞區號清單.
Schema and examples
Normalize Taiwan address
twtools-normalize_taiwan_address正規化台灣地址：全形→半形、巿/区/号 異體字統一、台→臺、簡寫展開、縣→市 升格。
Schema and examples
POI in radius buffer
twtools-query_geo_theme_buffer座標 + theme_id + 半徑(公尺) → 環域內所有 POI list.
Schema and examples
Nearest POI by theme
twtools-query_geo_theme_nearest座標 + theme_id → 最近 1 個 POI (GeoJSON Feature).
Schema and examples
ROC year → Western
twtools-roc_year_to_western民國年 → 西元年。支援 "114"、"114-05-04"、"114年5月4日"、"1140504" 等格式。
Schema and examples
Search company by name
twtools-search_company_by_name以公司名關鍵字 fuzzy 查 → 列出統編候選 (Tier B, 核准設立公司).
Schema and examples
Validate license plate
twtools-validate_license_plate驗證台灣車牌格式並推斷車種。
Schema and examples
Validate phone
twtools-validate_phone驗證台灣電話號碼格式：行動 (09xx) / 市話 (0Xxxx) / 0800 / +886。 含或不含分隔符 (- 空白) 都可。回傳 type 與 area_code。
Schema and examples
Validate postal code
twtools-validate_postal_code驗證 3/5/6 碼郵遞區號 + 對應行政區。
Schema and examples
Validate Taiwan ID
twtools-validate_taiwan_id_number驗證中華民國身分證字號或外國人統一證號 (公開算法 derive，無 PII lookup)。
Schema and examples
Validate tax ID
twtools-validate_tax_id_number驗證 8 位統一編號 checksum。預設 rule='post-2023'（mod 5）， 可改 'pre-2023' 走舊規則 (mod 10)。
Schema and examples
Western → ROC year
twtools-western_year_to_roc西元年 → 民國年。支援 "2025"、"2025-05-04"、"2025年5月4日" 等格式。
Schema and examples
Generic / CJK-shared
Chinese conversion, PDF / web extraction, lunar / solar terms — useful across CJK markets, not just TW
Current time in timezone
twtools-current_time_in取指定 IANA 時區之當下時間（預設 Asia/Taipei）。
Schema and examples
Humanize duration
twtools-duration_humanize秒數 → 人類可讀（中文/英文）。例: 7325 → "2 小時 2 分鐘 5 秒" / "2h 2m 5s"。
Schema and examples
Extract PDF metadata
twtools-extract_pdf_metadata提取 PDF 元資料（不含內文）— 檔案 inventory / 分類前置判斷。
Schema and examples
Extract PDF pages
twtools-extract_pdf_pages提取指定頁碼之 PDF 內文（節省成本，跳過 boilerplate）。
Schema and examples
Extract PDF text
twtools-extract_pdf_text提取 PDF 內文（pymupdf-based, born-digital only）。
Schema and examples
Fetch URL as Markdown
twtools-fetch_url_as_markdown抓取網頁主內容並轉成 Markdown（trafilatura，去 nav/footer/廣告）。
Schema and examples
Format Chinese numerals
twtools-format_chinese_numerals阿拉伯數字 ↔ 國字大寫（公文/合約/支票場景）。 direction='arabic_to_chinese' (預設) 或 'chinese_to_arabic'。
Schema and examples
Lookup 24 solar terms
twtools-lookup_24_solar_terms列出指定西元年 24 節氣對應日期（範圍 1900-2100）。
Schema and examples
Lookup zodiac
twtools-lookup_zodiac西元年 → 生肖（基於農曆春節分界）。嚴謹用途請用 solar_to_lunar(date)。
Schema and examples
Lunar → Solar
twtools-lunar_to_solar農曆 → 國曆。lunar_year 用西元紀年（e.g. 2025 表「農曆 2025 年」）。
Schema and examples
Simplified → Traditional
twtools-simplified_to_traditional簡體中文轉繁體。variant: 'zh-tw'(default, 台灣正體) | 'zh-hk' | 'zh-hant'。
Schema and examples
Solar → Lunar
twtools-solar_to_lunar國曆 (西元) → 農曆。
Schema and examples
Convert timezone
twtools-timezone_convert任意時區之間時間轉換（IANA tz 名稱）。
Schema and examples
Traditional → Simplified
twtools-traditional_to_simplified繁體中文轉簡體 (zh-cn)。
Schema and examples
How to use
Call with your existing API key
Tools are exposed via the Twinkle Hub MCP gateway with the twtools- prefix, alongside opendata-* in the MCP tools/list response. Once your Twinkle Hub client is wired up, they're available automatically.