TWSE Open Data (Taiwan Stock Exchange)
Taiwan Stock Exchange (TWSE) open data as MCP tools: stock quotes, ETF data, 140+ public datasets.
Open source Repository Open in the app JSON README (API)
About
Taiwan Stock Exchange (TWSE) open data as MCP tools: stock quotes, ETF data, 140+ public datasets.
Details
- Kind
- MCP servers
- Topic
- Government & public data
- Publisher
- taux-io
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.3.0
- Open pull requests
- 1
- Last push
- 2026-09-07T06:10:38Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:01:30
- Updated
- 2026-08-29 04:01:30
- Origin id
io.github.taux-io/twse-mcp
README
*[English](README.en.md) ｜ 繁體中文 ｜ [简体中文](README.zh-CN.md) ｜ [日本語](README.ja.md) ｜ [한국어](README.ko.md)* [](https://github.com/taux-io/twse-mcp/actions/workflows/test.yml) [](LICENSE) [](package.json) [](wrangler.jsonc) [](docs/adr/0001-dual-era-and-cache-scope.md) [](https://registry.modelcontextprotocol.io/v0.1/servers?search=twse) # 台股資料小幫手（TWSE MCP） **用講話的方式，問你的 AI 台股資料。** 台積電現在多少？0056 昨天收多少？這檔 ETF 到底在追什麼指數？ 以前你得自己開網站查，現在直接問 AI 就好。 不用寫程式、不用安裝軟體。**你只要複製一個網址，貼進你的 AI 設定裡**，大約一分鐘。 > **MCP 是什麼？** 可以想成**幫 AI 裝外掛**。AI 本身不會查台股， > 裝上這個外掛之後，它就多了這項技能。（MCP 是這種外掛的通用規格， > Claude、ChatGPT 等等都支援。） > 這是一個**個人佛心專案**，資料全部來自臺灣證券交易所與臺灣期貨交易所的公開來源。免費使用。 --- ## 這能幫你做什麼 裝好之後，直接用中文問就可以，例如： - **「台積電現在多少？」** —— 盤中的即時報價，一次問好幾檔也行。 - **「0050 昨天收盤多少、量多大？」** —— 前一個交易日的開盤、最高、最低、收盤、成交量。 - **「0056 這檔 ETF 到底是什麼？」** —— 追蹤哪個指數、多少人在定期定額，還會提醒你哪些數字不能當真。 - **「台指期昨天收在哪？」** —— 期貨與選擇權的每日行情、三大法人、未平倉，交易所公布的都查得到。 - **「證交所有沒有 ⋯⋯ 的資料？」** —— 幫你在兩百多張公開報表裡找到對的那一張。 你不需要記任何指令或代號，**講人話就好**，AI 會自己去查。 --- ## 開始使用 以 **Claude** 為例（網頁版 claude.ai 或桌面版都一樣）。 **免費方案就可以用**——免費方案能加 1 個外掛，而你正好只需要 1 個。 （依據 [Anthropic 官方說明](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)，2026 年 8 月查證；方案規則可能變動。） ### 第 1 步：打開設定裡的「Connectors」 在畫面**左下角你的名字**上點一下 → 選 **Settings（設定）** → 在左側選單找到 **Connectors（連接器）**。 ### 第 2 步：把網址貼進去 按 **「+ Add custom connector（新增自訂連接器）」**，會跳出一個小視窗要你填兩格。 **名稱（Name）** 隨你取，例如 `台股`。 **網址（URL）** 貼下面這一行——把游標移到框上，右上角會出現複製按鈕： ``` https://twse-mcp.taux.io/mcp ``` 按 **Add** 就完成了。**不用帳號、不用密碼、不用付費。** ### 第 3 步：在對話裡把它打開 回到聊天畫面，**開一個新對話**，點輸入框旁邊的 **「+」** → **Connectors**， 把剛才加的「台股」打開。 ### 確認裝好了沒 問它一句： > 用台股連接器查一下 0050 現在多少？ 如果它回你一個**具體的價格數字**（例如「0050 目前約 97.15 元」），就成功了。 如果它說查不到、或開始上網搜尋，看下一段。 --- ## 遇到問題？ **AI 說查不到，或跑去上網搜尋** 最常見的原因是**連接器沒有打開**，或是**設定完沒有開新對話**。 先開一個新對話，點「+」確認「台股」是開著的。 如果還是不行，就明白告訴它：「**用台股連接器查 0056**」——直接點名通常就會用了。 **上櫃股票查不到完整資料** 這不是壞掉，是限制。上櫃的股票（例如 6488 環球晶、00679B 元大美債20年） 查得到**現在的價格、今天的開高低、昨天的收盤、成交量**， 但查不到更早的歷史行情、統計報表，也做不出 ETF 的完整概況。 詳見下面「有些查得到、有些查不到」。 **找不到 Connectors 這個設定** 如果你用的是**公司或團隊的帳號**，通常要管理員先加，成員才能開啟。 個人帳號（含免費方案）則是自己就能加。 --- ## 三個現成的快捷入口 除了直接講人話問，這個服務也內建三個快捷指令，會**跟著連接器自動出現**——不用另外裝東西。 | 指令 | 做什麼 | 帶什麼 | |---|---|---| | `find_dataset` | 不知道該查哪張表時，用關鍵字找出對的那一個 | 關鍵字，例如「三大法人」 | | `etf_overview` | 一次看完一檔上市 ETF 的基本資料、前一交易日價量與定期定額熱度 | ETF 代號，例如 `0056` | | `futures_quote` | 查期貨或選擇權的每日行情 | 契約代號或商品名，例如 `TX` | 在 **Claude Desktop**：點輸入框旁的 **「+」**，在選單裡找到它們。 在 **Claude Code**：輸入 `/` 就會列出來，格式是 `/mcp__twse__find_dataset`。 不用也沒關係——它們只是把常見的問法先寫好，直接用中文問一樣有效。 --- ## 可以這樣問（範例） > **你問：**「0056 現在多少？」 > > **AI 大概會回：** 0056（元大高股息）目前約 **48.19 元**，比昨天收盤（50.00）跌約 **3.6%**， > 今天在 48.14～49.26 之間。 > > *（數字示意，實際以你查詢當下為準）* > **你問：**「0050 昨天收盤多少、成交量多大？」 > > **AI 大概會回：** 0050（元大台灣50）前一交易日收 **97.15 元**， > 全日成交約 **4.0 萬張**，開 98.35、最高 98.35、最低 96.90。 > > *（示意）* > **你問：**「幫我看 0056 這檔 ETF 的完整概況。」 > > **AI 大概會回：** 0056 是追蹤「臺灣高股息指數」的 ETF， > 定期定額很熱門（排在前段班），市值**粗估**約 **7,100 億元**—— > 並提醒你：這個粗估是用收盤價 ×發行單位數算的，**不等於基金實際規模**。 > > *（示意）* > **你問：**「證交所有沒有定期定額交易戶數的資料？」 > > **AI 大概會回：** 有，證交所有「定期定額交易戶數統計排行月報表」， > 我可以幫你查某檔的排名與交易戶數。 一次問多檔也可以，例如：「幫我一次看 0050、0056、台積電的即時報價。」 --- ## 有些查得到、有些查不到 **上市**的股票與 ETF（代號多是 4 碼，例如 2330 台積電、0050）——**上面說的全部都查得到**。 **上櫃**的股票與 ETF（例如 6488 環球晶、00679B 元大美債20年）——**只查得到即時報價那一組數字**： 現在的價格、今天的開盤最高最低、**昨天的收盤**、成交量。 查不到更早的歷史行情與統計報表，也做不出 ETF 完整概況（追蹤指數、規模那些）。 原因是上櫃的**報表資料**來源網站，會擋掉從雲端主機來的連線，而這個服務就跑在雲端上。 即時報價走的是另一個沒有擋的來源，所以不受影響——昨收也是跟著即時報價一起來的。 （我們正在找人幫忙解決這件事，見下面「一起來改進」。） --- ## 使用前，先知道幾件事 1. **這是個人佛心專案。** 我盡量讓它一直開著，但可能偶爾限流、臨時維護、或未來換網址——不保證隨時都在。 2. **即時報價是「盡量即時」。** 它來自證交所的網頁介面，可能有幾秒到幾分鐘延遲、偶爾抓不到，或跟你券商看到的報價略有出入。 3. **資料僅供參考，不是投資建議。** 數字可能有誤或延遲，**下單前請自己再向官方或券商確認**，投資盈虧請自行負責。 4. **除了即時報價，其他資料最多可能慢一小時。** 為了不一直去打證交所，各類報表會快取一小時；盤中價格不快取，永遠是當下抓的。 5. **不用登入，也不會知道你查了什麼。** 你查的內容會經過本服務去代理證交所的**公開**資料。目前為了統計還有多少人用舊版連線方式，會記錄你的 AI 工具種類與連線協定版本——**不含你問的問題**，統計完就會移除。 --- ## 資料來源與授權 臺灣證券交易所 2026 臺灣證券交易所 OpenAPI 金融監督管理委員會證券期貨局 2026 臺灣期貨交易所 OAS 此開放資料依政府資料開放授權條款 (Open Government Data License) 進行公眾釋出，使用者於遵守本條款各項規定之前提下，得利用之。 政府資料開放授權條款：<https://data.gov.tw/license> > **一個例外**：盤中即時報價來自證交所基本市況報導站（`mis.twse.com.tw`），該站未登錄於政府資料開放平臺，不在上述授權範圍內。 本服務僅為代理與轉換，不對資料正確性負責；引用時請一併標示上述來源。 --- ## 一起來改進 這是開源專案，歡迎一起把它變好——原始碼在 [GitHub](https://github.com/taux-io/twse-mcp)。 任何形式的參與都歡迎：用起來覺得怪、查不到你想要的資料、或希望它多會一件事， 都可以直接[開一個 issue](https://github.com/taux-io/twse-mcp/issues) 說； 會寫程式的話也歡迎直接送 PR。 **目前最需要幫忙的一件事：讓上櫃資料也能查。** 上櫃的資料來源（櫃買中心）會封鎖雲端伺服器的連線——我們實測過，從台灣的一般網路連得上， 但從服務所在的雲端就被擋掉，而且不是換個標頭就能繞過的。要解決得有一台在台灣、 能長期運作的機器幫忙轉送。如果你手上剛好有這樣的環境、或知道更好的做法， 非常歡迎來聊聊。 --- ## 附錄：其他工具怎麼加 *以下給習慣用終端機或其他 AI 工具的人，一般使用者可以略過。* **Claude Code** ``` claude mcp add twse --transport http https://twse-mcp.taux.io/mcp ``` **Codex（OpenAI）** ``` codex mcp add twse --url https://twse-mcp.taux.io/mcp ``` **其他支援遠端 MCP 的工具**，把這組連線資訊填進它的設定： | 項目 | 值 | |---|---| | 網址 | `https://twse-mcp.taux.io/mcp` | | 連線方式 | Streamable HTTP（遠端 MCP），新舊版 MCP 協定都支援 | | 認證 | 不需要 | 各家設定檔的欄位名稱不太一樣，請對應到「Streamable HTTP」那一種，不要選成舊的 SSE。