davidho27941 mcp-tradingview 使用注意事項
實戰中驗證過的行為與踩坑紀錄（2026-09 以台股 TWSE 標的驗證）。
1. Scanner API 限流（最重要）
get-symbol-data、get-symbol-data-batch、get-technicals-rating、get-financials 都打同一個
scanner.tradingview.com/<market>/scan 端點，很容易 429：
- 絕對不要平行呼叫這幾個工具 — 同一時間多個請求幾乎必定觸發 429。
- 429 之後恢復很慢：實測等 20 秒、60 秒都不夠，約 2 分鐘後才恢復。
- 正確做法：逐一序列呼叫，兩次呼叫之間自然有間隔即可；遇到 429 就用
Bash背景sleep 120等待後重試（不要密集重試，會延長冷卻）。 get-ohlcv、get-financial-history、get-forecasts、get-news、search-symbols走不同端點，scanner 被限流時它們仍可正常使用 — 可先做這些，把 scanner 呼叫留到最後。
2. 警報（Alerts）
create-alert建立後active: false— 建立不等於啟用！ 必須接著呼叫restart-alerts（帶 alert_ids）啟動，再用list-alerts確認active: true。- 預設有效期只有 30 天（now+30d），要更長需在
expiration明確指定 ISO 時間。 - 只支援單一價格條件（cross/cross_up/cross_down/greater/less），指標型（study）警報不支援。
- 把
alert_id留在回覆裡，之後 update/delete 會用到。
3. 資料品質注意
- 報價延遲 15 分鐘以上（
update_mode: delayed_streaming_900）。跟使用者呈現時要註明。 earnings_per_share_ttm欄位常回 null — 改用get-financial-history（period=fq） 抓近四季 EPS 自行加總得 TTM EPS。get-forecasts的estimates（eps_next_year、revenue_next_year 等）對台股有 單位錯亂問題（數值差 1~2 個數量級），且price_targets會被標記target_mismatch: true而排除 — 分析師目標價拿不到，estimates 不要直接引用。analyst_rating（買賣建議分布、人數）是可靠的。get-ohlcv的period_high/low可能與 screener 的price_52_week_high/low略有出入（調整方式不同），以 screener 欄位為準呈現 52 週區間。- OHLCV 的 volume 是股數（base units），不要加 $ 符號。
4. 台股（TWSE/TPEX）相關
search-symbols直接用中文公司名搜尋有效（會解析成 TWSE:XXXX / TPEX:XXXX）， 加type_filter: "stock"過濾雜訊（港股權證很多）。get-news用lang: "zh-Hant"— 台股新聞主要來源是公開資訊觀測站（MOPS） 的申報檔（財報、月營收、重大訊息），數量少；Reuters 產業稿偶有覆蓋。- 財報數據單位是新台幣元，呈現時換算成億較易讀（1 億 = 100,000,000）。
5. 觀察清單（Watchlists）
- 先
list-watchlists看現有清單再決定加入或新建，watchlist_id是數字字串。 add-to-watchlist對已存在的 symbol 會把它移到清單尾端（不會重複）。- 清單內容可含
###分類標題形式的 section 分隔項，處理 symbols 陣列時要略過。
6. 建議工作流程（研究一檔股票）
search-symbols（中文名可）→ 確認 EXCHANGE:TICKER- 非 scanner 類先做：
get-financial-history（fy 看長期、fq 看動能）、get-forecasts、get-news、get-ohlcv（summary=true 看區間統計） - scanner 類逐一序列做：
get-symbol-data（報價+估值+獲利欄位一次抓）→get-technicals-rating - 給使用者的分析必附：報價延遲聲明、非投資建議免責聲明