twse-mcp

*[English](README.en.md) ｜ 繁體中文 ｜ [简体中文](README.zh-CN.md) ｜ [日本語](README.ja.md) ｜ [한국어](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-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 昨天收盤多少、量多大？」** —— 前一個交易日的開盤、最高、最低、收盤、成交量。
- **「台積電最近營收成長多少？本益比、殖利率呢？」** —— 上市公司的一頁式概況：月營收年增率、本益比、殖利率、除權息預告、有沒有被列為處置股。
- **「殖利率 6% 以上、本益比低於 10 的有哪些？」** —— 依交易所公布的數字幫你篩選、排序，不用自己一頁頁翻。
- **「台積電上半年賺多少？毛利率？董監有沒有質押？」** —— 最新一季財報摘要（會自動找對業別的表）與公司治理：董事長兼任總經理、董監質押、裁罰紀錄。
- **「今天大盤怎樣？外資期貨多空部位？」** —— 加權指數、成交金額、成交量排行，以及三大法人期貨未平倉、Put/Call 比、大額交易人部位。
- **「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
```

下方的 **Authentication（驗證方式）** 選 **No sign-in**——通常已經自動選好，旁邊會標
「Detected」。底下會出現一個黃色提醒，說沒有登入的話任何人拿到網址都能用；這個服務
本來就是公開的，可以放心略過。**Request headers 不用加**，這個服務沒有 API key。

按 **Add** 就完成了。**不用帳號、不用密碼、不用付費。**

### 第 3 步：在對話裡把它打開

回到聊天畫面，**開一個新對話**，點輸入框旁邊的 **「+」** → **Connectors**，
把剛才加的「台股」打開。

### 確認裝好了沒

問它一句：

> 用台股連接器查一下 0050 現在多少？

如果它回你一個**具體的價格數字**（例如「0050 目前約 97.15 元」），就成功了。
如果它說查不到、或開始上網搜尋，看下一段。

---

## 遇到問題？

**AI 說查不到，或跑去上網搜尋**
最常見的原因是**連接器沒有打開**，或是**設定完沒有開新對話**。
先開一個新對話，點「+」確認「台股」是開著的。
如果還是不行，就明白告訴它：「**用台股連接器查 0056**」——直接點名通常就會用了。

**上櫃股票查不到完整資料**
這不是壞掉，是限制。上櫃的股票（例如 6488 環球晶、00679B 元大美債20年）
查得到**現在的價格、今天的開高低、昨天的收盤、成交量**，
但查不到更早的歷史行情、統計報表，也做不出 ETF 的完整概況。
詳見下面「有些查得到、有些查不到」。

**出現「Unsupported protocol version」**
這個服務只支援新版的 MCP 協定（`2026-07-28`）。把你的 AI 工具更新到最新版再試一次。

**找不到 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 大概會回：** 台積電 8 月營收約 **5,148 億元**，比去年同月成長 **53.3%**，
> 前一交易日本益比 **28.7 倍**、殖利率 **0.89%**。目前沒有被列為注意股或處置股。
>
> *（示意）*

> **你問：**「殖利率 6% 以上、本益比低於 10 的股票有哪些？按殖利率排。」
>
> **AI 大概會回：** 符合條件的有 39 檔，殖利率最高的前五名是……
> 另外有 288 檔因為本益比或殖利率沒有數字（例如虧損公司）無法比較，沒有列入。
>
> *（示意）*

> **你問：**「證交所有沒有定期定額交易戶數的資料？」
>
> **AI 大概會回：** 有，證交所有「定期定額交易戶數統計排行月報表」，
> 我可以幫你查某檔的排名與交易戶數。

一次問多檔也可以，例如：「幫我一次看 0050、0056、台積電的即時報價。」

---

## 有些查得到、有些查不到

**上市**的股票與 ETF（代號多是 4 碼，例如 2330 台積電、0050）——**上面說的全部都查得到**。

**上櫃**的股票與 ETF（例如 6488 環球晶、00679B 元大美債20年）——**只查得到即時報價那一組數字**：
現在的價格、今天的開盤最高最低、**昨天的收盤**、成交量。
查不到更早的歷史行情與統計報表，也做不出 ETF 完整概況（追蹤指數、規模那些）。

原因是上櫃的**報表資料**來源網站，會擋掉從雲端主機來的連線，而這個服務就跑在雲端上。
即時報價走的是另一個沒有擋的來源，所以不受影響——昨收也是跟著即時報價一起來的。
（我們正在找人幫忙解決這件事，見下面「一起來改進」。）

---

## 使用前，先知道幾件事

1. **這是個人佛心專案。** 我盡量讓它一直開著，但可能偶爾限流、臨時維護、或未來換網址——不保證隨時都在。
2. **即時報價是「盡量即時」。** 它來自證交所的網頁介面，可能有幾秒到幾分鐘延遲、偶爾抓不到，或跟你券商看到的報價略有出入。
3. **資料僅供參考，不是投資建議。** 數字可能有誤或延遲，**下單前請自己再向官方或券商確認**，投資盈虧請自行負責。
4. **除了即時報價，其他資料最多可能慢一小時。** 為了不一直去打證交所，各類報表會快取一小時；盤中價格不快取，永遠是當下抓的。
5. **不用登入，也不會知道你查了什麼。** 你查的內容會經過本服務去代理證交所的**公開**資料，服務不記錄你問的問題。

---

## 資料來源與授權

臺灣證券交易所 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 協定 `2026-07-28` 版 |
| 認證 | 不需要 |

各家設定檔的欄位名稱不太一樣，請對應到「Streamable HTTP」那一種，不要選成舊的 SSE。