tradingview-mcp

TradingView MCP（ヘッドレス市場データ）

同梱のtradingview MCP サーバーを通じて市場データを取得します。TradingView の公開スキャナー API と Yahoo Finance を MCP 経由で利用します。**TradingView のデスクトップアプリもアカウントも不要です。**ほとんどのツールで API キーは必要ありません。サーバーはプラグイン一式（ポータブル／Codex パッケージではmcp.json、レガシークライアントでは.mcp.json）に含まれており、ローカルの stdio MCP プロセスに対応するホストで有効にすると起動します。39 個のツールは、プラグインのtradingview MCP 名前空間に表示されます（必要に応じて、クライアントの遅延ツール読み込み機能を使って読み込んでください）。スキルだけをインストールしても MCP サーバーはインストールされません。finance-data-providersプラグイン一式を使用するか、サーバーを別途設定してください。

**読み取り専用です。**ここでの操作によって取引が実行されたり、アカウントの内容が変更されたりすることはありません。

他のデータスキルではなく、このスキルを使う場面

ニーズ	スキル
株価、TA の概要、インジケーター評価、複数時間軸の一致状況	このスキル
取引所全体のスキャン：スクイーズ／出来高ブレイクアウト／上昇銘柄／下落銘柄	このスキル
先物（NQ、ES、CL、GC…）の概要、値動きの大きい銘柄、カテゴリー別の相場	このスキル
プレマーケット／時間外取引の価格	このスキル
オプションチェーンの簡易確認（bid／ask／IV／OI、グリークスなし）、異常な取引動向	このスキル（代替手段／ポジショニングのスキャン）
グリークス（delta／gamma／theta／vega）付きオプションチェーン、IV スキュー、契約数付きの満期日	tradingview-reader（デスクトップアプリ）
ウォッチリスト、アラート、TV ニュース、チャートの状態／スクリーンショット、カスタム列のスクリーナー	tradingview-reader（デスクトップアプリ）

目安として、価格／TA／スキャンに関する内容には、まずこのスキルを使ってください。設定は不要で、ユーザーの TradingView アプリを CDP 経由で再起動する必要もありません。グリークスやアカウントに紐づくデータ（ウォッチリスト、アラート、チャート）が必要な場合に限り、tradingview-readerを使ってください。

ステップ 1：要件を確認する

• uvがインストールされていること（brew install uv）。サーバーはuvx経由で実行され、初回起動時に自動インストールされます（初回の呼び出しには約 30 秒かかります）。
• Python 3.10～3.13。現在、固定された上流バージョンは Python 3.14 を除外しています。
• 任意：MARKETAUX_API_TOKENを設定すると、market_sentiment、financial_news、および複合分析のニュース関連処理が有効になります。

MCP ツールが見つからない場合は、プラグインを有効にした後でエージェントを再起動するようユーザーに依頼してください。市場データを推測した値で黙って置き換えないでください。

ステップ 2：必要最小限のツールを選ぶ

簡単な質問には、用途を絞った呼び出しを 1 回だけ行うことを優先してください。調査概要を作成する場合は、価格／スナップショット、TA、出来高、必要に応じてニュースなど、関連する独立した観点だけを組み合わせてください。出力を増やすためだけに、内容の重複する TA ツールを複数回呼び出すのは避けてください。

株価とスナップショット

ツール	用途
stock_prices(tickers)	一括株価取得。tickersには、カンマ区切りのEXCHANGE:SYMBOL（例："NASDAQ:NVDA,NYSE:DELL"）を指定します。1 回の呼び出しで最大 1,000 行を取得できます。OHLC と変動率。
yahoo_price(symbol)	単一銘柄の株価。Yahoo のシンボル表記を使います：AAPL、BTC-USD、SPY、^GSPC、^VIX、EURUSD=X、THYAO.IS。
stock_extended_hours(symbol)	米国銘柄のプレマーケット／時間外取引の価格。決算発表への反応や、夜間の値動きに使用します。
market_snapshot()	世界市場の一括スナップショット：主要指数、主要暗号資産、為替、主要 ETF。
bitcoin_market_pulse()	BTC の価格、ドミナンス、時価総額合計によるリスク状況。暗号資産を分析する前に呼び出してください。

テクニカル分析（単一銘柄）

ツール	用途
coin_analysis(symbol, exchange, timeframe)	1つの株式またはコインの標準的なテクニカル分析結果です。RSI、MACD、ボリンジャー評価、インジケーターの概要を確認できます。名前に「coin」とありますが、株式にも対応しています：coin_analysis("NVDA", "NASDAQ", "1D")。
multi_timeframe_analysis(symbol, exchange)	週足 → 日足 → 4時間足 → 1時間足 → 15分足のトレンドの一致を確認します。
combined_analysis(symbol, exchange, timeframe)	テクニカル分析、ニュース、センチメントを1回の呼び出しで確認します（ニュース関連の処理には MARKETAUX_API_TOKEN が必要です）。
multi_agent_analysis(symbol, exchange, timeframe)	テクニカル、センチメント、リスクの「議論」の概要を確認します。
volume_confirmation_analysis(symbol, exchange, timeframe)	値動きが出来高によって裏付けられているかを確認します。
smart_money_analysis(symbol, exchange, period, interval)	Yahoo の OHLCV データを使った蓄積／分配の代理指標です（バンカー／ホットマネー RSI の分割、バンカー・ファンド・オシレーター、CMF+MFI+OBV の複合指標）。計算式に基づく代理指標であり、実際の機関投資家の資金フローデータではありません。exchange のデフォルトは EGX です（.CA を付加します）。米国銘柄の場合は NASDAQ／NYSE を渡してください。

取引所全体のスキャン

ツール	用途
top_gainers / top_losers(exchange, timeframe, limit)	1つの取引所の値上がり銘柄／値下がり銘柄を確認します。
bollinger_scan(exchange, timeframe, bbw_threshold, limit)	BBW が低いスクイーズ候補を抽出します。
rating_filter(exchange, timeframe, rating, limit)	BB 評価 −3（強い売り）〜 +3（強い買い）で絞り込みます。
volume_breakout_scanner / smart_volume_scanner	出来高と価格のブレイクアウトを検出します。
consecutive_candles_scan / advanced_candle_pattern	ローソク足パターンをスキャンします。
stock_screener(country, stock_type, limit, …)	国（america、japan など）ごとに普通株／優先株をスクリーニングし、時価総額順に表示します。

先物（夜間取引／オーバーナイト）

ツール	用途
futures_market_overview(category, exchanges, limit)	出来高上位の先物契約を確認します。category：all / equity_index / energy / metals / agriculture / rates / forex / crypto_futures、exchanges：us / global。
futures_top_movers(direction, exchanges, limit)	本日の騰落率上位銘柄を確認します。
futures_category_snapshot(category)	1つのカテゴリーに属する全限月先物の OHLCV を確認します。例：equity_index → NQ、ES、YM、RTY。
futures_watchlist()	カテゴリーごとの標準的な期近限月銘柄リストを確認します。

オプション（米国株式 — グリークスなし）

ツール	用途
stock_options_chain(symbol, expiry)	1つの満期日のコールとプットを確認します（YYYY-MM-DD。省略時は最も近い満期日）。権利行使価格、最終価格、買値／売値、出来高、OI、IV、ITM フラグに加え、available_expiries の全リストを返します。データソース：Yahoo。デルタ／ガンマ／セータ／ベガには対応していません。グリークスには tradingview-reader を使用してください。
stock_options_unusual_activity(symbol, top_n, min_volume, expiries)	直近の満期日を対象に、出来高／OI 比率が高い権利行使価格を抽出します。決算前のポジショニング確認に使えます。

バックテスト

ツール	用途
backtest_strategy(symbol, strategy, period, interval, …)	1つの戦略（rsi、bollinger、macd、ema_cross、supertrend、donchian、rsi_pullback、keltner_breakout、triple_ema）を対象に、シャープレシオ、最大ドローダウン、勝率、バイ・アンド・ホールドとの比較を行います。Yahoo のシンボル表記を使用します。
compare_strategies(symbol, period, …)	9つの戦略すべてをランキング形式で比較します。
walk_forward_backtest_strategy(…)	過学習の判定付きで、学習用データとテスト用データに分けて検証します。

ニュースとセンチメント（MARKETAUX_API_TOKEN が必要です）

market_sentiment(symbol, category) · financial_news(symbol, category, limit)

地域別の追加機能

egx_*（エジプト証券取引所のツール群。egx_smart_money_scanner を含む）は、利用機会が限られます。また、スキャンツールの exchange パラメーターを使って、BIST、HKEX、SSE、SZSE、TWSE にも対応しています。

ステップ 3：入力を正規化する

1. ほとんどのスキャン／テクニカル分析ツールでは、exchange のデフォルトが KUCOIN（暗号資産！）です。米国株式では、必ず NASDAQ／NYSE を明示的に渡してください。
2. 3 種類のシンボル表記が併存しています。スキャナーツールではシンボルのみと exchange パラメーターを指定します。stock_prices では EXCHANGE:SYMBOL を指定します。Yahoo を利用するツール（yahoo_price、バックテスト、オプション）では、Yahoo のティッカー（BTC-USD、^VIX、THYAO.IS）を指定します。
3. 時間足：5m, 15m, 1h, 4h, 1D, 1W, 1M。株式市場での日中スキャンはデータがまばらな場合があるため、株式では 1D を優先してください。
4. ツール名は、記載されているものが正式名称です。README 風の別名（get_technical_analysis など）ではなく、coin_analysis と multi_timeframe_analysis を使用してください。

ステップ 4：結果を検証して解釈する

1. 結論を導く前に、タイムスタンプ、取引所、シンボル、取引セッション、通貨を確認してください。
2. 返されたエラーエンベロープは、空の結果ではなくエラーとして扱ってください。再試行可能かどうかとシンボルの候補を確認し、再試行可能と示されている場合でも、再試行は最大 1 回にしてください。
3. 幅広いスキャナーの結果は、おおよそ 10 行と質問に関連する列に絞り込んでください。
4. Yahoo のオプション IV は、チェーンの形状や OI／出来高のポジショニングを把握するのに適していますが、正確な IV ランクやスキューの把握には適しません。IV に敏感な分析は tradingview-reader で照合してください。
5. バックテストは過去のシミュレーションです。利用可能な場合は、期間、間隔、コスト、サンプルサイズ、ベンチマーク、ウォークフォワード結果を報告してください。予測として提示しないでください。

ステップ 5：ユーザーに回答する

まず回答を示し、その後に簡潔な根拠の表を提示してください。基準時刻とデータソースを記載し、不足しているフィールドや古いフィールドを明示して、観測された事実と解釈を分けてください。取引を伴う依頼への回答は、分析に徹し、読み取り専用にしてください。取引の実行や実行の申し出はせず、リスクとシナリオについて説明してください。