AI agent？先讀 /llms.txt 取得全站索引。
Overview
把台股官方資料接上你的程式與 AI 助理——REST API 與 MCP 皆已上線,五分鐘上手。
用一把 API key,就能查台股官方資料:行情與還原價、月營收、財報三表、估值、技術指標、籌碼與三大法人、公司事件與公告。
api.twmarketdata.com)—— 任何語言、任何能打 HTTP 的程式或 AI agent 都能接。mcp.twmarketdata.com)—— 讓 Claude、Cursor 等 AI 助理一鍵連上、用自然語言問,它自己選工具查。兩者查的是同一份官方資料、同一套定價,扣點完全一致。用哪個看你的場景:寫程式用 REST,想讓 AI 助理直接會查台股用 MCP。
到儀表板建立一把 key(sk_live_… 開頭)。key 綁定你的方案,決定可查的資料集、rate limit 與用量。請妥善保存;外洩就到儀表板撤銷並重建(撤銷後永久失效)。
MCP 上線後,你的 AI 助理會自動偵測所有工具,你用中文/英文問它,它就自己選工具查——不用你手寫任何 API。
我們用 API key(X-API-Key header) 認證。以下是目前實測可連的客戶端 —— 每個都寫清楚「在哪裡設定」。伺服器位址一律是:https://mcp.twmarketdata.com/mcp,sk_live_你的key 換成你的 key。
在終端機執行:
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。
Claude Desktop 透過 mcp-remote 本地橋接連遠端 MCP(它會帶上 X-API-Key 標頭)。加到 claude_desktop_config.json:
{
"mcpServers": {
"tw-market-data": {
"command": "npx",
"args": [
"-y", "mcp-remote", "https://mcp.twmarketdata.com/mcp",
"--transport", "http-only",
"--header", "X-API-Key: sk_live_你的key"
]
}
}
}重啟 Claude Desktop,tw-market-data 會出現在工具清單,帶著它的 34 個工具。
編輯設定檔 ~/.cursor/mcp.json,加入:
{
"mcpServers": {
"tw-market-data": {
"url": "https://mcp.twmarketdata.com/mcp",
"headers": { "X-API-Key": "sk_live_你的key" }
}
}
}存檔後在 Cursor 設定的 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/config.toml:
[mcp_servers.tw_market_data]url = "https://mcp.twmarketdata.com/mcp"http_headers = { "X-API-Key" = "sk_live_你的key" }編輯 ~/.gemini/settings.json:
{
"mcpServers": {
"tw-market-data": {
"url": "https://mcp.twmarketdata.com/mcp",
"headers": { "X-API-Key": "sk_live_你的key" }
}
}
}編輯 ~/.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" }
}
}
}這些都讀 mcpServers JSON,結構同 Cursor(url + headers)。Raycast 則在 App 內用表單填 Transport: HTTP + URL + header。
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。
連上後,在對話裡直接問,例如:
你的 AI 會自動:先用 list_datasets 找到對的資料集 → 用 query_dataset 取回乾淨的 JSON → 幫你摘要/比較/篩選。
| 工具 | 用途 | 計費 |
|---|---|---|
| list_datasets | 列出所有可用資料集(可依類別/方案層過濾) | 免費 |
| describe_dataset | 看某個資料集的欄位、語義、更新頻率 | 免費 |
| query_dataset | 取回實際資料列(支援個股、日期範圍、as_of 時點) | 依資料集扣點(與 REST 同價) |
| find_related | 跨表/供應鏈關聯推理(找可 join 的資料、同產業鏈個股) | 免費 |
計費說明:只有query_dataset取回資料本體會扣點,價格與 REST 同一份 SSOT 定價一致;list_datasets/describe_dataset/find_related免費。
as_of)要做回測或給 agent 學習,query_dataset 帶 as_of='YYYY-MM-DD' —— 財報、月營收等非即時資料會依揭露/公告日過濾,讓 agent 只看得到那個時點公開的資訊,不洩漏未來。例:
「查 2330 在 2023-06-30 當時可知的損益表」→ AI 會帶 as_of=2023-06-30。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 # 三大法人買賣超import requests
r = 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"])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,直接餵給模型。
X-API-Key: sk_live_…(REST 走 header;MCP 走 claude mcp add 的 --header)。key 綁定方案,決定可查資料集、rate limit 與月用量。完整資料集與每次 credits 成本見儀表板成本表。MCP 端你的 AI 也能用 list_datasets 隨時列出目前有權限的全部資料集。市場與價格
上市 / 上櫃個股日線(開高低收、量、還原)、還原價(total-return 回測用)、大盤與類股指數、漲跌家數。
財務與成長
月營收(含 MoM / YoY)、財報三表(損益/資產負債/現金流)、財務比率、估值(PER / PBR / 殖利率)。
籌碼與資金
三大法人買賣超、融資融券、借券、法人持股 / 集保股權分散、當沖、大額交易人未平倉。
衍生性 / 可轉債
期貨、選擇權日資料(TAIFEX)、可轉債日成交。
事件 / 風險 / 股利
公司事件與公告、裁罰 / 法律風險事件、股利 / 除權息、注意處置。
技術 / 因子 / 總經
技術指標(MA / RSI / MACD…)、選股因子、利率、國際總經、匯率、證券主檔、產業鏈與分類。
註:「全市場個股日線聯集(上市+上櫃)」正在上架中;在此之前請用「上市日線」與「上櫃日線」個別資料集。
null,不捏造。