股票查询 / Stock Price Query

核心用法

stock-price-query 是一款轻量级实时股票行情查询技能，覆盖 A 股（沪深两市）、港股、美股三大市场。用户只需提供股票代码（如 600519、00700、NVDA）或常见股票名称（如茅台、腾讯、英伟达），即可秒级获取当前价格、涨跌幅、开高低收、成交量、成交额等完整行情数据。无需申请 API Key，零配置开箱即用。

显著优点

1. 三市场全覆盖：同时支持 A 股（sh/sz）、港股（hk）、美股（us），满足多元化投资需求
2. 零门槛使用：无需 API Key、无需注册、无需安装额外依赖，内置 Python 脚本直接调用免费公开行情接口
3. 智能识别：自动根据代码格式判断市场类型（6 位数字识别为 A 股，5 位及以下数字识别为港股，纯字母识别为美股）
4. 安全校验严格：输入参数经过正则过滤（^[A-Za-z0-9]{1,10}$）和白名单校验，防范命令注入风险
5. 输出友好：紧凑的非表格格式，适配飞书等 IM 场景，避免消息分页；智能单位转换（亿/万）

潜在缺点与局限性

1. 数据源依赖第三方：行情数据来自免费公开 API，存在服务不稳定、延迟或限流风险
2. 非官方实时数据：非交易所直连，数据更新频率和精度可能逊于专业终端
3. 名称映射有限：仅预设 10 只常见股票名称映射，陌生名称需用户手动提供代码
4. 无历史数据：仅支持实时行情，不提供 K 线、财务数据等深度分析功能
5. 无交易功能：纯查询工具，不支持下单、预警、自选等进阶功能

适合人群

• 普通投资者：日常快速查价、看涨跌
• 金融从业者：聊天场景下即兴行情核对
• 美股/港股关注者：跨境市场一站式查询
• 开发测试：需要零成本行情 API 的场景

常规风险

• 数据准确性：免费 API 可能存在数据延迟或异常，重大决策需交叉验证
• 服务可用性：第三方接口可能随时变更或限流，非生产环境高可靠首选
• 合规提示：技能仅提供行情展示，不构成投资建议，用户需自主判断

核心用法

stock-price-query 是一款轻量级实时股票行情查询技能，覆盖 A 股（沪深两市）、港股、美股三大市场。用户可通过股票代码（如 600519、00700、NVDA）或常见名称（如「茅台」「腾讯」）触发查询，脚本自动识别市场类型并返回当前价格、涨跌幅、开高低收、成交量等结构化数据。

显著优点

1. 零门槛使用：无需注册 API Key，无需第三方依赖，仅依赖 Python 标准库即可运行
2. 输入安全完善：严格的正则校验（^[A-Za-z0-9]{1,10}$）限制输入长度与字符类型，白名单机制防止命令注入
3. 智能市场识别：自动根据代码格式判断 A 股（6 位数字）、港股（5 位及以下数字）、美股（纯字母），降低用户操作成本
4. 异常处理健全：网络请求设置 10 秒超时，HTTP 429 限流时自动延迟 1 秒重试，非交易时段返回最近收盘数据
5. 输出格式友好：紧凑的 Emoji 格式展示，自动单位转换（成交额超 1 亿显示为「亿」），适配聊天场景

潜在缺点与局限性

• 外部依赖风险：数据来源于腾讯财经公开 API（qt.gtimg.cn），存在服务变更、限流或中断的可能
• T3 来源等级：个人开发者/社区项目，无 GitHub 溯源，历史信誉无法验证，需用户自行审计代码
• 无数据加密：API 调用通过 HTTP 传输，虽无敏感信息泄露风险，但不符合严格的数据加密传输要求
• 功能单一：仅支持实时行情查询，无历史 K 线、财务数据、技术分析等进阶功能
• 名称映射有限：常见股票名称硬编码在映射表中，不在表中的名称需用户提供准确代码

适合人群

• 个人投资者：需要快速查价、关注持仓涨跌的日常用户
• 财经聊天场景：在 IM 工具中随手查询股价，无需打开专业终端
• 轻度使用者：无需专业分析，仅关心当前价格与涨跌幅的非专业投资者

常规风险

| 风险类型 | 说明 | 缓解措施 |

|---------|------|---------|

| API 不可用 | 腾讯财经接口变更或限流 | 已内置重试机制，建议用户错峰查询 |

| 数据准确性 | 免费 API 数据可能存在延迟 | 关键交易决策请以交易所官方数据为准 |

| 来源可信度 | T3 等级，开发者身份未验证 | 建议审查 `scripts/stock_query.py` 后启用 |

| 网络请求 | 存在外部调用，依赖公网可达性 | 内网环境需确保出站 80/443 端口开放 |