# TWSE Open Data (Taiwan Stock Exchange) [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/taux-io/twse-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/twse-open-data-taiwan-stock-exchange

## Description
Taiwan Stock Exchange (TWSE) open data as MCP tools: stock quotes, ETF data, 140+ public datasets.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "twse-open-data-taiwan-stock-exchange": {
    "command": "npx",
    "args": ["-y","twse-open-data-taiwan-stock-exchange"]
  }
}
```

## Documentation & README

*[English](https://github.com/taux-io/twse-mcp/blob/HEAD/README.en.md) ｜ 繁體中文 ｜ [简体中文](https://github.com/taux-io/twse-mcp/blob/HEAD/README.zh-CN.md) ｜ [日本語](https://github.com/taux-io/twse-mcp/blob/HEAD/README.ja.md) ｜ [한국어](https://github.com/taux-io/twse-mcp/blob/HEAD/README.ko.md)*

[![tests](https://github.com/taux-io/twse-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/taux-io/twse-mcp/actions/workflows/test.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6?logo=typescript&logoColor=white)](package.json)
[![Cloudflare Workers](https://img.shields.io/badge/Cloudflare-Workers-F38020?logo=cloudflare&logoColor=white)](wrangler.jsonc)
[![MCP](https://img.shields.io/badge/MCP-2026--07--28%20%2B%202025-blueviolet)](docs/adr/0001-dual-era-and-cache-scope.md)
[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.taux--io%2Ftwse--mcp-blueviolet)](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。