tradingview-mcp

TradingView MCP（无头市场数据）

通过捆绑的 tradingview MCP server 获取市场数据——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……）概览、异动品种、类别报价	此技能
盘前 / 盘后价格	此技能
快速查看期权链（买价/卖价/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 工具，请让用户在启用插件后重启 Agent。不要默默用编造的数据替代市场数据。

第 2 步：选择最少但有用的工具集

简单问题优先使用一次有针对性的调用。撰写研究简报时，只组合相关的独立视角：价格/快照、TA、成交量，以及可选的新闻。避免仅为生成更多输出而调用多个相互重叠的 TA 工具。

报价与快照

工具	用途
stock_prices(tickers)	批量报价。tickers 是以逗号分隔的 EXCHANGE:SYMBOL（例如 "NASDAQ:NVDA,NYSE:DELL"），单次调用最多返回 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)	单个股票或加密货币的标准 TA 读数——RSI、MACD、布林评级、指标摘要。尽管名称中有 coin，它也支持股票：coin_analysis("NVDA", "NASDAQ", "1D")。
multi_timeframe_analysis(symbol, exchange)	周线 → 日线 → 4H → 1H → 15m 趋势一致性分析。
combined_analysis(symbol, exchange, timeframe)	一次调用完成 TA、新闻和情绪分析（新闻部分需要 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)	查看单个交易所的涨跌幅榜。
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	K 线形态扫描。
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)	查看某一类别中所有近月合约的 OHLCV——例如 equity_index → NQ、ES、YM、RTY。
futures_watchlist()	各类别近月代码的标准列表。

期权（美股——不含希腊值）

工具	用途
stock_options_chain(symbol, expiry)	查看某一到期日的看涨期权和看跌期权（格式为 YYYY-MM-DD；省略则使用最近到期日）。返回行权价、最新价、买价/卖价、成交量、OI、IV、价内标记，以及完整的 available_expiries 列表。数据来源：Yahoo。不含 delta/gamma/theta/vega——希腊值请使用 tradingview-reader。
stock_options_unusual_activity(symbol, top_n, min_volume, expiries)	扫描最近到期日中成交量/OI 比率最高的行权价——用于财报发布前的仓位扫描。

回测

工具	用途
backtest_strategy(symbol, strategy, period, interval, …)	使用单一策略（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. 在大多数扫描／TA 工具中，exchange 默认值为 KUCOIN（加密货币！）——对于美国股票，务必显式传入 NASDAQ／NYSE。
2. 三种代码格式并存：扫描器工具接受不带前缀的代码和 exchange 参数；stock_prices 接受 EXCHANGE:SYMBOL；由 Yahoo 驱动的工具（yahoo_price、回测、期权）接受 Yahoo 代码（BTC-USD、^VIX、THYAO.IS）。
3. 时间周期：5m, 15m, 1h, 4h, 1D, 1W, 1M。在股票交易所进行的日内扫描可能数据稀疏——股票优先使用 1D。
4. 工具名称以列出的规范名称为准。使用 coin_analysis 和 multi_timeframe_analysis，不要使用 README 风格的别名，例如 get_technical_analysis。

第 4 步：验证并解读结果

1. 得出结论前，检查时间戳、交易所、代码、交易时段和货币。
2. 将返回的错误封套视为错误，而非空结果。参考其是否可重试以及代码建议；只有标记为可重试时，才最多重试一次。
3. 将较宽泛的扫描结果筛选至约 10 行，并仅保留与问题相关的列。
4. 将 Yahoo 期权 IV 视为适用于判断期权链形态以及 OI／成交量分布的数据，而非精确的 IV 排名或偏斜。涉及 IV 的工作应通过 tradingview-reader 交叉核对。
5. 回测是历史模拟。尽可能报告时间段、间隔、成本、样本量、基准和前向滚动测试结果；不要将其作为预测呈现。

第 5 步：回复用户

先给出答案，再展示简明的证据表。注明数据截至时间和数据来源，指出任何缺失或过时的字段，并将观测事实与解读分开。对于交易类请求，保持分析性且仅限只读：讨论风险和情景，不要下单或提出代为下单。