How do I install TWSE?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does TWSE need an API key?

No required environment variable is listed on this record.

When was TWSE last checked?

Last checked 2026-10-26. 台灣證交所OpenAPI 的 MCP Server 同時整合部分即時報價和櫃檯買賣中心TPEx OpenAPI, 臺灣期貨交易所TAIFEX OpenAPI

TWSE MCP sunucusu

Power your agent

Bu sunucuyu ekle

Install from the publisher. Not a PlugMCP endpoint.

PlugMCP’de çalıştır

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

PlugMCP’de çalıştır

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Başlat

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-10-26

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

🚀 TWStockMCPServer

一個全面的模型上下文協議 (MCP) 伺服器，專為台灣證券交易所 (TWSE) 數據分析設計，提供即時股票資訊、財務報表、ESG 數據和趨勢分析功能。

🌏 語言版本

English | 繁體中文

🎬 示範影片

VSCode Copilot demo

Gemini CLI demo

觀看 TWStockMCPServer 功能展示

✨ 五大投資分析情境

📊 個股趨勢研判

短中長期技術面、基本面、籌碼面綜合分析

"分析台積電(2330)最近的走勢" / "鴻海(2317)適合長期投資嗎？"

💰 外資投資解讀

外資持股、產業流向、個股進出追蹤

"外資最近在買什麼股票？" / "半導體業外資投資趨勢如何？"

🔥 市場熱點捕捉

重大訊息、異常成交、權證活躍度監控

"今天有什麼重大消息？" / "哪些股票交易量異常活躍？"

💎 股利投資規劃

高殖利率篩選、除權息行事曆、配息穩定性分析

"推薦一些高殖利率股票" / "下個月有哪些公司要除權息？"

🎯 投資標的篩選

價值股/成長股篩選、ESG風險評估

"幫我找一些被低估的價值股" / "ESG表現好的公司有哪些？"

🧮 進階功能

期貨籌碼與選擇權分析

Put/Call Ratio、大額交易人未沖銷部位、三大法人期貨/選擇權部位

"台指期籌碼現在偏多還是偏空？" / "選擇權大額交易人在哪個價位布局？"

三大法人籌碼流向

上市/上櫃三大法人買賣超、外資產業配置

"三大法人今天買超哪些股票？" / "外資在哪個產業加碼？"

個股財報體檢

獲利能力、成長性、財務結構、配息政策、公司治理五面向分析

"幫我做台積電的財報體檢" / "這家公司的財務體質健不健康？"

買前風險掃描

處置股、注意股、當沖限制、停資停券名單比對

"這檔股票買進前有沒有被列處置或注意？"

期貨/三大法人歷史回溯查詢

openapi.taifex.com.tw 僅提供最新一個交易日，本專案改用期交所網站下載頁面（www.taifex.com.tw）：預設查最新交易日，也可回溯查詢期貨/選擇權每日行情、三大法人部位、大額交易人部位；股票代號可直接查對應的股票期貨；最近 30 個交易日的期貨盤中走勢（由每筆成交彙總成分鐘 K 線，含夜盤）

"幫我拉台指期最近一個月的每日OHLC" / "外資期貨部位過去三個月怎麼變化？" / "上週五台指期盤中是怎麼走的？"

財報／營收／股利多期歷史

財報、月營收、股利改由公開資訊觀測站（MOPS）提供（上市、上櫃、興櫃、公發公司皆可）：預設最新一期，也可查任意過去季度的綜合損益表、資產負債表、現金流量表，多個月份的月營收，多年度股利分派，以及法說會行事曆；另有重大訊息全文、董監持股與設質、內部人每月持股異動、庫藏股買回、背書保證與資金貸與

"比較台積電過去四季的毛利率和自由現金流" / "鴻海近五年配息穩定嗎？" / "這個月有哪些公司開法說會？" / "最近有哪些公司在買庫藏股？"

籌碼集中度與上櫃歷史

集保戶股權分散表（千張大戶、散戶持股比例，可看最近 13 週的逐週趨勢），上櫃個股日K、三大法人、融資融券可回溯任意過去日期；上市當沖統計、除權息結果、類股指數歷史

"環球晶的大戶持股比例是多少？" / "半導體類指數上個月表現如何？"

ETF

所有投信、上市與上櫃（含債券 ETF、主動式 ETF）：基本資料（經理公司、追蹤指數、配息頻率、經理人、上櫃 ETF 管理費）、每日已發行單位數增減與預估淨值／折溢價排行、每月規模／受益人數／申購買回／定期定額趨勢（2007 年起），以及成分股：每月前十大持股（2021-08 起）與每季占淨值 1% 以上的持股（2021-09 起）

"0050 現在溢價多少？" / "哪些 ETF 今天被大量買回？" / "00981A 這半年受益人數怎麼變化？" / "00878 前十大持股是哪些？"

總體經濟

國發會景氣對策信號（景氣燈號）與領先/同時/落後指標、臺灣 PMI/NMI、中央銀行每日匯率

"現在景氣燈號是什麼顏色？" / "新台幣最近一個月升還是貶？"

⚙️ 快速開始

🚀 線上使用（由 Prefect Horizon 提供支援）

本專案由 Prefect Horizon 提供支援，免費託管線上 remote MCP Server：

{
  "twstockmcpserver": {
    "transport": "streamable_http",
    "url": "https://TW-Stock-MCP-Server.fastmcp.app/mcp"
  }
}

⚠️ 使用限制：為維持服務永續，此線上服務設有合理使用量上限（非無限制）。若需商業使用或較高呼叫量，強烈建議改用下方 Docker／本機方式自行架設伺服器，或使用 Prefect Horizon 的付費方案。

🙏 感謝 Prefect Horizon 支援本開源專案，讓社群能免費輕鬆試用。

🐳 Docker 使用（stdio）

{
  "twstockmcpserver": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "--pull=always",
      "-e",
      "MCP_STDIO=1",
      "ghcr.io/twjackysu/twsemcpserver:latest"
    ]
  }
}

🎛️ 只開部分資料來源

工具很多，用不到的來源可以關掉，減少 client 要讀的工具清單。來源代號：twse（證交所）、tpex（櫃買中心）、taifex（期交所）、mops（公開資訊觀測站）、tdcc（集保）、sitca（投信投顧公會）、ndc（國發會）、cbc（央行）。

TWSE_INCLUDE_SOURCES=twse,tpex：只開這些來源（不設＝全部）
TWSE_EXCLUDE_SOURCES=taifex：關掉這些來源

工具只要用到一個沒開的來源就不會出現（例如 ETF 基本資料同時查投信投顧公會、證交所、櫃買中心）。Docker 用 -e TWSE_EXCLUDE_SOURCES=taifex 傳入。

🔧 本地安裝

git clone https://github.com/twjackysu/TWStockMCPServer.git
cd TWStockMCPServer
uv sync && uv run fastmcp dev inspector server.py

📡 資料來源

來源	說明	Tools
TWSE OpenAPI	台灣證交所官方 API — 公司治理、ESG、財務比率、公告名單、權證、券商等	105 個
TWSE Web API	證交所網頁 API（皆預設最新交易日，可查任意過去日期）— 個股日K、月均價、估值、融資融券、上市三大法人買賣超（金額/股數）、全市場收盤行情、加權指數歷史、外資持股歷史、個股月/年成交彙總、鉅額交易明細、融券借券餘額/成交、除權除息計算結果、當日沖銷交易標的與統計、全部指數（含類股指數）收盤（皆可查最新或任意過去日期）	19 個
MIS 即時報價	盤中即時多股報價（上市+上櫃）、ETF 已發行單位數與預估淨值／折溢價揭露	2 個
TPEx OpenAPI	櫃買中心 — 上櫃日收盤（最新一日；指定日期改用網站資料）、注意/處置股、零股、指數	5 個
TAIFEX OpenAPI	期交所 — 選擇權分析（Delta/未平倉增減）、保證金、年月統計	6 個
TAIFEX 網站下載	期交所網站資料下載頁面 — 期貨／選擇權每日行情、三大法人（期貨/選擇權分計、總表、各契約、買賣權分計）、期貨與選擇權大額交易人部位、Put/Call Ratio（預設最新交易日，可回溯查詢；openapi.taifex.com.tw 僅提供最新一日）、期貨盤中分鐘 K 線（最近 30 個交易日的每筆成交）	11 個
公開資訊觀測站 MOPS	綜合損益表／資產負債表／現金流量表、月營收、股利分派（皆預設最新一期，可查任意過去期間；上市櫃、興櫃、公發公司皆可）、重大訊息（含全文）、董監持股與設質、內部人持股異動、庫藏股、背書保證與資金貸與、法人說明會	11 個
TPEx 網站	櫃買中心網站 API — 上櫃個股日K、三大法人買賣超（可依外資／投信／自營商排行）、三大法人買賣金額彙總（日／週／月）、融資融券、本益比/殖利率/淨值比、外資持股排行、除權除息計算結果（預設最新交易日，可回溯任意過去日期）	7 個
投信投顧公會 ETF 專區	所有投信的 ETF 基本資料（另合併證交所基金基本資料、櫃買中心 ETF 商品規格）、每月規模／淨值／受益人數／申購買回／定期定額（2007 年起）、基金投資明細（每月前十大、每季占淨值 1% 以上持股）	3 個
集保結算所開放資料	集保戶股權分散表（最新一週完整級距，或最近 13 週逐週趨勢與週變化；後者走集保查詢頁）	1 個
國發會	景氣對策信號與景氣指標（1982 起）、臺灣採購經理人指數 PMI/NMI	2 個
中央銀行	新台幣及主要貿易對手通貨對美元每日匯率（1993 起）	1 個
衍生分析（由上述資料計算）

🤝 參與貢獻

歡迎PR！

📄 授權 & 免責聲明

MIT授權 | 僅供參考，不構成投資建議

TWSE

Bu sunucuyu ekle

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install TWSE?

Does TWSE need an API key?

What transport does TWSE use?

When was TWSE last checked?

Documentation

🚀 TWStockMCPServer

🌏 語言版本

🎬 示範影片

VSCode Copilot demo

Gemini CLI demo

✨ 五大投資分析情境

📊 個股趨勢研判

💰 外資投資解讀

🔥 市場熱點捕捉

💎 股利投資規劃

🎯 投資標的篩選

🧮 進階功能

期貨籌碼與選擇權分析

三大法人籌碼流向

個股財報體檢

買前風險掃描

期貨/三大法人歷史回溯查詢

財報／營收／股利多期歷史

籌碼集中度與上櫃歷史

ETF

總體經濟

⚙️ 快速開始

🚀 線上使用（由 Prefect Horizon 提供支援）

🐳 Docker 使用（stdio）

🎛️ 只開部分資料來源

🔧 本地安裝

📡 資料來源

🤝 參與貢獻

📄 授權 & 免責聲明