| name | stock-query |
| description | 查询全球股票实时行情（A 股、港股、美股）、ETF、场外基金、指数，支持批量查询、历史K线（含均线）与自选股管理。 TRIGGER when: 用户查询股价/行情/净值/历史K线/自选盈亏/大盘指数时。NOT for: 加密货币、期货、期权、外汇。
|
| license | MIT |
| compatibility | Requires curl, iconv, python3. macOS/Linux only. |
| metadata | {"version":"2.6.0","author":"asfamilybank","repo":"https://github.com/asfamilybank/stock-query"} |
| user-invocable | true |
| allowed-tools | ["Bash"] |
全球股票/ETF/基金/指数 实时价格查询
权限与操作范围
| 权限 | 声明用途 | 限制 |
|---|
network | scripts/sq.sh 内部调用行情 API | 仅限 qt.gtimg.cn、hq.sinajs.cn、push2.eastmoney.com、web.ifzq.gtimg.cn、query1.finance.yahoo.com、fundgz.1234567.com.cn、api.fund.eastmoney.com 七个数据源，不发送用户个人数据 |
shell | 执行 curl、iconv、grep、awk、mktemp | 仅操作 portfolio.csv；不执行任意命令 |
文件访问： 本 skill 仅在用户显式指令下读写 portfolio.csv 一个文件，优先查找 ~/.config/stock-query/portfolio.csv，其次兼容旧版安装目录（~/.openclaw/workspace/skills/stock-query/、~/.claude/skills/stock-query/、~/.agents/skills/stock-query/），无需配置任何环境变量。历史数据通过网络实时获取，不写本地文件。
自动触发范围： 文件操作（Command 1）不会自动触发，仅在用户明确发出增/删/改/查 portfolio 指令时执行。
⚠️ 凭证安全： portfolio.csv 仅应包含股票代码、名称、数量、自选价格。禁止存放账户密码、API 密钥、Token 或任何认证凭证。
前置依赖
| 工具 | 说明 |
|---|
scripts/sq.sh | 行情查询 CLI，内部使用 curl + iconv |
scripts/fmt.sh | 格式化输出工具，由 sq.sh --format 调用，依赖 python3，输出人类可读的 Markdown 表格 |
支持的市场与标的
| 市场 | 代码格式 | 示例 |
|---|
| 沪/深市股票、ETF、指数 | 6 位数字 | 601991、510300、000001 |
| 港股 | ≤5 位数字（自动补零） | 700、00700、09988 |
| 美股 | 英文 ticker | AAPL、TSLA、BIDU |
| 美股指数 | .DJI / .IXIC / .SPX | .DJI |
| 场外基金 | 6 位数字 | 014978、110011 |
工作流程
Step 0: 意图识别与 Command 路由
Meta 命令（最高优先级）：输入为 version、-v、--version、help、-h、--help（大小写不敏感）
→ 直接输出版本/帮助信息，不执行后续步骤
version 输出：
stock-query v2.6.0
help 输出：
stock-query v2.6.0 — 全球股票/ETF/基金/指数实时行情查询
用法：
/stock-query <代码> [代码2 ...] 查询一个或多个标的实时行情
/stock-query <代码> 历史 查询个股历史K线（默认近30个交易日）
/stock-query version 显示版本号
/stock-query help 显示本帮助
支持的市场：
A股（沪/深） 6位数字，如 601991 000001
港股 5位数字，如 00700 09988
美股 英文ticker，如 AAPL TSLA NVDA
美股指数 .DJI .IXIC .SPX
ETF 6位数字，如 510300 159915
场外基金 6位数字，如 014978
常用示例：
/stock-query AAPL
/stock-query 00700 09988
/stock-query AAPL 00700 601991 510300
/stock-query 600519 近60天日K
/stock-query TSLA 周K 最近20周
作者：asfamilybank · https://github.com/asfamilybank/stock-query
Command 1：Portfolio 文件管理：含操作词（添加/新增/删除/移除/修改/查看/列出）＋ 对象词（自选股/持仓/portfolio/watchlist），或明确指令如"把 AAPL 加到自选股"
→ 直接执行 Command 1，不进入 Command 2/3 流程
Command 3：历史行情查询：含关键词（历史/历史数据/历史行情/历史价格/历史走势/K线/日K/周K/月K）
→ 直接执行 Command 3，不进入 Command 2 流程
Command 2：行情查询（默认）：其余所有输入 → 进入 Command 2 流程（执行 Step 1–6）
静默执行原则（Claude 对话输出约束）
⛔ 严禁向用户输出任何中间推理或过程信息。 这是最高优先级约束，覆盖所有步骤。
本约束仅适用于 Claude 的对话文本输出。scripts/sq.sh stdout 仅输出结构化数据供 Claude 内部消费：行情/基金命令输出 JSON 数组，pfile 命令输出文件绝对路径或控制令牌 NOT_FOUND；stderr 输出错误/用法提示。scripts/fmt.sh 是格式化渲染层，接收 sq.sh 的 JSON 输出，输出供用户直接查看的 Markdown 表格（含涨跌 emoji、CJK 对齐、均线列）；其 stdout 为最终展示内容，非过程日志。两个脚本均不向用户界面打印任何过程信息。
以下内容绝对禁止出现在回复中：
- 市场/类型判断（如"014978 是场外基金"）
- 数据源切换说明（如"腾讯接口返回空，切换至东方财富："）
- 文件路径查找过程
- 任何形式的"正在..."、"切换..."、"尝试..."等过程性文字
唯一允许的输出： 最终结果表格，或无法查询时的错误提示。
Command 1: Portfolio 文件管理
所有增删改查操作必须通过 Bash 工具执行实际命令，禁止依赖会话记忆。未执行命令不得声称操作已完成。
文件定位（每次进入 Command 1 必须首先执行）
PFILE=$(bash scripts/sq.sh pfile)
echo "$PFILE"
- 输出
NOT_FOUND → 立即向用户输出下方创建引导，停止执行，不得创建任何替代文件
- 否则将
$PFILE 用于所有后续操作
portfolio.csv 不存在时，引导用户创建：
未找到自选股文件。请执行以下步骤创建：
1. 创建配置目录并复制模板：
mkdir -p ~/.config/stock-query
cp <skill安装目录>/assets/portfolio.csv ~/.config/stock-query/portfolio.csv
2. 编辑文件，填入你的自选股信息。
CSV 文件格式（参考 assets/portfolio.csv）：
代码,名称,数量,自选价格
601991,大唐发电,1000,4.00 # 含数量与参考价，输出浮盈亏
014978,华安纳指100C,10000, # 自选价格留空：只查行情
AAPL,,50,220.00 # 名称留空：自动从接口获取
000300,,0, # 数量为 0：纯自选
查
grep -v '^#' "$PFILE" | tail -n +2
格式化为表格展示，不查询实时行情。如需实时价格，使用 Command 2。
增
- 用
bash scripts/sq.sh get <code> 获取标的名称
- 执行：
if grep -q "^{code}," "$PFILE" 2>/dev/null; then
echo "DUPLICATE:{code}"
else
echo "{code},{name},{shares},{cost}" >> "$PFILE" && echo "ADDED:{code},{name},{shares},{cost}"
fi
ADDED:... → 展示添加结果；DUPLICATE:{code} → 询问是否改为修改操作
改
- 用
bash scripts/sq.sh get <code> 获取最新名称
- 执行：
OLD=$(grep "^{code}," "$PFILE")
if [ -z "$OLD" ]; then
echo "NOT_FOUND:{code}"
else
NEW="{code},{name},{shares},{cost}"
tmp=$(mktemp)
awk -F',' -v c="{code}" -v n="$NEW" \
'BEGIN{OFS=","} $1==c{print n;next}{print}' "$PFILE" > "$tmp" && mv "$tmp" "$PFILE"
echo "BEFORE:$OLD"
echo "AFTER:$NEW"
fi
- 展示修改前后 diff；
NOT_FOUND:{code} → 提示未找到
删
DEL=$(grep "^{code}," "$PFILE")
if [ -z "$DEL" ]; then
echo "NOT_FOUND:{code}"
else
tmp=$(mktemp)
grep -v "^{code}," "$PFILE" > "$tmp" && mv "$tmp" "$PFILE"
echo "DELETED:$DEL"
fi
DELETED:... → 展示删除结果；NOT_FOUND:{code} → 提示未找到
Command 2: 行情查询
Step 1: 解析用户输入
detail_mode 检测： 若用户消息含以下关键词，设 detail_mode = true，在 Step 3 输出详细表格：
- 中文：详细、详情、详细信息、更多信息、全部信息、完整信息
- 英文：detail、details、verbose、full
从用户消息中提取标的代码，支持以下形式：
- 6 位纯数字 → A 股（股票/ETF/指数/基金）
- ≤5 位纯数字 → 港股，自动补零（700 → 00700）
- 英文字母或英文+数字 → 美股 ticker
- 中文/英文名称 → 匹配下表常见标的；无法确定时向用户确认
常见标的速查：
A 股：
- 黄金ETF → 518880 / 红利低波ETF → 512890 / 沪深300ETF → 510300
- 卫星ETF → 563230 / 创业板ETF → 159915 / 中证500ETF → 510500
- 上证指数 → 000001 / 深证成指 → 399001 / 创业板指 → 399006
- 沪深300 → 000300 / 上证50 → 000016 / 中证500 → 000905 / 中证1000 → 000852
港股：
- 腾讯 → 00700 / 阿里巴巴 → 09988 / 美团 → 03690 / 小米 → 01810
- 比亚迪 → 01211 / 恒生指数 → HSI
美股：
- 苹果 → AAPL / 谷歌 → GOOG / 特斯拉 → TSLA / 英伟达 → NVDA
- 微软 → MSFT / 亚马逊 → AMZN / 百度 → BIDU / 阿里巴巴 → BABA
- 哔哩哔哩 → BILI / 拼多多 → PDD
- 道琼斯 → .DJI / 纳斯达克 → .IXIC / 标普500 → .SPX
Step 2: 查询并格式化输出
Step 2A: 执行命令（不得省略 --format 参数，单支/批量/任意市场均适用）
detail_mode = false → bash scripts/sq.sh get <code1> [code2 ...] --format table
detail_mode = true → bash scripts/sq.sh get <code1> [code2 ...] --format table --detail
Step 2B: 将命令的 stdout 原样作为回复返回
⛔ 不得解析 JSON 自行构建表格
⛔ 不得修改 emoji 字符（A股/港股：涨🔴跌🟢；美股：涨🟩跌🟥）
⛔ 不得添加、删除或重排列
⛔ 特别注意：港股跌幅用 🟢（非 🔴）。 A股、港股均遵循中国市场惯例：上涨 🔴，下跌 🟢，平盘 ⚪。命令输出已正确处理，勿覆盖。
Step 4: 自选市值计算（可选）
4a. 从 portfolio 文件加载
当用户指令涉及自选股（如"查我的自选股""看下自选股"），先定位文件再批量查询：
PFILE=$(bash scripts/sq.sh pfile)
- 输出
NOT_FOUND → 立即输出创建引导（见 Command 1），停止执行
- 否则读取文件，提取所有代码后用
sq get 批量查询
执行步骤（严格按序）：
Step A: 读取全部条目
codes_all = 文件中所有非注释、非表头行
codes_position = codes_all 中数量 > 0 的条目
codes_watch = codes_all 中数量 = 0 或空的条目
Step B: 批量查询
bash scripts/sq.sh get <codes_all 中所有代码>
Step C: 输出自选市值表（若 codes_position 非空）
横向宽表格：代码/名称/数量/自选价格/现价/市值/浮盈亏/盈亏比
Step D: 输出自选行情表（若 codes_watch 非空）← 必须执行，不得省略
标题"自选行情"，简表：代码/名称/现价/涨跌幅
⚠️ Step D 不得跳过。 数量=0 的条目不进市值表，但必须出现在 Step D。
输出示例：
| 代码 | 名称 | 数量 | 自选价格 | 现价 | 市值 | 浮盈/亏 | 盈亏比 |
|--------|---------|--------|---------|--------|----------|------------|------------|
| 601991 | 大唐发电 | 1000股 | 4.00 | 4.08 | 4,080 | 🔴 +80 | 🔴 +2.00% |
| AAPL | 苹果 | 50股 | 220.00 | 246.63 | 12,332 | 🟩 +1,332 | 🟩 +12.10%|
自选行情
| 代码 | 名称 | 现价 | 涨跌幅 |
|--------|--------|---------|------------|
| 000300 | 沪深300 | 4509.24 | 🔴 +0.38% |
| .DJI | 道琼斯 | 45216.14| 🟩 +0.11% |
4b. 用户手动提供自选信息
用 sq get 查询后，必须使用横向宽表格，禁止使用竖向键值对格式：
| 代码 | 名称 | 数量 | 自选价格 | 最新价 | 市值 | 浮盈/亏 | 盈亏比 |
|--------|----------|--------|---------|--------|-----------|--------------|--------------|
| 600519 | 贵州茅台 | 100股 | 1680.0 | 1725.0 | 172,500 | 🔴 +4,500 | 🔴 +2.68% |
| AAPL | 苹果 | 50股 | 220.0 | 251.49 | 12,574.50 | 🟩 +1,574.50 | 🟩 +14.31% |
汇总行：
📊 自选合计：市值 185,074.50 | 总参考成本 179,000 | 浮盈 +6,074.50（+3.39%）
浮盈亏 emoji 遵循市场规则（A股/港股：盈利🔴亏损🟢；美股：盈利🟩亏损🟥）。跨市场汇总时提示用户各币种分开统计。
CSV 解析规则：# 开头为注释，第一个非注释行为表头，名称列为空时从查询结果自动填充，自选价格为空时浮盈亏显示 —。
Command 3: 历史行情查询
意图解析
从用户输入中提取以下参数（均可省略，使用默认值）：
标的代码：同 Step 1 规则。
周期（默认 day）：
| 用户表述 | 参数 |
|---|
| 日/天/日K/daily | --period day |
| 周/周K/weekly | --period week |
| 月/月K/monthly | --period month |
数量/区间：
- "近N天/周/月"、"最近N条"、"过去N" →
--count N
- "从 YYYY-MM-DD 到 YYYY-MM-DD"、"2024年1月到3月" →
--start ... --end ...（转为 YYYY-MM-DD 格式）
- 未指定 → 默认 30 条
复权（默认前复权）：
| 用户表述 | 参数 |
|---|
| 前复权（默认） | --fq pre |
| 后复权 | --fq post |
| 不复权/原始价格 | --fq none |
数据获取与格式化输出
bash scripts/sq.sh hist <code> [--period day|week|month] [--count N] [--start YYYY-MM-DD] [--end YYYY-MM-DD] [--fq pre|post|none] --format table
直接执行上述命令，将输出原样呈现给用户。--format table 已内置所有格式化逻辑：倒序 K 线表格、标题行（标的/周期/复权/条数）、区间统计、emoji 涨跌规则、成交量单位换算。
交易时间参考
| 市场 | 交易时段（当地时间） | 时区 |
|---|
| A 股/ETF | 工作日 09:30-11:30, 13:00-15:00 | UTC+8 |
| 场外基金估值 | 工作日 09:30-15:00 | UTC+8 |
| 港股 | 工作日 09:30-12:00, 13:00-16:00 | UTC+8 |
| 美股 | 工作日 09:30-16:00（北京时间 夏令时 21:30-04:00） | UTC-4/-5 |
| QDII 基金 | 净值 T+2 至 T+7 公布 | — |
