# MCP Tradingview Usage

> Practical usage notes and known pitfalls for the mcp-tradingview MCP server (rate limits, alert activation, data quality caveats). Use whenever calling any mcp__mcp-tradingview__* tool — querying quotes, financials, technicals, forecasts, news, screeners, or managing alerts and watchlists, especially for Taiwan (TWSE/TPEX) symbols.

- Skill: `davidho27941/mcp-tradingview-usage` (Agent Skill)
- Install (CLI): `npx skillmds@latest add davidho27941/mcp-tradingview-usage`
- Raw SKILL.md: https://api.skillmd.com/api/skills/davidho27941/mcp-tradingview-usage/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: davidho27941 (https://skillmd.com/u/davidho27941)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/davidho27941/mcp-tradingview-usage

---


# 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. 建議工作流程（研究一檔股票）

1. `search-symbols`（中文名可）→ 確認 EXCHANGE:TICKER
2. 非 scanner 類先做：`get-financial-history`（fy 看長期、fq 看動能）、
   `get-forecasts`、`get-news`、`get-ohlcv`（summary=true 看區間統計）
3. scanner 類逐一序列做：`get-symbol-data`（報價+估值+獲利欄位一次抓）→
   `get-technicals-rating`
4. 給使用者的分析必附：報價延遲聲明、非投資建議免責聲明