輸入代號或公司名稱後按 Enter
美股 MCP 端點

用 AI 查美股

ToAlpha 美股 MCP 端點 · 17 個工具 · 約 8,022 家公司

設定一次之後,你可以直接問 AI「輝達現在貴不貴」「波克夏上一季買了什麼」「最近分析師上修最多的公司有哪些」, AI 會從 SEC 申報的財報、內部人交易、法人持股、放空餘額與分析師預估取數,自行計算並整理成分析,附上資料日期與出處連結。

最後更新 2026-09-19 · 免費使用 · 每日更新

這是什麼

把美股資料接進 AI 助手的一個端點。資料來自 SEC EDGAR(財報 XBRL、內部人 Form 4、法人持股 13F、申報文件)、FINRA(放空餘額)與市場資料(日線價量、分析師共識)。 跟台股完全分開 —— 這裡只有美股工具,接上之後不會看到台股的東西。

https://toalpha.tw/mcp/us

重點

查詢一律讀本站每日更新後的資料庫,不會在你提問時去打 SEC,所以速度是毫秒級,也不受對方流量限制影響。每一筆回傳都附資料日期與出處。

接上 AI

Claude Code

claude mcp add --transport http toalpha-us https://toalpha.tw/mcp/us

Claude Desktop、Cursor 等設定檔

{
  "mcpServers": {
    "toalpha-us": {
      "url": "https://toalpha.tw/mcp/us"
    }
  }
}

設定完成後直接用中文提問,AI 會自己決定呼叫哪個工具。

可以問什麼

以下問法都可以直接用。AI 會自己組合多個工具取數再計算;每題下方註明會用到哪些資料。最後一題是刻意放的反例 —— 說明查不到的東西會怎麼回答:

  • NVDA 現在貴不貴?跟它自己的歷史比呢snapshot 取本益比與 52 週位置,financials 拉 8 季看毛利率與成長趨勢
  • 輝達上一季的成長是在加速還是放緩financials(quarter, 8)看營收年增與三率的走勢,snapshot 補最新一期年增
  • 波克夏上一季買了什麼、賣了什麼institution_portfolio 給完整組合、權重、季變化與清倉名單
  • 最近 90 天分析師上修最多的大型股有哪些screen 用市值與 EPS 修正幅度兩個條件
  • Wolfspeed 的空單有多重?回補要幾天short_interest 給空單股數、佔流通股比例、回補天數與歷史變化
  • 蘋果的內部人最近有人在買嗎insider_trades(code=P)只看公開市場買進,並標出哪些是 10b5-1 計畫
  • 微軟上一季的 guidance 是什麼investor_documents 指到財報新聞稿 —— 財測不在 XBRL 裡,只在這份文件
  • 幫我看一下 Palantir 的風險因子今年有沒有變filings 取今年與去年的 10-K 連結,AI 自行讀 Item 1A 比對
  • 下週有哪些重要公司要發財報earnings_calendar 依市值排序,附市場預估 EPS 與去年同期
  • 台積電 ADR 的法人持股變化institutional_holders;外國發行人不給市值與本益比,原因會一併說明
  • 找市值 100 億美元以上、本益比低於 20、營收年增超過 15% 的公司screen 三個條件一起下
  • 輝達的營收有多少來自台灣?資料中心還在加速嗎revenue_breakdown 同時給地區與產品別的拆解、佔比與年增率
  • 亞馬遜 AWS 的利潤率跟零售比差多少revenue_breakdown(分部)附各分部的營業利益與利潤率
  • 輝達上一季法說會分析師最常問什麼查不到 —— 法說會逐字稿不在 SEC 申報裡;investor_documents 給得到財報新聞稿與財務長評論,Q&A 要自己聽

回傳格式

snapshot 查輝達為例(節錄,2026-09-19 實際回傳):

{
  "company": { "ticker": "NVDA", "name": "NVIDIA CORP", "cik": 1045810,
               "industry": "Semiconductors & Related Devices", "fiscal_year_end": "0131" },
  "price": { "as_of": "2026-09-17", "close": 218.74,
             "return_pct": { "1m": -0.5, "3m": 6.9, "12m": 25.1 },
             "range_52w": { "low": 165.17, "high": 235.74, "position_pct": 76 },
             "note": "收盤價,延遲至前一交易日" },
  "valuation": { "market_cap_usd_bn": 5271.5, "eps_ttm": 7.91, "pe": 27.7,
                 "eps_basis": "近四季(年度接 2 季)", "ps": 17.4 },
  "latest_period": { "period_end": "2026-07-26", "fiscal": "FY2027 Q2", "form": "10-Q",
                     "revenue_usd_mn": 96221, "revenue_yoy_pct": 105.9,
                     "gross_margin_pct": 75.0, "eps_diluted": 2.46 },
  "consensus": { "analysts": 58, "rating_mean": 1.9,
                 "target_price": { "mean": 328.49, "upside_pct": 50.2 },
                 "next_earnings": "2026-11-17" },
  "estimates": [ { "period": "明年度", "eps_mean": 15.68, "eps_90d_ago": 12.67,
                   "revision_90d_pct": 23.7,
                   "analysts_raising_30d": 42, "analysts_cutting_30d": 0 } ],
  "short_interest": { "settle_date": "2026-08-31", "shares": 298301619,
                      "days_to_cover": 2.14, "pct_of_shares_outstanding": 1.24 },
  "institutional": { "period": "2026-06-30", "holders": 5962, "holders_change_qoq": 94 },
  "link": "https://toalpha.tw/us/NVDA"
}
  • 金額單位標在欄位名稱裡:_usd_mn 百萬美元、_usd_bn 十億美元;比率是百分比數值(75.0 = 75%)。
  • 每筆回傳都有 sourcelink(ToAlpha 對應頁面)。
  • 資料有落差或限制時,回應裡會直接寫明原因(例如 why_no_market_capeps_basis),不會默默給錯的數字或空值。

先知道這些限制

美股資料有幾個結構性的特性,不知道的話容易誤讀。這些在工具回應裡也都會標註:

股價是前一交易日的收盤價

沒有即時或盤中報價。交易所政策上,即時與 15 分鐘延遲的資料在 API 形式上都需要授權或事前核准,而隔日的收盤價不收費也不需要協議。這個端點是給基本面研究用的。

會計年度第四季的單季數字大多不存在

公司用 10-K 報全年,不會另外標那三個月 —— 全市場的單季資料只有約 10% 落在會計 Q4。所以季序列在年度結束處會跳空。近四季的合計是用「年度 + 年度後各季 − 去年對應各季」接出來的,eps_basis 會說明是怎麼接的。

外國發行人不提供市值與本益比

在美國掛 ADR、申報 20-F 或 40-F 的約 1,300 家公司,財報股數是普通股、股價是每單位 ADR(1 ADR 常等於 5 股),相乘會差好幾倍。這些公司多半也沒有標準化財報,因為 20-F 用 IFRS 分類、XBRL 標記的科目少很多。

各項資料有各自的公布節奏

13F 法人持股每季申報、截止日是季末後 45 天,所以最新一季落後約兩個月;放空餘額每月結算兩次、約 8 個交易日後公布;分析師覆蓋只有約 8,532 家,小型股與場外股票多半沒有。

沒有的東西

法說會逐字稿(不在 SEC 申報裡,只有少數公司當附件送)、公司財測的結構化欄位(財測在財報新聞稿裡,investor_documents 會指到那份文件)。分部營收只有公司在 XBRL 裡標了維度的才有(約 2,300 家),單一業務的公司本來就沒有。

資料更新時間

每天更新後整理存檔。下表每小時更新,顯示目前資料庫的最新狀態:

資料最新涵蓋來源公布節奏
財報(標準化)2026-09-166,032季後 40 天內申報
日線價量2026-09-177,669每日收盤後,對外延遲至前一交易日
內部人交易2026-09-17全市場交易後兩個營業日內申報
法人持股 13F2026-06-30全市場每季,季末後 45 天截止
放空餘額2026-08-31全市場每月兩次結算,約 8 個交易日後
分析師共識2026-09-198,532每日
財報日曆未來約兩個月3,664每日
投資人文件77,559 份簡報、新聞稿、逐字稿公司申報後
公司基本資料6,945 / 8,022 家有產業分類公司異動時更新

歷史深度:XBRL 財報自 1990 年起、日線價量自 1970 年起、內部人交易自 2006 年起、法人持股自 2001 年起、放空餘額自 2017 年起。AI 也可以呼叫 data_status 自行確認。

提供的工具

17 個。AI 會自動選用,不需要記名字;這份清單給想了解能力範圍與參數的人。

resolve_stock2 個參數

代號或公司名稱 → CIK、交易所、產業、會計年度結束月。其他工具都吃代號,AI 會先呼叫它。CIK 才是真正的識別碼 —— 代號會因改名或併購而變(Block 從 SQ 變成 XYZ),CIK 不會。

參數預設說明
query必填代號或名稱片段,例如 NVDA 或 Palantir
limit8候選數,上限 20
snapshot1 個參數

個股一次看完:股價與 1/3/6/12 個月報酬、52 週位置、市值與本益比、最新一期財報與年增、分析師評等分布與目標價空間、EPS 預估的 90 天修正方向、放空餘額、法人持股家數與季變化、下次財報日。查一檔美股的建議入口。

參數預設說明
stock必填代號
checkup1 個參數

回一段檢視流程的指示,讓 AI 依序呼叫各工具並整理成報告(估值、成長動能、籌碼、市場預期變化、即將到來的事件五段)。

參數預設說明
stock必填代號
financials3 個參數

標準化財報序列 30 個科目:損益(營收、成本、毛利、營業利益、稅前、淨利、EPS、稀釋股數、研發、管銷、折舊攤銷)、三率與稅率、資產負債(資產、負債、權益、現金、存貨、應收、有息負債)、現金流(營運、投資、融資、資本支出、自由現金流、股利、庫藏股)。銀行與保險沒有一般的「營收」科目,已用利息與非利息收入合成。

參數預設說明
stock必填代號
periodquarterquarter / annual
n8期數,上限 40
xbrl_facts3 個參數

直接查原始 XBRL 科目 —— 標準化財報沒收的東西都在這裡,一家通常有 300–500 個科目。tag 留空會列出這家有哪些科目;給片段(例如 Segment、Lease、Goodwill)就回該科目的歷史數值。

參數預設說明
stock必填代號
tag科目片段;留空 = 列出清單
n40筆數,上限 200
revenue_breakdown4 個參數

營收從哪來:依業務分部、產品/服務、地區、主要客戶、銷售通路拆解的營收,含各部分佔比與年增率,業務分部另附利潤與利潤率(依公司的衡量方式:營業利益、稅前損益或淨利)。同一角度的項目可能有階層(例如輝達的資料中心底下又拆兩項),每個角度都附 reconcile 說明它跟總營收對不對得上。

參數預設說明
stock必填代號
axis分部 / 產品 / 地區 / 客戶 / 通路;留空 = 全部
periodquarterquarter / annual
n4期數,上限 12
filings3 個參數

SEC 申報文件與連結:年報 10-K、季報 10-Q、重大事項 8-K、委託書 DEF 14A、外國公司年報 20-F。給的是文件位置,要看數字以外的東西才需要它 —— 業務說明(Item 1)、風險因子(Item 1A)、管理層討論 MD&A(Item 7)、附註、法律訴訟。

參數預設說明
stock必填代號
form表別,例如 10-K;留空 = 全部
limit20筆數,上限 60
investor_documents3 個參數

公司對投資人發布的文件與網址:法人簡報、財報新聞稿(公司 guidance 在這裡,財測不在 XBRL 裡)、財務長評論、少數公司申報的法說會逐字稿。回應標明每個檔案多大,可以據此決定要不要開。

參數預設說明
stock必填代號
kind簡報 / 新聞稿 / guidance / 財務長
limit15筆數,上限 40
price_history2 個參數

日線價量序列(開高低收、成交量)與區間報酬、期間高低、均量,另附配息與分割事件方便自行還原。收盤價延遲至前一交易日。

參數預設說明
stock必填代號
days120天數,上限 1200
short_interest2 個參數

放空餘額(美股版的融券餘額):空單股數、跟上期的變化、回補天數(空單 ÷ 日均成交量)、佔在外流通股比例,以及歷史序列。變化方向通常比絕對水位有用。

參數預設說明
stock必填代號
periods12期數,上限 48
analyst_consensus1 個參數

評等家數分布、目標價(均值 / 中位 / 最高 / 最低與相對現價的空間與分歧度)、EPS 與營收預估(本季、下季、今年度、明年度),以及預估的修正軌跡 —— 同一期別在 7/30/60/90 天前的共識值,加上近期調升與調降的分析師家數。

參數預設說明
stock必填代號
earnings_calendar3 個參數

財報發布日曆。給代號看那一家的下次與近期發布日;不給就看未來 N 天全市場要發布的(依市值排序)。含市場預估 EPS、分析師家數、去年同期 EPS 與發布日、盤前或盤後。

參數預設說明
stock留空 = 全市場
days14往後天數,上限 90
limit40筆數,上限 100
insider_trades3 個參數

內部人(董事、經理人、10% 大股東)的 Form 4 申報交易,含交易代碼摘要與明細。P 是公開市場自己掏錢買、S 是賣出,這兩個才是內部人的決定;A(獎酬)、M(選擇權轉換)、F(扣稅代繳)是制度性的。另附 10b5-1 事先排定計畫的旗標。

參數預設說明
stock必填代號
days180天數,上限 1095
code只要某一種代碼,例如 P
institutional_holders1 個參數

哪些法人持有這檔股票(13F),以及跟上一季比誰加碼、誰減碼、誰新進。只算有效申報(更正申報分「全部重報」與「只補新增」兩種,已處理);選擇權部位不計入持股股數,另外列出。

參數預設說明
stock必填代號
institution_portfolio2 個參數

某家法人的持股組合與這一季的變化 —— 新進、加碼、減碼、清倉都列出來。給機構名稱片段就好,例如 Berkshire、Bridgewater。看聰明錢上一季實際做了什麼,而不是他們說了什麼。

參數預設說明
manager必填機構名稱片段
limit25持股筆數,上限 50
screen3 個參數

依你指定的條件篩選:市值下限、本益比上限、營收年增率下限、分析師家數下限、目標價上檔空間下限、今年度 EPS 近 90 天修正幅度下限、空單佔流通股下限、產業代碼、類別。所有條件都是選填,沒有任何預設或建議的條件組合。

參數預設說明
各條件選填至少給一個
exclude_foreigntrue排除外國發行人
limit25筆數,上限 50
data_status無參數

資料庫有哪些資料、覆蓋多少家公司、更新到哪一天。查不到東西時先看這個。

技術與隱私

  • 傳輸方式為 streamable-http,符合 MCP 規範;支援 Claude Code、Claude Desktop、claude.ai 自訂 Connector、Cursor、Windsurf 等客戶端。
  • 查詢讀的是本站資料庫,不會在你提問時轉發到 SEC 或任何外部服務。
  • 用量只記工具名稱與每日次數,用來確保服務穩定;不記錄查詢內容,也不與你的身分連結。
  • 資料為公開申報資料與市場資料的整理。本站不改寫申報數字;判讀文字只寫定義,不做推薦,screen 也不提供任何預設的條件組合。

常見問題

要付費嗎?

目前免費,不用註冊。有速率限制:匿名每分鐘 60 次、每日 5,000 次。

有即時報價嗎?

沒有。股價是收盤價、而且延遲至前一交易日(End-of-Day)。這是刻意的設計:交易所政策上,即時與 15 分鐘延遲的資料在 API 形式上都需要授權或事前核准,而隔日的收盤價不收費也不需要協議。這個端點是給基本面研究用的,不是看盤工具。

為什麼有些公司沒有市值和本益比?

在美國掛 ADR 的外國公司(申報 20-F 或 40-F 的約 1,300 家)不提供。它們的財報股數是普通股、股價是每單位 ADR,1 ADR 常等於 5 股,相乘會差好幾倍。這些公司多半也沒有標準化財報 —— 20-F 用 IFRS 分類,XBRL 標記的科目少很多。工具會明確說明原因,不會默默回空值。

季度財報為什麼有時候會跳過一季?

會計年度第四季的「單季」數字在 XBRL 裡大多不存在 —— 公司用 10-K 報全年,不會另外標那三個月。全市場的單季資料只有約 10% 落在會計 Q4。所以季序列在年度結束處會跳空,而近四季的合計是用「年度 + 年度後各季 − 去年對應各季」接出來的,工具會標明是怎麼接的。

法人持股(13F)為什麼是兩個月前的?

13F 的申報截止日是季末後 45 天,所以最新一季本來就會落後約兩個月。這是制度性的延遲,不是資料沒更新。

有法說會逐字稿嗎?

沒有。逐字稿基本上不在 SEC 申報裡,少數公司會當成 8-K 附件送出(每季約數十家),那些會出現在 investor_documents。財報新聞稿與投資人簡報則涵蓋得相當完整。

涵蓋多少家公司?

約 8,000 家在 SEC 申報的美國上市公司。但各項資料的覆蓋率不同:日線價量約 96%、產業分類 87%、標準化財報 75%、分析師覆蓋 53%。呼叫 data_status 可以看即時數字。

跟台股端點有什麼關係?

完全分開。這個端點只有美股工具,台股請用 toalpha.tw/mcp,台灣公開資訊觀測站請用 toalpha.tw/mcp/mops。接哪個端點就只會看到那個市場的工具。

其他端點

ToAlpha 目前有三個 MCP 端點,各自獨立、工具不重疊:

想要更多資料、發現數字有誤,或有想問 AI 卻問不出來的問題,寫信到 [email protected]

資料來源:SEC EDGAR 申報資料、FINRA 放空餘額、市場價量與分析師共識。ToAlpha 由臺律昇資訊有限公司經營,資料僅供參考,不構成投資建議。