tvscreener

📈 多市场股票技术分析数据管家

基于 TradingView 数据源的专业股票筛选工具,支持港股、A股及美股的多维度技术指标查询与实时市场数据分析。

收藏
12.3k
安装
3.4k
版本
v1.0.0
CLS 安全性认证2026-05-01
点击查看完整报告 >

使用说明

tvscreener 是一款专注于金融市场的数据查询技能,基于 Python 的 tvscreener 库与 TradingView 数据源对接,为投资者和分析师提供港股、A股、美股及 ETF 的实时技术指标查询服务。

核心用法:用户可通过预设的 Shell 脚本快速查询特定股票代码的技术指标快照,或使用自定义查询模式按字段(如 RSI、MACD、布林带、成交量等)和过滤条件筛选市场数据。技能支持 Python 3.10+ 环境,提供 query_symbol.py 单代码查询和 custom_query.py 多维度筛选两种主要使用模式,同时配备字段发现工具辅助用户定位所需的特定技术指标字段。

显著优点:数据源权威可靠,直接对接 TradingView 全球金融市场数据库;覆盖范围广泛,支持香港交易所、中国 A 股及美股等多个主流市场;技术指标全面,涵盖价格、涨跌幅、移动平均线、相对强弱指数、MACD、随机指标、布林带等二十余项专业指标;使用灵活,支持自定义字段组合与时间周期(interval)查询;文档完善,提供详尽的 API 参考和故障排查指南。

潜在缺点与局限性:对 Python 版本有硬性要求(>=3.10),低版本环境无法运行;时间周期字段(如 FIELD|60)在部分 tvscreener 版本中存在 FieldWithInterval 属性错误的已知问题;依赖管理较宽松,脚本使用 -U 参数自动更新依赖,缺乏版本锁定机制;作为 T3 来源的个人开发者项目,长期维护和更新稳定性存在不确定性。

适合的目标群体:主要面向金融数据分析师、量化交易研究者、证券投资者以及需要进行市场技术分析的金融从业者。特别适合需要批量获取多市场技术指标、进行股票筛选比对或构建自动化分析工作流的中高级用户。

使用风险:运行时需连接 TradingView API 和 PyPI 仓库,存在网络依赖风险;脚本自动执行 pip 安装操作,在不可信网络环境下可能面临供应链攻击风险;CSV 文件输出功能需用户自行确保输出路径的安全性,避免敏感文件被覆盖;高频或大规模数据查询可能触发 TradingView API 的速率限制;时间周期字段的兼容性问题可能导致特定查询失败,需准备降级方案。

安全解读

tvscreener 综合评估

核心用法

tvscreener 是一个 TradingView Screener API 的 Python 封装工具,专为股票数据查询和技术指标分析设计。核心工作流分为两层:

1. 快速查询层(推荐):使用 scripts/query_symbol.py 进行单股票快照,输入交易所代码(如 HKEX:700)即可获取完整技术指标面板
2. 自定义筛选层:通过 scripts/run_query.sh 组合字段与过滤器,支持复杂的市场扫描需求,如筛选 RSI 超卖、MACD 金叉等条件的股票池

技术指标覆盖全面,包含价格变动、成交量、RSI、MACD、多周期简单/指数移动平均线、布林带、随机指标、ATR 等 15+ 核心字段,支持多时间周期语法(如 FIELD|60 表示 60 分钟线)。

显著优点

  • 市场覆盖广:原生支持港股、A 股、A 股 ETF 及美股四大市场
  • 脚本即开即用:提供预设查询脚本,无需深入理解 TradingView GraphQL API 细节
  • 字段发现机制discover_fields.py 支持关键词检索可用指标,降低学习成本
  • 代码结构清晰:252 行、5 文件,功能单一聚焦,无冗余代码
  • 安全表现优秀:静态分析 95 分,无危险函数、无密钥硬编码、无威胁模式

潜在缺点与局限性

  • 依赖外部风险:核心功能完全依赖 tvscreener PyPI 包,该包由第三方维护,版本更新与安全修复存在不确定性
  • 来源可信度 T3:维护者 subway-chenyan 为个人开发者,非企业/知名组织,长期维护承诺存疑
  • 多时间周期字段不稳定FIELD|interval 语法在部分版本存在 FieldWithInterval 属性错误,需回退到基础字段或单股票查询
  • 无内置频率限制:高频调用可能触发 TradingView API 限流,脚本层未实现退避或缓存机制
  • 错误处理简陋:异常仅输出 stderr,缺乏结构化日志与重试逻辑

适合人群

  • 技术派个人投资者,需快速获取多市场技术指标
  • 量化策略原型开发者,进行股票池初筛与因子验证
  • 已有 Python 环境、熟悉 shell 命令的进阶用户

常规风险

  • 供应链风险:tvscreener 包被劫持或植入恶意代码将直接影响数据安全
  • API 可用性风险:TradingView 未公开承诺 Screener API 稳定性,存在接口变更或限流可能
  • 数据延迟风险:免费层级数据可能存在 15-30 分钟延迟,不适合高频实时交易

tvscreener 内容

references文件夹
api文件夹
scripts文件夹
手动下载zip · 14.5 kB
enums.mdtext/markdown
请选择文件