마켓플레이스 · 도구
도구
TW 에이전트용 유틸리티 도구 마켓플레이스 — 순수 함수, ms 단위 응답, 외부 API 불필요. 기존 API 키로 직접 호출, 재등록 불필요.
53 개의 도구 사용 가능.
TW 전용
ID / 사업자번호 / 민국년 / 주소 / 행정구역 / 전화 / 우편번호
地址英譯中（部分）
twtools-address_en_to_zh英文地址 → 中文（**有限版**：縣市區做 reverse lookup，路名留英文）。
스키마와 예시
地址查郵遞區號
twtools-address_to_postal_code從中文地址推 3 碼郵遞區號 + 縣市區（district-precision）。
스키마와 예시
地址中譯英
twtools-address_zh_to_en中文地址 → 英文標準格式（中華郵政 Hanyu Pinyin 慣例）。
스키마와 예시
舊縣名升格對應
twtools-align_legacy_county升格/改制前舊名對齊到現名（高雄縣→高雄市；臺北縣→新北市； 桃園縣→桃園市；台中市→臺中市等）。回傳改制年 + 說明。
스키마와 예시
地址抽行政區代碼
twtools-extract_admin_code_from_addr從中文自由文字地址 regex 抽 縣市/鄉鎮 → admin code (sub-ms).
스키마와 예시
產測試身分證號
twtools-generate_test_taiwan_id產生通過 checksum 的身分證字號（測試 fixture，非真實 PII）。 sex: 'male'|'female'|None；city_letter: A-Z 起始字母；seed: deterministic。
스키마와 예시
產測試統編
twtools-generate_test_tax_id產生通過 checksum 的 8 位統一編號（測試 fixture，非真實註冊）。 rule="post-2023" (default mod 5) | "pre-2023" (mod 10)。 seed 可使結果 deterministic。
스키마와 예시
是否台灣工作日
twtools-is_taiwan_business_day判定指定日期是否為台灣公務上班日（含補班/補假規則）。
스키마와 예시
列縣市內鄉鎮市區
twtools-list_districts_in_county列出指定縣市下所有鄉鎮市區（含 town code + 3 碼郵遞區號）。 舊名 → 現名自動對齊（高雄縣 → 高雄市 等）。
스키마와 예시
列 TGOS 地理主題
twtools-list_geo_themes列出 TGOS (data.tgos.tw) 9 個圖資主題.
스키마와 예시
行政區代碼查詢
twtools-lookup_admin_code縣市 [+ 鄉鎮市區] → 內政部 8 碼法定行政區代碼 (sub-ms in-process).
스키마와 예시
行政區三向 lookup
twtools-lookup_administrative_district三向行政區 lookup：依名稱 / 郵遞區號 / 縣市過濾。 必須至少給 name= 或 postal_code= 一項。
스키마와 예시
查銀行代碼
twtools-lookup_bank_code以代號或銀行名稱查詢台灣金融機構代號（涵蓋 ~37 家主要銀行 + 純網銀 + 郵政）。
스키마와 예시
商業組織類別查中文
twtools-lookup_business_unit_type商業組織類別代碼 → 中文 (Tier A).
스키마와 예시
資本額區間查中文
twtools-lookup_capital_range資本額區間代碼 → 中文範圍 (Tier A).
스키마와 예시
公司分公司查詢
twtools-lookup_company_branches以統編查詢公司全部分公司列表（Tier B）。
스키마와 예시
統編查公司
twtools-lookup_company_by_tax_id以統一編號查詢公司登記資料（經濟部商業司開放 API）。
스키마와 예시
公司董監事查詢
twtools-lookup_company_executives以統編查詢公司董監事名單（Tier B, data.gcis OData API）。
스키마와 예시
公司狀態代碼查中文
twtools-lookup_company_status_code公司狀態代碼 → 中文描述 (Tier A).
스키마와 예시
查縣市基本資料
twtools-lookup_county_basic_info查詢台灣 22 個直轄市/縣市基本資料（人口/面積/首府/ISO/區碼）。 舊名（高雄縣等）會自動對齊到現名。
스키마와 예시
座標查行政區代碼
twtools-lookup_district_by_coord座標 → 行政區代碼 (縣市/鄉鎮市區/村里).
스키마와 예시
查政府機關代碼
twtools-lookup_government_agency_code以代碼或機關名稱查詢台灣政府機關（總統府/五院/中央二級+22 縣市政府）。
스키마와 예시
查國定假日
twtools-lookup_holidays列出指定西元年所有國定假日 + 補班日（內建 2024-2026 資料）。
스키마와 예시
行業代碼查中文名
twtools-lookup_industry_code經濟部商業司「公司行號營業項目代碼」查詢 (Tier A, sub-ms)。
스키마와 예시
查捷運路線
twtools-lookup_mrt_line以站名（中英文 / 部分匹配）查台灣四大捷運系統路線。
스키마와 예시
座標查統計區
twtools-lookup_statistics_by_coord座標 → 統計區 (census / 房價統計區 join key).
스키마와 예시
座標查門牌郵遞區號
twtools-lookup_zip33_by_coord座標 → 最近門牌 + 6 碼郵遞區號 (Zip33, reverse geocoding).
스키마와 예시
路名查郵遞區號
twtools-lookup_zip33_by_road路名/地區名 → 6 碼郵遞區號清單.
스키마와 예시
正規化台灣地址
twtools-normalize_taiwan_address正規化台灣地址：全形→半形、巿/区/号 異體字統一、台→臺、簡寫展開、縣→市 升格。
스키마와 예시
環域查 POI
twtools-query_geo_theme_buffer座標 + theme_id + 半徑(公尺) → 環域內所有 POI list.
스키마와 예시
座標查最近 POI
twtools-query_geo_theme_nearest座標 + theme_id → 最近 1 個 POI (GeoJSON Feature).
스키마와 예시
民國年 → 西元年
twtools-roc_year_to_western民國年 → 西元年。支援 "114"、"114-05-04"、"114年5月4日"、"1140504" 等格式。
스키마와 예시
公司名 fuzzy 查統編
twtools-search_company_by_name以公司名關鍵字 fuzzy 查 → 列出統編候選 (Tier B, 核准設立公司).
스키마와 예시
驗證車牌
twtools-validate_license_plate驗證台灣車牌格式並推斷車種。
스키마와 예시
驗證電話格式
twtools-validate_phone驗證台灣電話號碼格式：行動 (09xx) / 市話 (0Xxxx) / 0800 / +886。 含或不含分隔符 (- 空白) 都可。回傳 type 與 area_code。
스키마와 예시
驗證郵遞區號
twtools-validate_postal_code驗證 3/5/6 碼郵遞區號 + 對應行政區。
스키마와 예시
驗證身分證字號
twtools-validate_taiwan_id_number驗證中華民國身分證字號或外國人統一證號 (公開算法 derive，無 PII lookup)。
스키마와 예시
驗證統一編號
twtools-validate_tax_id_number驗證 8 位統一編號 checksum。預設 rule='post-2023'（mod 5）， 可改 'pre-2023' 走舊規則 (mod 10)。
스키마와 예시
西元年 → 民國年
twtools-western_year_to_roc西元年 → 民國年。支援 "2025"、"2025-05-04"、"2025年5月4日" 等格式。
스키마와 예시
범용 / CJK 공통
중국어 변환, PDF / 웹 추출, 음력 / 양력 — TW뿐만 아니라 CJK 시장 전반에서 유용
各時區現在時間
twtools-current_time_in取指定 IANA 時區之當下時間（預設 Asia/Taipei）。
스키마와 예시
時間長度人話化
twtools-duration_humanize秒數 → 人類可讀（中文/英文）。例: 7325 → "2 小時 2 分鐘 5 秒" / "2h 2m 5s"。
스키마와 예시
讀 PDF metadata
twtools-extract_pdf_metadata提取 PDF 元資料（不含內文）— 檔案 inventory / 分類前置判斷。
스키마와 예시
抽 PDF 指定頁
twtools-extract_pdf_pages提取指定頁碼之 PDF 內文（節省成本，跳過 boilerplate）。
스키마와 예시
抽 PDF 內文
twtools-extract_pdf_text提取 PDF 內文（pymupdf-based, born-digital only）。
스키마와 예시
抓網頁為 Markdown
twtools-fetch_url_as_markdown抓取網頁主內容並轉成 Markdown（trafilatura，去 nav/footer/廣告）。
스키마와 예시
阿拉伯 ↔ 國字大寫
twtools-format_chinese_numerals阿拉伯數字 ↔ 國字大寫（公文/合約/支票場景）。 direction='arabic_to_chinese' (預設) 或 'chinese_to_arabic'。
스키마와 예시
二十四節氣查詢
twtools-lookup_24_solar_terms列出指定西元年 24 節氣對應日期（範圍 1900-2100）。
스키마와 예시
查生肖
twtools-lookup_zodiac西元年 → 生肖（基於農曆春節分界）。嚴謹用途請用 solar_to_lunar(date)。
스키마와 예시
農曆 → 國曆
twtools-lunar_to_solar農曆 → 國曆。lunar_year 用西元紀年（e.g. 2025 表「農曆 2025 年」）。
스키마와 예시
簡體 → 繁體
twtools-simplified_to_traditional簡體中文轉繁體。variant: 'zh-tw'(default, 台灣正體) | 'zh-hk' | 'zh-hant'。
스키마와 예시
國曆 → 農曆
twtools-solar_to_lunar國曆 (西元) → 農曆。
스키마와 예시
時區轉換
twtools-timezone_convert任意時區之間時間轉換（IANA tz 名稱）。
스키마와 예시
繁體 → 簡體
twtools-traditional_to_simplified繁體中文轉簡體 (zh-cn)。
스키마와 예시
사용 방법
기존 API 키로 호출
도구는 Twinkle Hub MCP 게이트웨이를 통해 twtools- 접두사로 노출되며, MCP tools/list 응답에서 opendata-*와 함께 표시됩니다. Twinkle Hub 클라이언트가 설정되어 있으면 자동으로 사용 가능.