v1.5.0

新功能

TAIFEX 歷史資料工具（新增 2 個）

openapi.taifex.com.tw完全沒有歷史查詢功能——實測全部 135 個端點，每一個都只回傳最新一個交易日。這 2 個新工具改為抓取期交所自己網站的下載頁面（www.taifex.com.tw），該頁面真的支援任意歷史日期區間：

Tool	說明
get_futures_daily_history	期貨每日OHLC歷史行情 — 依契約/到期月份/交易時段，可查任意區間（單次最長約1個月），實測回溯至少至 2020 年
get_institutional_traders_by_futures_history	三大法人期貨部位歷史 — 自營商/投信/外資每日多空口數與未平倉，單次最長 92 天，資料保存約至 2023 下半年

注意：這兩個工具使用的契約代碼與既有 openapi 版工具不同（例如臺股期貨在此為 TX，另一組系統為 TXF）——已在各工具的 docstring 中明確標註，避免混用。

新增 4 個 Prompt 範本

原有 5 個 prompt 完全沒有涵蓋到部分工具類別——最明顯的是 16 個 TAIFEX 期貨/選擇權工具，先前零 prompt 引導。

• taifex_derivatives — put/call ratio、大額交易人未平倉、三大法人期貨/選擇權部位、選擇權 delta/未平倉增減
• institutional_flow — 上市/上櫃三大法人買賣超（依大盤或個股）、外資產業持股
• company_fundamental_healthcheck — 獲利能力、成長性、財務結構、配息政策、公司治理一次到位
• pre_trade_risk_scan — 買進前比對處置股、注意股、當沖限制、停資停券等名單

原有 5 個 prompt 也全數改寫為繁體中文，並加入明確的防幻覺規範——舊版把真實工具用法與「範例輸出」混在一起，範例中出現的具體數字（例如寫死「台積電：外資持股78%」）容易被 LLM 直接照抄，而非真的呼叫工具查詢。

效能

• TWSEAPIClient.fetch_data() 現在會將 OpenAPI 清單類回應做記憶體快取（TTL 60秒，可用 TWSE_CACHE_TTL 調整，設 0 停用）。單一 prompt 串接多個公司查詢工具時，不會再對同一份完整公司清單重複下載。
• 新增 TWSEAPIClient.fetch_bytes() 並支援 POST，供 TAIFEX 歷史工具下載 Big5 編碼 CSV 使用。

文件

• 移除 CLAUDE.md 中過時的 @handle_empty_response decorator 引用（該 decorator 已在先前重構中從程式碼移除）。
• README 恢復線上 remote MCP 選項，並加註使用限制與 Prefect Horizon 致謝（因應 Horizon 免費方案調整定價）。
• README／CLAUDE.md 同步更新以上內容（資料來源表格、tool/prompt 數量）。