tvscreener

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 的速率限制；时间周期字段的兼容性问题可能导致特定查询失败，需准备降级方案。