核心用法
Tencent Finance Stock Price 是一个基于腾讯财经开放 API 的 CLI 工具，用于快速查询 A 股、港股、美股的实时行情数据。无需 API Key，零配置即可使用。
两种模式：
- Compact 模式（默认）：输出名称、现价、涨跌额、涨跌幅、市值，适合快速盯盘
- Detail 模式（-d）：额外展示 PE(TTM)、PB、换手率、成交量/额、总股本/流通股本、52 周高低、开盘/收盘/最高最低价，适合深度分析
输入方式灵活：支持中文名自动映射（如「澜起科技」「小马智行」「英伟达」）、拼音、股票代码（sh688008 / hk00700 / usNVDA）及指数查询（上证指数、纳指 100 等）。
显著优点
- 零门槛：无需注册、无 API Key、无调用限制
- 多市场覆盖：A 股、港股、美股及主要指数一站式查询
- 本地化体验：中文名称智能映射，输出格式化对齐，支持 emoji 涨跌标识
- 轻量高效：单文件 Python 脚本，uv 直接运行，无依赖负担
潜在缺点与局限性
- 数据非官方：数据来源于腾讯财经公开 API（
qt.gtimg.cn），非交易所官方直连，延迟约 1-5 分钟，不适合高频交易决策 - 字段覆盖不均：港股缺少 PE/换手率，美股缺少流通市值/总股本，A 股缺少 52 周数据
- 编码限制：API 返回 GB2312 编码，特殊字符可能解析异常
- 无历史数据：仅支持实时快照，无 K 线、财务数据等深度功能
- 稳定性风险：依赖腾讯第三方接口，存在服务变更或限流可能
适合人群
- 个人投资者日常盯盘、快速比价
- 开发者集成行情数据到自动化脚本或量化策略原型
- 财经内容创作者获取格式化市场数据
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据准确性 | 非官方数据源，可能存在延迟或异常值，关键决策需交叉验证 |
| 服务可用性 | 腾讯 API 变更可能导致技能失效，需关注维护更新 |
| 合规风险 | 仅用于个人研究，不得用于金融产品设计或投资建议传播 |
| 隐私风险 | 无用户数据上传，但查询记录可能暴露关注标的，敏感场景注意使用环境 |