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