核心用法
Tencent Finance Stock Price 是一个通过腾讯财经开放接口（qt.gtimg.cn）获取实时行情数据的命令行工具。无需申请API密钥，无调用频率限制，支持中港美三大市场的股票代码自动识别与字段解析。
调用方式：
- 紧凑模式（默认）：输出名称、现价、涨跌额、涨跌幅、市值
- 详情模式（
--detail）：扩展输出PE-TTM、PB、成交量、成交额、换手率、总股本、52周高低点等深度指标
代码格式：A股需前缀sh/sz（或纯数字自动补全），港股强制hk前缀，美股强制us前缀，支持指数查询如sh000001。
显著优点
1. 零门槛接入：无注册、无鉴权、无配额限制，适合快速原型与脚本自动化
2. 跨市场统一接口：单命令同时查询sh688008（澜起科技）、hk00700（腾讯）、usNVDA（英伟达）
3. 字段自动适配：根据市场类型（A/HK/US）动态解析PE、PB、市值单位（亿CNY/HKD/USD）
4. 本地化输出：中文名称、货币单位、涨跌色标（🟢🔴），符合国内用户习惯
5. 轻量依赖：基于Python标准库与requests，uv/pip均可一键运行
潜在缺点与局限性
- 数据权威性有限：非交易所官方直连，存在10秒-1分钟延迟，不适合高频交易决策
- 字段覆盖不均：港股PE数据缺失（API未返回），部分美股字段位置与A股不同
- 无历史数据：仅实时快照，不提供K线、财报、资金流向等深度分析
- 稳定性风险：腾讯未公开服务SLA，接口变更或限流可能导致脚本失效
- 合规灰色地带：未明确授权的商业批量调用可能触发反爬机制
适合人群
- 个人投资者快速盯盘、自建终端
- 量化研究员获取免费实时数据做策略回测前的样本验证
- 开发者构建股票提醒机器人、Excel/Notion自动同步工具
- 财经类内容创作者批量获取行情截图素材
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| 数据准确性 | 非官方数据源，可能存在延迟或异常值 | 关键交易决策前交叉核对交易所官网 |
| 服务可用性 | 无SLA保障，存在突发限流或接口下线 | 本地缓存+多源备份（如备用Yahoo Finance） |
| 合规风险 | 大规模自动化调用可能违反腾讯Robots协议 | 控制请求频率（<1次/秒），避免商业转售 |
| 安全风险 | 脚本来源需验证，防止供应链投毒 | 审查`query_stock.py`源码，沙箱首次运行 |