把 ToAlpha 接進 Claude、ChatGPT、Cursor 這類支援 MCP 的 AI 助手之後,你可以直接問「台積電最近外資在買還是賣」「聯發科的月營收趨勢」「哪些券商上修目標價」「幫我看這個組合的風險」,AI 會呼叫下面的工具拿到算好的數字、資料日期與本站連結。回的是公開資料的整理與規則式判讀,不是投資建議。
怎麼接
Claude Code 一行:
claude mcp add --transport http toalpha https://toalpha.tw/mcp --header "Authorization: Bearer 你的金鑰"
Claude Desktop / Cursor 的設定檔:
{
"mcpServers": {
"toalpha": {
"url": "https://toalpha.tw/mcp",
"headers": { "Authorization": "Bearer 你的金鑰" }
}
}
}金鑰在帳號頁產生,可隨時撤銷。沒有金鑰也能用(除了帳號相關的兩個工具),只是額度較低。
額度(目前全部免費)
| 每分鐘 | 每日 |
|---|
| 未帶金鑰(依 IP) | 10 次 | 500 次 |
| 帶金鑰 | 60 次 | 5,000 次 |
工具
定位與大盤
| 工具 | 輸入 | 回什麼 |
|---|
resolve_stock | 名稱或代號片段 | 換成代號、市場、產業,最多 10 個候選。所有工具的前置。 |
market_overview | 無 | 加權與櫃買指數、三大法人今日與 5 / 20 / 60 日、連買賣天數、融資餘額近一年位置、市值加權估值、漲跌家數。 |
rank | 榜名、筆數 | 明年營收 / EPS 成長、券商目標價 Upside、殖利率、外資與投信 5 日買賣超、成交金額、月營收年增、ROE、今年預估本益比,最多 50 檔。 |
screen | 條件(全部選填) | 本益比、淨值比、殖利率、ROE、毛利率、月營收年增、今明年本益比與成長率、分析師家數、券商 Upside、市值、市場、產業;沒有預設策略。 |
個股基本面
| 工具 | 輸入 | 回什麼 |
|---|
stock_snapshot | 代號 | 法人級摘要:價與 52 週位置、估值、成長率與分析師家數、券商目標價中位數與 Upside、籌碼結構。一個呼叫就能開始談這檔。 |
financials | 代號、quarter / annual、期數 | 營收、三率、母公司淨利、EPS(已還原股數變動)、ROE,每項附年增。 |
monthly_revenue | 代號、月數 | 月營收、年增、月增、累計年增、是否創新高、連續年增月數。 |
estimates | 代號 | 分析師共識的衍生指標:今明後年營收 / EPS / 淨利成長率、預估毛利率相對實績的變化、家數、分歧度、近 8 季 beat / miss。不含原始預估值。 |
dividends | 代號 | 年度股利與配發率、殖利率與十年平均、連續配息 / 成長年數、填息成功率與天數、即將除權息。 |
balance_sheet | 代號 | 負債比率、流動比率、每股淨值、ROE / ROA、近四季營業現金流、資本支出、自由現金流與 FCF 殖利率。 |
compare | 代號清單(最多 20) | 同業橫向比較:估值、獲利、成長、籌碼、券商 Upside,附這批的中位數。 |
籌碼
| 工具 | 輸入 | 回什麼 |
|---|
institutional_flows | 代號 | 外資 / 投信 / 自營今日與 5 / 20 / 60 日累計、連買賣、占成交量、外資持股比與 20 日變化、單日最大買賣超與之後 5 日股價。 |
margin_balance | 代號 | 融資餘額與近一年位置、使用率、券資比、各期間增減與判讀、幾天成交量可消化、軋空條件。 |
fund_holdings | 代號 | 投信前十大持股:主動基金 / 被動 ETF / 主動式 ETF 的基金數、估計張數與月變化、該類型權重、主動 − 被動權重差、持有最多的基金。 |
active_etf_holders | 代號 | 主動式 ETF:持有檔數、合計張數、規模加權曝險 vs 市值占比、各 ETF 權重與最新動作。 |
insider_pledge | 代號 | 董監持股、質押張數與質押比、持股前 5 大內部人。 |
資訊流
| 工具 | 輸入 | 回什麼 |
|---|
broker_ratings | 代號(選填)、天數 | 各券商最新評等與目標價(已還原)、中位數與 Upside、看多 / 中立 / 看空家數,附原報導連結;不給代號則列全市場最近幾天。 |
news | 代號(可多檔)、天數、主題 | 新聞標題、來源、時間、連結;主題可選券商評等 / 營收財報 / 公司動態 / 籌碼與法人。只有標題,沒有內文。 |
events | 代號清單、天數 | 未來的除權息、法說會,以及月營收公布窗口。 |
conference_calls | 代號 | 近 8 場法說會(日期、地點、簡報連結)、法說後 1 / 5 日股價反應、依歷史節奏推估的下一場。 |
估值與共識
| 工具 | 輸入 | 回什麼 |
|---|
valuation_history | 代號、年數(≤15) | 本益比 / 淨值比 / 殖利率的歷史百分位與區間、本益比河流帶、近 12 個月月底序列。 |
analyst_consensus | 代號 | 共識評等標籤與分數、強力買進 / 買進 / 持有 / 賣出家數、目標價中位數與高低相對現價的比率。 |
投信與 ETF 進階
| 工具 | 輸入 | 回什麼 |
|---|
fund_company_holdings | 代號 或 投信名稱、類型 | 投信比較:各投信對一檔的權重與全類型平均的差;或一家投信的前 15 大持股與超配。 |
fund_ranking | 類型、期間、筆數 | 基金績效排名(ytd / 3 月 / 6 月 / 1 / 2 / 3 / 5 年)、淨資產、前三大持股。 |
etf_profile | ETF 代號 | 主動式 ETF 本身:規模、淨值與折溢價、前 15 大持股、近 5 個交易日加減碼。 |
etf_changes | 天數、動作、筆數 | 全市場主動式 ETF 最近的新增 / 加碼 / 減碼 / 剔除,與被動作最多的股票。 |
市場面進階
| 工具 | 輸入 | 回什麼 |
|---|
calendar | 天數、種類 | 全市場未來的除權息(附現價殖利率)與法說會。 |
top_news | 筆數 | 精選新聞:近 18 小時依評分挑出(來源等級、點名個股、異常報酬、法人動作、事件詞;扣農場文與例行文),每檔一則。 |
industries | 無 | 產業清單:檔數、市值、本益比中位數、今日加權漲跌、近 20 日外資買賣超。 |
industry_overview | 產業名、筆數 | 單一產業:估值與成長中位數、法人 20 日流向、市值前 N 檔。 |
corporate_actions | 代號 | 面額變更、減資、股票股利等股數變動紀錄與還原係數。 |
data_status | 無 | 各資料來源最後更新的期間與時間、24 小時內的失敗次數。解讀當天數字前先看這個。 |
原始資料(不做判讀,只設筆數上限)
| 工具 | 輸入 | 回什麼 |
|---|
financial_statements | 代號、income / balance / cashflow、季數(≤8)、科目正則 | 公開資訊觀測站三大報表逐科目申報原值(千元):損益表給單季與累計、資產負債表期末餘額、現金流量表年初至今。 |
price_history | 代號、天數(≤1000)、是否還原 | 每日開高低收、漲跌、成交張數、成交金額、筆數。 |
flows_daily | 代號、天數(≤500) | 每日外資、投信、自營商自行 / 避險買賣超、收盤、成交張數、外資持股比例。 |
margin_daily | 代號、天數(≤500) | 每日融資買賣現償餘額限額、融券賣買券償餘額、資券互抵、收盤。 |
組合與帳號
| 工具 | 輸入 | 回什麼 |
|---|
portfolio_check | 持股「代號:張數[:成本],…」 | 不用登入:市值、今日與未實現損益、集中度、估值 vs 大盤、近一年走勢與 beta / 波動 / 最大回撤、產業配置、法人流向、持股明細。 |
my_portfolio | 組合名稱(選填) | 需要金鑰:你存在帳號裡的雲端組合,回跟 portfolio_check 一樣的分析。 |
my_watchlist | 無 | 需要金鑰:自選股的漲跌、估值、成長、法人、券商 Upside 與未來 30 天事件。 |
公開資訊觀測站專用端點
只想接上市櫃公司在公開資訊觀測站申報的資料,不要股價、法人籌碼、券商評等這些,可以改接這個端點。同一把金鑰兩邊都能用,額度各自計算。完整說明 →
claude mcp add --transport http toalpha-mops https://toalpha.tw/mcp/mops --header "Authorization: Bearer 你的金鑰"
| 工具 | 輸入 | 回什麼 |
|---|
resolve_stock | 公司名稱或代號 | 候選代號、名稱、市場、產業 |
financial_statements | 代號、報表(income / balance / cashflow)、期數、科目篩選 | 財務報告逐科目申報原值(千元),損益表附單季與累計 |
financial_ratios | 代號、quarter / annual、期數 | 營收、三率、淨利、EPS(已還原股數變動)、ROE 與年增 |
monthly_revenue | 代號、月數 | 月營收、年增、月增、累計年增 |
dividend_policy | 代號、年數 | 每次決議的現金與股票股利、所屬期間、決議日,附還原後每股數字與年度合計 |
investor_conferences | 代號(可不給)、往回與往後天數 | 法說會日期、時間、地點、公司說明、中英文簡報連結;不給代號列全市場近期法說 |
insider_holdings | 代號 | 董監事持股、質押張數與質押比 |
data_status | 無 | 各類觀測站資料的最新期別與涵蓋家數 |
資料由本站每日從觀測站同步後存檔,查詢時讀的是本站資料庫,不會即時轉發到觀測站。data_status 可以查每一類資料的最新期別。
提示範本
stock_checkup:給一檔股票,AI 依序呼叫工具整理成估值、成長、籌碼、市場看法四段。peer_comparison:給幾家公司名稱,解析代號後一次比較,標出每項最高與最低。portfolio_review:讀你的雲端組合,整理部位與損益、風險、近期事件、市場看法。
回傳的規則
- 每個回傳有
as_of(各資料的日期)、units、source、link(本站對應頁)。 - 單位固定:張 = 1000 股;金額億元;比率為小數(0.05 = 5%)。每股數字已還原面額變更與配股。
- 預設只回判斷需要的欄位與筆數(1~4 KB),完整資料看 link;要原始序列用「原始資料」那組工具,只設筆數上限。
- 分析師共識只提供衍生比率(前瞻本益比、成長率、分歧度、家數、beat / miss),不提供原始預估值;券商評等只提供評等、目標價與原報導連結,不提供摘錄文字。
read 欄位是規則產生的定義式判讀,跟網站圖表旁的說明相同,不是建議。
使用規範
依使用條款:資料僅供參考、不構成投資建議;不得大量抓取或轉售。用量只記工具名與每日次數,不記查詢內容。