twse-mcp
MCP serverDatabases & dataThis integration connects your AI to open data from the Taiwan Stock Exchange. Once added, your AI can look up stock quotes, pull ETF data, and work with 140+ public datasets from the exchange.
Use twse-mcp in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add twse-mcp and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use the dataset.search tool from twse-mcp
No key or account is asked for. Not verified by us yet: Ahel has not run a call through it.
Details
Available today. Use it from your connected AI after setup.
No key or account is asked for. Not verified by us yet: Ahel has not run a call through it.
Add the integration, then ask your AI for a stock quote or ETF data to see it in action. You can also ask it to explore the exchange's public datasets.
What your AI can do with it
- Look up stock quotes from the Taiwan Stock Exchange
- Retrieve ETF data
- Access 140+ public datasets from the exchange
- Answer questions about Taiwanese stocks using official exchange data
Install twse-mcp
The server’s own address, for the clients that take one directly. Or connect Ahel once and every client you use reads it from one address, with the account kept on Ahel rather than in each client’s config.
Claude Code
claude mcp add --transport http --scope user twse-mcp 'https://twse-mcp.taux.io/mcp'Run it once in your project, then open /mcp to approve any sign-in the server asks for.
Claude Desktop
https://twse-mcp.taux.io/mcpAdd a custom connector in Settings, paste this address, and approve the sign-in.
Cursor
cursor://anysphere.cursor-deeplink/mcp/install?name=twse-mcp&config=eyJ1cmwiOiJodHRwczovL3R3c2UtbWNwLnRhdXguaW8vbWNwIn0=Open the link and Cursor adds the server at that address.
ChatGPT
https://twse-mcp.taux.io/mcpIn Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.
Codex
codex mcp add twse-mcp --url 'https://twse-mcp.taux.io/mcp'Run it once, then sign in with codex mcp login twse-mcp if the server asks for an account.
From the project's README
As published by taux-io/twse-mcp in README.md.
English | 繁體中文 | 简体中文 | 日本語 | 한국어
Taiwan Market Open Data (Unofficial)
台股公開資料小幫手(非官方)
非官方服務。 本服務由 taux.io 開發維運,與臺灣證券交易所、臺灣期貨交易所無隸屬關係,也未經其背書;資料僅供參考,不構成投資建議。
用講話的方式,問你的 AI 台股資料。
台積電現在多少?0056 昨天收多少?這檔 ETF 到底在追什麼指數? 以前你得自己開網站查,現在直接問 AI 就好。
不用寫程式、不用安裝軟體。你只要複製一個網址,貼進你的 AI 設定裡,大約一分鐘。
MCP 是什麼? 可以想成幫 AI 裝外掛。AI 本身不會查台股, 裝上這個外掛之後,它就多了這項技能。(MCP 是這種外掛的通用規格, Claude、ChatGPT 等等都支援。)
這是一個個人佛心專案,資料全部來自臺灣證券交易所與臺灣期貨交易所的公開來源。免費使用。
這能幫你做什麼
裝好之後,直接用中文問就可以,例如:
- 「台積電現在多少?」 —— 盤中的即時報價,一次問好幾檔也行。
- 「0050 昨天收盤多少、量多大?」 —— 前一個交易日的開盤、最高、最低、收盤、成交量。
- 「台積電最近營收成長多少?本益比、殖利率呢?」 —— 上市公司的一頁式概況:月營收年增率、本益比、殖利率、近一年每期配多少股利、除權息預告、有沒有被列為處置股。
- 「比較台積電、聯電、聯發科的本益比和殖利率」 —— 一次並排比較 2 到 5 家的價量、本益比、殖利率、股價淨值比與市值。
- 「台積電最近 5 個交易日的收盤價?」 —— 近期每日收盤價量與期間漲跌幅。證交所的公開資料只有最新一天,這些是本服務自 2026-09-29 起每天存下來的;存得還不夠久時會照實說只有幾天。
- 「明天台股有開盤嗎?」 —— 依證交所休市日表回答今天是否開盤、下一個交易日是哪天,休市會寫出假日名稱。
- 「台積電融資最近增加還減少?還能借券賣多少?」 —— 融資融券餘額與增減、使用率、券資比、停止融資融券等註記,以及當日可借券賣出股數(上櫃也查得到借券)。
- 「殖利率 6% 以上、本益比低於 10 的有哪些?」 —— 依交易所公布的數字幫你篩選、排序,不用自己一頁頁翻。
- 「台積電上半年賺多少?毛利率?董監有沒有質押?」 —— 最新一季財報摘要(會自動找對業別的表)與公司治理:董事長兼任總經理、董監質押、裁罰紀錄。
- 「台積電的碳排放多少?中鋼女性董事比例?」 —— ESG 永續資訊:溫室氣體、能源、用水、廢棄物、董事會、員工薪資與福利、資訊安全等 21 個主題(公司申報的年度資料)。
- 「今天大盤怎樣?外資期貨多空部位?」 —— 加權指數、成交金額、成交量排行,以及三大法人期貨未平倉、Put/Call 比、大額交易人部位。
- 「這週有哪些股票除息?最近誰被處置?」 —— 近期事件一次看:兩週內的除權除息與股東會、今天公布的注意股、處置中與即將處置的股票。
- 「0056 這檔 ETF 到底是什麼?」 —— 追蹤哪個指數、多少人在定期定額,還會提醒你哪些數字不能當真。
- 「台指期昨天收在哪?小台、台積電期貨呢?」 —— 單一期貨契約的一頁式概況:各月份的開高低收、結算價、未平倉,加上三大法人與大額交易人部位;說「小台」「微台」「台積電期貨」也聽得懂。選擇權的每日行情也查得到。
- 「證交所有沒有 ⋯⋯ 的資料?」 —— 幫你在兩百多張公開報表裡找到對的那一張。
你不需要記任何指令或代號,講人話就好,AI 會自己去查。
開始使用
以 Claude 為例(網頁版 claude.ai 或桌面版都一樣)。 免費方案就可以用——免費方案能加 1 個外掛,而你正好只需要 1 個。 (依據 Anthropic 官方說明,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 的完整概況。 詳見下面「有些查得到、有些查不到」。
找不到 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 大概會回: 台積電 115 年上半年(累計到第 2 季)營收約 2.40 兆元, 毛利率 67.0%、營業利益率 59.3%,每股盈餘 49.33 元;第 2 季底負債比率 30.9%。 並提醒你:損益表是年初到該季的累計數,不是單季。
(示意)
你問:「遠見的董監有沒有大量質押股票?」
AI 大概會回: 遠見(3040)的董監質押比率約 99.4%,落在「90% 以上」這一級, 資料日期是 115 年 8 月 19 日。董事長沒有兼任總經理,近期也沒有金管會的裁罰紀錄。
(示意)
你問:「昨天大盤怎麼樣?外資期貨是多還是空?」
AI 大概會回: 9/24 加權指數收 48,024.60,跌 132.69 點(-0.28%),成交金額約 7,756 億元; 上市股票 387 家上漲、548 家下跌。期貨方面,外資在台指期的未平倉淨部位是 空單約 7.7 萬口。
(示意)
你問:「證交所有沒有定期定額交易戶數的資料?」
AI 大概會回: 有,證交所有「定期定額交易戶數統計排行月報表」, 我可以幫你查某檔的排名與交易戶數。
一次問多檔也可以,例如:「幫我一次看 0050、0056、台積電的即時報價。」
有些查得到、有些查不到
上市的股票與 ETF(代號多是 4 碼,例如 2330 台積電、0050)——上面說的全部都查得到。
上櫃的股票與 ETF(例如 6488 環球晶、00679B 元大美債20年)——只查得到即時報價那一組數字: 現在的價格、今天的開盤最高最低、昨天的收盤、成交量;另外還有證交所表裡附帶的當日可借券賣出股數。 查不到更早的歷史行情與統計報表,也做不出 ETF 完整概況(追蹤指數、規模那些)。
原因是上櫃的報表資料來源網站,會擋掉從雲端主機來的連線,而這個服務就跑在雲端上。 即時報價走的是另一個沒有擋的來源,所以不受影響——昨收也是跟著即時報價一起來的。 (我們正在找人幫忙解決這件事,見下面「一起來改進」。)
使用前,先知道幾件事
- 這是個人佛心專案。 我盡量讓它一直開著,但可能偶爾限流、臨時維護、或未來換網址——不保證隨時都在。
- 即時報價是「盡量即時」。 它來自證交所的網頁介面,可能有幾秒到幾分鐘延遲、偶爾抓不到,或跟你券商看到的報價略有出入。
- 資料僅供參考,不是投資建議。 數字可能有誤或延遲,下單前請自己再向官方或券商確認,投資盈虧請自行負責。
- 除了即時報價,其他資料最多可能慢一小時。 為了不一直去打證交所,各類報表會快取一小時;盤中價格不快取,永遠是當下抓的。
- 不用登入,不記錄你問的內容。 服務只是代你去取證交所與期交所的公開資料,不保存你的問題與查詢參數。Cloudflare 會保存每個請求的連線紀錄(IP、User-Agent 等)3 天,用於排查問題,詳見隱私權政策。
- 有防濫用的限速。 同一個來源 10 秒內超過 100 次請求,會被暫停 10 秒(HTTP 429)。一般使用遠碰不到這個門檻。
資料來源與授權
臺灣證券交易所 2026 臺灣證券交易所 OpenAPI
金融監督管理委員會證券期貨局 2026 臺灣期貨交易所 OAS
此開放資料依政府資料開放授權條款 (Open Government Data License) 進行公眾釋出,使用者於遵守本條款各項規定之前提下,得利用之。
政府資料開放授權條款:https://data.gov.tw/license
一個例外:盤中即時報價來自證交所基本市況報導站(
mis.twse.com.tw),該站未登錄於政府資料開放平臺,不在上述授權範圍內。
本服務僅為代理與轉換,不對資料正確性負責;引用時請一併標示上述來源。
一起來改進
這是開源專案,歡迎一起把它變好——原始碼在 GitHub。
任何形式的參與都歡迎:用起來覺得怪、查不到你想要的資料、或希望它多會一件事, 都可以直接開一個 issue 說; 會寫程式的話也歡迎直接送 PR。
每一版改了什麼,看更新紀錄。
聯絡信箱(隱私、安全或其他不適合公開的問題):dev@taux.io;隱私權政策見 https://twse-mcp.taux.io/privacy。
目前最需要幫忙的一件事:讓上櫃資料也能查。 上櫃的資料來源(櫃買中心)會封鎖雲端伺服器的連線——我們實測過,從台灣的一般網路連得上, 但從服務所在的雲端就被擋掉,而且不是換個標頭就能繞過的。要解決得有一台在台灣、 能長期運作的機器幫忙轉送。如果你手上剛好有這樣的環境、或知道更好的做法, 非常歡迎來聊聊。
附錄:其他工具怎麼加
以下給習慣用終端機或其他 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。
Tools it offers (9)
What this server listed when Ahel dialed its public endpoint in Sep 2026, with no key and no account of yours. The names are the server’s own.
dataset.searchdataset.describedataset.getsnapshot.etfquote.lookupsnapshot.stocksnapshot.marketsnapshot.futuresquote.realtime
Signals
- Last commit
- Sep 2026
Advanced
- Delivery
- twse-mcp MCP server → your Ahel connector (mcp.ahel.ai) → your AI.
- Item type
- mcp-server
- Key
io-github-taux-io-twse-mcp- Source
- github.com/taux-io/twse-mcp
- Hosted endpoint
https://twse-mcp.taux.io/mcp
More in Databases & data
MCP server
More in Databases & dataAIOProductOS MCP
MCP server · aioproductos
More in Databases & dataQuantRisk
MCP server · 78degrees
More in Databases & dataPostHog MCP Server
MCP server · posthog
More in Databases & dataAppfigures
MCP server · appfigures
More in Databases & dataRun402
MCP server · kychee-com
More in Databases & data