twse-mcp

Taiwan Stock Exchange and Taiwan Futures Exchange open data: stock and ETF snapshots (financials, dividends, margin trading), futures contract snapshots, market overview with an events calendar, live quotes, and search across 275 datasets. No sign-in required.

该来源不提供完整文件导出（国内平台多为平台内托管），仅存元数据与原链

接入信息

传输形态: http
鉴权方式: 鉴权未知
端点: https://twse-mcp.run.tools

鉴权方式未标注，请核对官方文档后再接入——不要直接使用以下片段

{
  "mcpServers": {
    "twse-mcp": {
      "url": "https://twse-mcp.run.tools"
    }
  }
}

能力清单

工具	说明
twse_search_datasets	搜尋臺灣證交所與期交所 OpenAPI 有哪些資料集可用。取資料前先用這個找 dataset_id。範圍比股票廣：還有公司治理、ESG、財報、權證、券商、期貨與選擇權，以及期交所的每日外幣參考匯率——覺得「交易所大概沒有這種資料」時，先搜再下結論。會比對資料集代號、中文說明與欄位名稱；多個關鍵字用空白分隔（每個都要命中），結果依相關度排序。期交所的資料集代號一律以 taifex/ 開頭，搜期貨與選擇權可用 tag="期貨與選擇權"。
twse_describe_dataset	查看某個資料集的定義：代號、來源（證交所或期交所）、中文說明、分類標籤，以及每個欄位的鍵名與中文說明。twse_get_dataset 的 where、sort_by、fields、match 都要用這裡的鍵名（例如 PEratio），不是中文說明。只讀本機目錄、不抓上游，所以不含資料筆數或最新日期。代號不存在時回 error，請先用 twse_search_datasets 找。
twse_get_dataset	取得證交所或期交所資料集內容，支援伺服器端過濾、欄位投影與分頁。上游每個資料集都是整份回傳（可能上萬筆），這支工具預設只回前 30 筆（上限 200）；用 code/match/where/fields 縮小到需要的範圍。排名與篩選（殖利率最高的前 20 檔、本益比低於 10 的股票）用 where + sort_by，不要自己翻頁比大小。
twse_etf_snapshot	一次取得單一上市 ETF 的完整概況：基本資料 + 前一交易日價量 + 定期定額熱度。價量為前一交易日，不是盤中即時；要當下價格請用 twse_realtime_quote。合併三個證交所資料集並行查詢。任何一段查不到都會標成 null 並記在 caveats，不會整個失敗。
twse_lookup	用名稱或代號找上市公司與上市基金（含 ETF）的代號。使用者只講名稱（「台積電」「元大高股息」）時先用這個取得代號，不要憑印象猜代號。比對公司簡稱、全名、英文簡稱與代號，不分全半形與台／臺。只收上市標的；上櫃公司的名稱對照取不到。
twse_stock_snapshot	一次取得單一上市公司的完整概況：基本資料、前一交易日價量、本益比／殖利率／股價淨值比、最新月營收（含月增率與年增率）、近一年各期股利與近期除權除息預告、是否為注意股或處置股，以及市值。合併八個證交所資料集。價量為前一交易日，不是盤中即時；要當下價格請用 twse_realtime_quote。要財報（損益、資產負債、毛利率等，會自動找對業別的表）帶 include_financials；要公司治理（董事長兼任總經理、董監質押、裁罰、董監持股不足）帶 include_governance。要融資融券餘額、券資比與可借券賣出股數帶 include_margin。要 ESG 帶 esg_topics（主題名稱陣列，最多 6 個）；只說「ESG」時用溫室氣體排放、能源管理、董事會、人力發展。ETF 請用 twse_etf_snapshot。任何一段查不到都會標成 null 並記在 caveats，不會整個失敗。
twse_market_overview	一次看完整體市場（前一交易日）：加權指數與漲跌、成交金額、上市股票漲跌家數、成交量前十名；以及期貨籌碼：三大法人期貨未平倉淨部位、台指期各法人部位、Put/Call 比、台指期大額交易人淨部位。只要其中一邊時用 scope="stock" 或 "futures"。scope="events" 另外列出全市場的近期事件：兩週內的除權除息與股東會、今天公布的注意股、處置中與即將處置的股票（皆為上市）；只問某一檔股票的除息、注意或處置狀態時，用 twse_stock_snapshot。不含個別契約的行情價格；要查台指期、小台、個股期貨等單一期貨契約的收盤價與部位，用 twse_futures_snapshot。
twse_futures_snapshot	一個期貨契約（最新一個交易日）的完整概況：各月份的開高低收、漲跌、成交量、結算價、未平倉（一般與盤後時段）、近月摘要、三大法人部位（指數類期貨）、大額交易人部位與最後結算價。可用代號（"TX"、"MTX"、"TMF"、"CDF"）或名稱（"台指期"、"小台"、"台積電期貨"）；名稱對到多個契約時只回 candidates，請向使用者確認再用代號重查。只含期貨；選擇權與整體期貨籌碼請用 twse_search_datasets 或 twse_market_overview。
twse_realtime_quote	取得盤中即時報價（約 5 秒更新一次），每筆帶 date（報價所屬交易日）。OpenAPI 只有前一交易日資料，要當下的價格得走基本市況報導站。ETF 與上市股票用 market="tse"，上櫃用 "otc"。

纠错与举报（发现条目失效、署名有误或涉及侵权？）

提交举报 / 纠错

侵权举报经核验成立后，我们会即时下线该条目并删除已存的内容副本。