AI agent？先讀 /llms.txt 取得全站索引。

Overview

Tools / MCP

把台股官方資料接上你的程式與 AI 助理——REST API 與 MCP 皆已上線,五分鐘上手。

Tools / MCP —— 把台股接上你的程式與 AI

用一把 API key,就能查台股官方資料:行情與還原價、月營收、財報三表、估值、技術指標、籌碼與三大法人、公司事件與公告。

REST API(api.twmarketdata.com)—— 任何語言、任何能打 HTTP 的程式或 AI agent 都能接。
MCP(mcp.twmarketdata.com)—— 讓 Claude、Cursor 等 AI 助理一鍵連上、用自然語言問,它自己選工具查。

兩者查的是同一份官方資料、同一套定價,扣點完全一致。用哪個看你的場景:寫程式用 REST,想讓 AI 助理直接會查台股用 MCP。

先拿一把 API key

到儀表板建立一把 key(sk_live_… 開頭)。key 綁定你的方案,決定可查的資料集、rate limit 與用量。請妥善保存;外洩就到儀表板撤銷並重建(撤銷後永久失效)。

A. 用 MCP 讓你的 AI 一鍵會查台股(最簡單)

MCP 上線後,你的 AI 助理會自動偵測所有工具,你用中文/英文問它,它就自己選工具查——不用你手寫任何 API。

1. 連上(選你用的 AI 工具)

我們用 API key(X-API-Key header) 認證。以下是目前實測可連的客戶端 —— 每個都寫清楚「在哪裡設定」。伺服器位址一律是:https://mcp.twmarketdata.com/mcp,sk_live_你的key 換成你的 key。

Claude Code(終端機一行,最快)›

在終端機執行:

claude mcp add --transport http tw-market-data \  https://mcp.twmarketdata.com/mcp \  --header "X-API-Key: sk_live_你的key"

確認:claude mcp list 看到 tw-market-data ✓ connected。

Cursor›

編輯設定檔 ~/.cursor/mcp.json,加入:

{  "mcpServers": {    "tw-market-data": {      "url": "https://mcp.twmarketdata.com/mcp",      "headers": { "X-API-Key": "sk_live_你的key" }    }  }}

存檔後在 Cursor 設定的 MCP 頁確認已連上。

VS Code(Copilot / MCP)›

編輯 mcp.json(macOS:~/Library/Application Support/Code/User/mcp.json;Windows:%APPDATA%\\Code\\User\\mcp.json;Linux:~/.config/Code/User/mcp.json):

{  "servers": {    "tw-market-data": {      "type": "http",      "url": "https://mcp.twmarketdata.com/mcp",      "headers": { "X-API-Key": "sk_live_你的key" }    }  }}

或用命令面板 MCP: Add Server。

Codex(OpenAI CLI)›

編輯 ~/.codex/config.toml:

[mcp_servers.tw_market_data]url = "https://mcp.twmarketdata.com/mcp"http_headers = { "X-API-Key" = "sk_live_你的key" }

Gemini CLI›

編輯 ~/.gemini/settings.json:

{  "mcpServers": {    "tw-market-data": {      "url": "https://mcp.twmarketdata.com/mcp",      "headers": { "X-API-Key": "sk_live_你的key" }    }  }}

Windsurf›

編輯 ~/.codeium/windsurf/mcp_config.json(注意 Windsurf 用 serverUrl,不是 url):

{  "mcpServers": {    "tw-market-data": {      "type": "streamable-http",      "serverUrl": "https://mcp.twmarketdata.com/mcp",      "headers": { "X-API-Key": "sk_live_你的key" }    }  }}

其他(LM Studio / Cherry Studio / Goose / Raycast)›

這些都讀 mcpServers JSON,結構同 Cursor(url + headers)。Raycast 則在 App 內用表單填 Transport: HTTP + URL + header。

Zed(需一個小轉接)›

Zed 的 URL 表單不接受 header,需用 mcp-remote 轉接。編輯 ~/.config/zed/settings.json:

{  "context_servers": {    "tw-market-data": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://mcp.twmarketdata.com/mcp",               "--header", "X-API-Key: sk_live_你的key"]    }  }}

目前尚未支援:ChatGPT、Claude Desktop / Claude.ai 網頁版。 這些客戶端的連線走 OAuth,尚不接受本服務的 API key 連線方式。OAuth 一鍵連線正在開發中,屆時這些客戶端也能連 —— 敬請關注。在此之前,請用上方的開發者工具連線,或直接用 REST。

2. 直接用自然語言問

連上後,在對話裡直接問,例如:

「查台積電 2330 最近一季損益表。」
「比較 2330 與 2317 最近 12 個月的月營收 YoY。」
「列出三大法人最近一週買超最多的股票。」
「用技術指標找出 RSI < 30 的股票。」

你的 AI 會自動:先用 list_datasets 找到對的資料集 → 用 query_dataset 取回乾淨的 JSON → 幫你摘要/比較/篩選。

MCP 提供的 4 個工具(你的 AI 會自動選用)

工具	用途	計費
list_datasets	列出所有可用資料集(可依類別/方案層過濾)	免費
describe_dataset	看某個資料集的欄位、語義、更新頻率	免費
query_dataset	取回實際資料列(支援個股、日期範圍、`as_of` 時點)	依資料集扣點(與 REST 同價)
find_related	跨表/供應鏈關聯推理(找可 join 的資料、同產業鏈個股)	免費

計費說明:只有 query_dataset 取回資料本體會扣點,價格與 REST 同一份 SSOT 定價一致;list_datasets / describe_dataset / find_related 免費。

回測友善:point-in-time(`as_of`)

要做回測或給 agent 學習,query_dataset 帶 as_of='YYYY-MM-DD' —— 財報、月營收等非即時資料會依揭露/公告日過濾,讓 agent 只看得到那個時點公開的資訊,不洩漏未來。例:

「查 2330 在 2023-06-30 當時可知的損益表」→ AI 會帶 as_of=2023-06-30。

B. 用 REST 接到任何程式 / AI 框架

打第一個呼叫

curl -H "X-API-Key: sk_live_你的key" \  "https://api.twmarketdata.com/v2/datasets/twse-daily-price?symbol=2330&limit=5"

回傳台積電最近 5 個交易日的日線(開高低收、量、還原資訊)= 成功。

換資料集 —— 把路徑最後一段換掉

/v2/datasets/monthly-revenue?symbol=2330            # 月營收/v2/datasets/income-statement?symbol=2330           # 損益表/v2/datasets/institutional-flow?symbol=2330         # 三大法人買賣超

Python

import requestsr = requests.get(    "https://api.twmarketdata.com/v2/datasets/twse-daily-price",    params={"symbol": "2330", "limit": 20},    headers={"X-API-Key": "sk_live_你的key"},)print(r.json()["rows"])

JavaScript / TypeScript

const res = await fetch(  "https://api.twmarketdata.com/v2/datasets/monthly-revenue?symbol=2330",  { headers: { "X-API-Key": "sk_live_你的key" } },);const data = await res.json();

接到 AI agent —— 任何支援「呼叫 HTTP API」的框架(LangChain、自建 tool 等),把上面的 GET 包成一個 tool,agent 就能自己查台股。回傳是乾淨的 normalized JSON,直接餵給模型。

認證(Authentication)

API Key —— 每個 request 帶 X-API-Key: sk_live_…(REST 走 header;MCP 走 claude mcp add 的 --header)。key 綁定方案,決定可查資料集、rate limit 與月用量。
安全 —— key 請勿寫進公開程式碼或分享;外洩就到儀表板撤銷重建。

資料集一覽(每個一行用途)

完整資料集與每次 credits 成本見儀表板成本表。MCP 端你的 AI 也能用 list_datasets 隨時列出目前有權限的全部資料集。

市場與價格
上市 / 上櫃個股日線(開高低收、量、還原)、還原價(total-return 回測用)、大盤與類股指數、漲跌家數。

財務與成長
月營收(含 MoM / YoY)、財報三表(損益/資產負債/現金流)、財務比率、估值(PER / PBR / 殖利率)。

籌碼與資金
三大法人買賣超、融資融券、借券、法人持股 / 集保股權分散、當沖、大額交易人未平倉。

衍生性 / 可轉債
期貨、選擇權日資料(TAIFEX)、可轉債日成交。

事件 / 風險 / 股利
公司事件與公告、裁罰 / 法律風險事件、股利 / 除權息、注意處置。

技術 / 因子 / 總經
技術指標(MA / RSI / MACD…)、選股因子、利率、國際總經、匯率、證券主檔、產業鏈與分類。

註:「全市場個股日線聯集(上市+上櫃)」正在上架中;在此之前請用「上市日線」與「上櫃日線」個別資料集。

語義與注意

回傳為 normalized JSON,欄位穩定;缺資料誠實回 null,不捏造。
資料為 EOD 官方數據(TWSE / TPEx / TAIFEX / MOPS…),不含即時逐筆、分K、分點——乾淨、可回測、PIT 安全。
rate limit 與月度用量依方案;超量回 402 / 429,不靜默放行。
更多:Quick Start·OpenAPI· 給 AI 先讀/llms.txt。

AI agent？先讀 /llms.txt 取得全站索引。

Overview

Tools / MCP

把台股官方資料接上你的程式與 AI 助理——REST API 與 MCP 皆已上線,五分鐘上手。

Tools / MCP —— 把台股接上你的程式與 AI

用一把 API key,就能查台股官方資料:行情與還原價、月營收、財報三表、估值、技術指標、籌碼與三大法人、公司事件與公告。

REST API(api.twmarketdata.com)—— 任何語言、任何能打 HTTP 的程式或 AI agent 都能接。
MCP(mcp.twmarketdata.com)—— 讓 Claude、Cursor 等 AI 助理一鍵連上、用自然語言問,它自己選工具查。

兩者查的是同一份官方資料、同一套定價,扣點完全一致。用哪個看你的場景:寫程式用 REST,想讓 AI 助理直接會查台股用 MCP。

先拿一把 API key

A. 用 MCP 讓你的 AI 一鍵會查台股(最簡單)

MCP 上線後,你的 AI 助理會自動偵測所有工具,你用中文/英文問它,它就自己選工具查——不用你手寫任何 API。

1. 連上(選你用的 AI 工具)

Claude Code(終端機一行,最快)›

在終端機執行:

claude mcp add --transport http tw-market-data \  https://mcp.twmarketdata.com/mcp \  --header "X-API-Key: sk_live_你的key"

確認:claude mcp list 看到 tw-market-data ✓ connected。

Cursor›

編輯設定檔 ~/.cursor/mcp.json,加入:

{  "mcpServers": {    "tw-market-data": {      "url": "https://mcp.twmarketdata.com/mcp",      "headers": { "X-API-Key": "sk_live_你的key" }    }  }}

存檔後在 Cursor 設定的 MCP 頁確認已連上。

VS Code(Copilot / MCP)›

編輯 mcp.json(macOS:~/Library/Application Support/Code/User/mcp.json;Windows:%APPDATA%\\Code\\User\\mcp.json;Linux:~/.config/Code/User/mcp.json):

{  "servers": {    "tw-market-data": {      "type": "http",      "url": "https://mcp.twmarketdata.com/mcp",      "headers": { "X-API-Key": "sk_live_你的key" }    }  }}

或用命令面板 MCP: Add Server。

Codex(OpenAI CLI)›

編輯 ~/.codex/config.toml:

[mcp_servers.tw_market_data]url = "https://mcp.twmarketdata.com/mcp"http_headers = { "X-API-Key" = "sk_live_你的key" }

Gemini CLI›

編輯 ~/.gemini/settings.json:

{  "mcpServers": {    "tw-market-data": {      "url": "https://mcp.twmarketdata.com/mcp",      "headers": { "X-API-Key": "sk_live_你的key" }    }  }}

Windsurf›

編輯 ~/.codeium/windsurf/mcp_config.json(注意 Windsurf 用 serverUrl,不是 url):

{  "mcpServers": {    "tw-market-data": {      "type": "streamable-http",      "serverUrl": "https://mcp.twmarketdata.com/mcp",      "headers": { "X-API-Key": "sk_live_你的key" }    }  }}

其他(LM Studio / Cherry Studio / Goose / Raycast)›

這些都讀 mcpServers JSON,結構同 Cursor(url + headers)。Raycast 則在 App 內用表單填 Transport: HTTP + URL + header。

Zed(需一個小轉接)›

Zed 的 URL 表單不接受 header,需用 mcp-remote 轉接。編輯 ~/.config/zed/settings.json:

{  "context_servers": {    "tw-market-data": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://mcp.twmarketdata.com/mcp",               "--header", "X-API-Key: sk_live_你的key"]    }  }}

2. 直接用自然語言問

連上後,在對話裡直接問,例如:

「查台積電 2330 最近一季損益表。」
「比較 2330 與 2317 最近 12 個月的月營收 YoY。」
「列出三大法人最近一週買超最多的股票。」
「用技術指標找出 RSI < 30 的股票。」

你的 AI 會自動:先用 list_datasets 找到對的資料集 → 用 query_dataset 取回乾淨的 JSON → 幫你摘要/比較/篩選。

MCP 提供的 4 個工具(你的 AI 會自動選用)

工具	用途	計費
list_datasets	列出所有可用資料集(可依類別/方案層過濾)	免費
describe_dataset	看某個資料集的欄位、語義、更新頻率	免費
query_dataset	取回實際資料列(支援個股、日期範圍、`as_of` 時點)	依資料集扣點(與 REST 同價)
find_related	跨表/供應鏈關聯推理(找可 join 的資料、同產業鏈個股)	免費

計費說明:只有 query_dataset 取回資料本體會扣點,價格與 REST 同一份 SSOT 定價一致;list_datasets / describe_dataset / find_related 免費。

回測友善:point-in-time(`as_of`)

「查 2330 在 2023-06-30 當時可知的損益表」→ AI 會帶 as_of=2023-06-30。

B. 用 REST 接到任何程式 / AI 框架

打第一個呼叫

curl -H "X-API-Key: sk_live_你的key" \  "https://api.twmarketdata.com/v2/datasets/twse-daily-price?symbol=2330&limit=5"

回傳台積電最近 5 個交易日的日線(開高低收、量、還原資訊)= 成功。

換資料集 —— 把路徑最後一段換掉

/v2/datasets/monthly-revenue?symbol=2330            # 月營收/v2/datasets/income-statement?symbol=2330           # 損益表/v2/datasets/institutional-flow?symbol=2330         # 三大法人買賣超

Python

import requestsr = requests.get(    "https://api.twmarketdata.com/v2/datasets/twse-daily-price",    params={"symbol": "2330", "limit": 20},    headers={"X-API-Key": "sk_live_你的key"},)print(r.json()["rows"])

JavaScript / TypeScript

const res = await fetch(  "https://api.twmarketdata.com/v2/datasets/monthly-revenue?symbol=2330",  { headers: { "X-API-Key": "sk_live_你的key" } },);const data = await res.json();

認證(Authentication)

API Key —— 每個 request 帶 X-API-Key: sk_live_…(REST 走 header;MCP 走 claude mcp add 的 --header)。key 綁定方案,決定可查資料集、rate limit 與月用量。
安全 —— key 請勿寫進公開程式碼或分享;外洩就到儀表板撤銷重建。

資料集一覽(每個一行用途)

完整資料集與每次 credits 成本見儀表板成本表。MCP 端你的 AI 也能用 list_datasets 隨時列出目前有權限的全部資料集。

市場與價格
上市 / 上櫃個股日線(開高低收、量、還原)、還原價(total-return 回測用)、大盤與類股指數、漲跌家數。

財務與成長
月營收(含 MoM / YoY)、財報三表(損益/資產負債/現金流)、財務比率、估值(PER / PBR / 殖利率)。

籌碼與資金
三大法人買賣超、融資融券、借券、法人持股 / 集保股權分散、當沖、大額交易人未平倉。

衍生性 / 可轉債
期貨、選擇權日資料(TAIFEX)、可轉債日成交。

事件 / 風險 / 股利
公司事件與公告、裁罰 / 法律風險事件、股利 / 除權息、注意處置。

技術 / 因子 / 總經
技術指標(MA / RSI / MACD…)、選股因子、利率、國際總經、匯率、證券主檔、產業鏈與分類。

註:「全市場個股日線聯集(上市+上櫃)」正在上架中;在此之前請用「上市日線」與「上櫃日線」個別資料集。

語義與注意

回傳為 normalized JSON,欄位穩定;缺資料誠實回 null,不捏造。
資料為 EOD 官方數據(TWSE / TPEx / TAIFEX / MOPS…),不含即時逐筆、分K、分點——乾淨、可回測、PIT 安全。
rate limit 與月度用量依方案;超量回 402 / 429,不靜默放行。
更多:Quick Start·OpenAPI· 給 AI 先讀/llms.txt。

Tools / MCP

1. 連上(選你用的 AI 工具)

2. 直接用自然語言問

MCP 提供的 4 個工具(你的 AI 會自動選用)

回測友善:point-in-time(as_of)

打第一個呼叫

換資料集 —— 把路徑最後一段換掉

Python

JavaScript / TypeScript

Tools / MCP

1. 連上(選你用的 AI 工具)

2. 直接用自然語言問

MCP 提供的 4 個工具(你的 AI 會自動選用)

回測友善:point-in-time(as_of)

打第一個呼叫

換資料集 —— 把路徑最後一段換掉

Python

JavaScript / TypeScript

回測友善:point-in-time(`as_of`)

回測友善:point-in-time(`as_of`)