股票查询 / Stock Price Query

核心用法

stock-price-query 是一款轻量级实时股票行情查询技能，支持 A 股（沪深两市）、港股、美股 三大市场。用户可通过股票代码（如 600519、00700、NVDA）或常见中文名称触发查询，自动识别市场类型并返回结构化行情数据。

调用流程：解析用户输入 → 名称转代码（如有映射）→ 自动识别市场 → 执行 stock_query.py → 格式化输出。脚本输出 JSON 包含当前价、涨跌幅、开高低收、成交量、成交额及时间戳。

特色输出：采用紧凑文本格式（非表格），自动处理单位换算（成交额超亿显示"亿"）、涨跌箭头标识，适配 IM 聊天场景避免分页截断。

显著优点

• 零配置开箱即用：无需 API Key，无额外依赖，仅需 Python3 环境
• 多市场覆盖：同时支持 A 股（sh/sz）、港股（hk）、美股（us），满足跨境投资需求
• 输入容错智能：支持纯代码、带前缀代码、常见中文名称多种输入方式
• 安全加固：输入正则校验（^[A-Za-z0-9]{1,10}$）+ 市场白名单，防范命令注入
• 异常处理完善：网络失败、非交易时段、API 限流均有明确降级策略

潜在缺点与局限性

• 数据源依赖：使用免费公开行情 API，数据延迟约 15 分钟至数秒不等，非交易所直连实时流
• 名称映射有限：仅内置 10 只常见股票名称映射，非标名称需用户手动提供代码
• 无历史数据：仅支持当前快照查询，无法获取 K 线、分时走势或财务数据
• 美股时区敏感：非美股交易时段可能返回 stale 数据，需用户自行判断时效性
• 无持仓管理：纯查询工具，不支持模拟交易、盈亏计算或自选股列表

适合人群

• casual 投资者：快速查持仓股价、关注自选股涨跌，无需专业终端
• 多市场交易者：同时关注 A 股、港股、美股，厌倦切换多个 App
• IM 场景用户：在飞书/钉钉/微信群聊中快速分享行情，追求信息密度
• 轻量化需求者：不愿注册证券账户 API、不想配置复杂金融数据接口

常规风险

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

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

| 数据准确性 | 免费 API 可能存在延迟或异常值 | 关键交易决策请以券商 APP 为准 |

| 命令注入 | 虽经正则过滤，但仍属外部输入执行 | 已限制 alnum 字符，避免 shell 元字符 |

| API 可用性 | 第三方服务可能变更或限流 | 内置 1 秒重试机制，失败时明确提示 |

| 合规提示 | 非持牌金融信息服务 | 输出含免责声明，不构成投资建议 |

核心用法

该技能为实时股票行情查询工具，支持 A 股（沪深两市）、港股、美股三大市场。用户可通过股票代码或名称触发查询，系统自动识别市场类型并调用 stock_query.py 脚本获取数据。脚本接受标准股票代码（如 600519、AAPL、00700），返回包含当前价格、涨跌幅、开高低收、成交量、成交额等字段的结构化 JSON 数据。

关键特性：

• 名称自动映射：内置常见股票名称与代码映射表（茅台→600519、腾讯→00700、苹果→AAPL 等），降低用户使用门槛
• 智能市场识别：根据代码格式自动判断所属市场（沪市 sh、深市 sz、港股 hk、美股 us）
• 友好输出格式：以紧凑的 emoji 格式化文本展示行情，避免表格导致的分页问题

显著优点

1. 零依赖部署：仅使用 Python 标准库（urllib, json, re, sys, time），无第三方依赖，彻底消除供应链攻击面
2. 无需 API Key：直接调用腾讯财经公开 API，开箱即用，无配置门槛
3. 输入安全严格：股票代码正则校验 ^[A-Za-z0-9]{1,10}$，市场参数白名单限制（sh/sz/hk/us），有效防止命令注入
4. 隐私合规优秀：不收集用户敏感信息，仅传输公开股票代码，符合 GDPR 数据最小化原则
5. 轻量高效：代码仅 246 行可执行逻辑，响应迅速，适合聊天场景即时查询

潜在缺点与局限性

1. 数据源单一：仅依赖腾讯财经 API（qt.gtimg.cn），无备用数据源，API 故障或限流时可用性受限
2. 无缓存机制：每次查询均发起新 HTTP 请求，高频使用易触发 API 限流（429 错误）
3. 名称覆盖有限：股票名称映射表仅包含常见标的，小众股票需用户手动提供准确代码
4. 非交易时段提示弱：虽能返回收盘数据，但缺乏对交易状态的明确标识
5. 功能边界清晰：不支持 K 线历史数据、技术指标、财务数据等深度分析功能

适合人群

• 普通投资者：需要快速查看持仓或关注股票实时价格的日常用户
• 聊天场景用户：在 IM 工具中随口询问股价的轻量需求场景
• 安全敏感环境：对第三方依赖有严格限制的企业内网或沙箱环境
• 开发测试用途：需要股票行情 API 调用示例的开发者

常规风险

| 风险类型 | 等级 | 说明 |

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

| 网络依赖风险 | 低 | 需访问外部 API，网络隔离环境不可用；但使用 HTTPS 加密传输 |

| API 稳定性风险 | 低 | 腾讯财经为知名金融服务，但免费 API 可能调整或限流 |

| 数据准确性风险 | 低 | 实时行情数据通常延迟 15 秒左右，不适用于高频交易决策 |

| 输入注入风险 | 极低 | 正则+白名单双重校验，已通过安全认证 |

| 隐私泄露风险 | 极低 | 不收集敏感信息，仅传输公开股票代码 |

使用建议：该技能适合作为日常快速查价工具，不宜作为投资决策的唯一依据。建议在高频查询场景下增加调用间隔，避免触发 API 限流。