Stock Price Query

实时股票行情查询，支持 A 股、港股、美股及大盘指数，支持批量查询。无需 API Key。Real-time stock & index quotes for A-shares, HK & US markets. Batch supported.

Security Scan

The skill's code, instructions, and requirements match its stated purpose (querying real-time stock quotes via Tencent Finance) and do not ask for unrelated credentials or install arbitrary software.

Purpose & Capability

Name/description are for real-time stock quotes. The only declared runtime requirement is python3 and the included script performs HTTP GETs to qt.gtimg.cn to fetch stock data—this is proportional and expected for the stated purpose.

Instruction Scope

SKILL.md instructs the agent to run the included Python script which performs network requests to the Tencent Finance API. The instructions and script do not access other system files, environment variables, or external endpoints beyond qt.gtimg.cn. Note: outbound queries reveal requested tickers to the third-party API (expected for this skill).

Install Mechanism

No install spec; this is an instruction-only skill with a single Python script. Nothing is downloaded or written at install time, which is low-risk and consistent with the project's 'zero dependencies' claim.

Credentials

No environment variables, credentials, or config paths are required. The skill does not request secrets and the script does not read env vars or other credential stores.

Persistence & Privilege

The skill is not always-enabled and uses default autonomous-invocation behavior. It does not request permanent presence or modify other skills or system-wide settings.

Assessment

This skill appears coherent and implements its stated purpose by calling the public Tencent Finance API (qt.gtimg.cn) with Python. Before installing, be aware: (1) network access is required and every queried ticker is sent to the third-party API—do not query sensitive or private symbols you don't want logged by that service; (2) the skill owner is unknown—review or run the included scripts in a sandboxed environment if you have concerns; (3) the API is free and rate-limited (the script includes a single retry), so expect occasional 429 errors or failures; (4) input validation is present in code to mitigate injection, but if you plan to integrate this into automation, test edge cases and monitor requests. If any of these points are unacceptable, do not install or run it without further review.

Stock Price Query Skill

实时股票行情与大盘指数查询技能，覆盖 A 股（沪深两市）、港股、美股三大市场。支持单只查询和批量查询（一次查询多只股票对比），轻量无依赖，无需 API Key，适合聊天场景下的快速股价查询——秒级获取当前价格、涨跌幅、开高低收、成交量等行情数据。

Real-time stock quote and market index tool covering A-shares, Hong Kong, and US stocks. Supports batch queries for comparing multiple stocks in one call. Quick chat-friendly price checks with zero dependencies and no API key needed.

Overview

实时股票价格查询技能，支持查询 A 股（沪深两市）、港股和美股的实时行情数据。通过调用免费公开的行情 API 获取数据，返回结构化的股票信息。

When to Use

当用户的请求涉及以下场景时触发此技能：

• 查询股价："茅台多少钱"、"查一下宁德时代"
• 了解涨跌："腾讯今天涨了吗"、"00700 行情"
• 股票代码查询："600519"、"NVDA price"
• 多只对比："比亚迪和英伟达的股价"、"帮我看下茅台、腾讯和苹果"
• 批量查询："查一下这几只：600519, 00700, AAPL"
• 大盘指数："上证指数多少"、"大盘怎么样"、"恒指行情"
• 关键词触发："查股票"、"股票行情"、"stock price"

How to Use

查询流程

1. 解析用户输入：从用户消息中提取股票代码。如果用户提供的是中文名称，需先根据下方映射表将名称转换为股票代码（脚本仅接受股票代码作为输入）。
2. 识别市场：根据股票代码格式自动识别所属市场：
   • A 股沪市：以 sh 开头或 6 位数字以 6 开头（如 sh600519、600519）
   • A 股深市：以 sz 开头或 6 位数字以 0/3 开头（如 sz000001、300750）
   • 港股：以 hk 开头或纯数字 5 位及以下（如 hk00700、00700），港股指数为纯字母代码（如 HSI、HSCEI）
   • 美股：纯英文字母代码（如 AAPL、TSLA、GOOGL），美股指数以 . 开头（如 .IXIC、.DJI、.INX）
3. 执行查询脚本：运行 scripts/stock_query.py 获取实时数据。
4. 格式化输出：将结果以清晰友好的格式展示给用户。

脚本调用方式

单只查询：

python3 {{SKILL_DIR}}/scripts/stock_query.py <stock_code> [market]

批量查询（推荐用于多只对比）：

python3 {{SKILL_DIR}}/scripts/stock_query.py <code1,code2,code3>

参数说明：

• stock_code（必需）：股票代码，如 600519、AAPL、00700。批量查询时用逗号分隔，最多 20 只。
• market（可选）：市场标识，可选值为 sh（沪市）、sz（深市）、hk（港股）、us（美股）。不提供时脚本会自动识别。批量查询时不需要此参数（自动识别各只股票的市场）。

单只查询输出格式：JSON 对象：

{
  "code": "600519",
  "name": "贵州茅台",
  "market": "sh",
  "current_price": 1688.00,
  "change": 12.50,
  "change_percent": 0.75,
  "open": 1680.00,
  "high": 1695.00,
  "low": 1675.00,
  "prev_close": 1675.50,
  "volume": 2345678,
  "amount": 3956789012.50,
  "time": "2026-02-24 15:00:00",
  "status": "success"
}

批量查询输出格式：JSON 数组，每只股票一个对象：

[
  { "code": "600519", "name": "贵州茅台", "market": "sh", "current_price": 1688.00, "change": 12.50, "change_percent": 0.75, "status": "success", ... },
  { "code": "00700", "name": "腾讯控股", "market": "hk", "current_price": 420.60, "change": 5.20, "change_percent": 1.25, "status": "success", ... },
  { "code": "AAPL", "name": "APPLE", "market": "us", "current_price": 178.50, "change": -1.30, "change_percent": -0.72, "status": "success", ... }
]

常见股票名称与代码映射（供 agent 参考）

脚本仅接受股票代码作为输入，不支持中文名称。当用户提供股票名称时，agent 应先根据下表将名称转换为对应代码后再调用脚本：

大盘指数：

名称	代码	市场
上证指数/大盘	000001	sh
深证成指	399001	sz
创业板指	399006	sz
恒生指数/恒指	HSI	hk
国企指数/H股指数	HSCEI	hk
纳斯达克/纳指	.IXIC	us
道琼斯/道指	.DJI	us
标普500	.INX	us

热门个股：

名称	代码	市场
贵州茅台	600519	sh
中国平安	601318	sh
招商银行	600036	sh
工商银行	601398	sh
中国石油	601857	sh
比亚迪	002594	sz
宁德时代	300750	sz
五粮液	000858	sz
美的集团	000333	sz
腾讯控股	00700	hk
阿里巴巴	09988	hk
美团	03690	hk
小米集团	01810	hk
京东	09618	hk
苹果/Apple	AAPL	us
特斯拉/Tesla	TSLA	us
英伟达/NVIDIA	NVDA	us
微软/Microsoft	MSFT	us
谷歌/Google	GOOGL	us
亚马逊/Amazon	AMZN	us
Meta/Facebook	META	us

对于不在映射表中的股票名称，提示用户提供准确的股票代码。

输出格式要求

单只查询：查询成功后，以如下紧凑格式展示结果（不要使用表格，避免消息过长导致飞书分页）：

📈 **{股票名称}**（{股票代码}.{市场}）

💰 当前价格：{current_price} 元/港元/美元 | 📊 涨跌幅：{change} ({change_percent}%) ↑/↓
📅 行情时间：{time}
📊 今开 {open} | 最高 {high} | 最低 {low} | 昨收 {prev_close}
📦 成交量：{volume} | 成交额：{amount}

批量查询：多只股票依次展示，每只之间空一行：

📈 **贵州茅台**（600519.SH）
💰 1688.00 元 | 🟢 +12.50 (+0.75%) ↑

📈 **腾讯控股**（00700.HK）
💰 420.60 港元 | 🟢 +5.20 (+1.25%) ↑

📈 **APPLE**（AAPL.US）
💰 178.50 美元 | 🔴 -1.30 (-0.72%) ↓

涨跌幅为正时使用 🟢 和 ↑，为负时使用 🔴 和 ↓。成交额如果超过 1 亿，用"亿"为单位显示（保留两位小数）；超过 1 万不足 1 亿，用"万"为单位显示。

Edge Cases

• 输入安全校验：脚本在执行前会严格校验所有输入参数。stock_code 仅允许字母、数字和前导点号（正则 ^\.?[A-Za-z0-9]{1,10}$，前导点号用于支持美股指数代码如 .IXIC、.DJI、.INX），market 仅允许白名单值（sh/sz/hk/us）。任何包含特殊字符、shell 元字符或超长输入都会被拒绝，防止命令注入。
• 批量查询数量限制：一次最多查询 20 只股票，超出时返回错误提示。
• 批量查询部分失败：批量查询中如果部分股票代码无效，有效的股票仍正常返回结果，无效的会在对应位置返回错误信息。agent 应正常展示成功的结果，对失败的提示用户。
• 股票代码无效：返回 "无法识别该股票代码，请确认后重试。支持 A 股（6 位数字）、港股（5 位数字）、美股（英文字母）。"
• 网络请求失败：返回 "网络请求失败，请稍后重试。"
• 非交易时段：正常返回最近的收盘数据，并提示 "当前为非交易时段，显示的是最近一次的收盘数据。"
• 股票名称模糊：脚本不支持名称输入。如果用户提供的名称无法在映射表中匹配，agent 应提示用户提供准确的股票代码。
• API 限流：如遇到限流，等待 1 秒后重试一次，仍失败则提示用户稍后再试。