| name | stock-data-skill |
| description | 多数据源股票行情查询与分析，支持A股/港股/美股/指数，覆盖行情/K线/财务/技术指标/ETF/龙虎榜/板块等；当用户需要查股价、K线、财报、技术分析或市场数据时使用 |
实时股票数据 Skill
通过腾讯行情/新浪财经/腾讯自选股获取A股、港股、美股、指数的实时行情、历史数据、财务报表、技术指标及市场数据。所有调用走 python3 bin/_cli_wrapper.py（内部转发到 bin/stock-cli），agent 不需要知道 HTTP 细节。
网关说明：所有请求通过 data-provider 网关（COZE_DATA_GATEWAY_URL）转发到上游数据源，用于计费和鉴权。
何时使用
- 查询个股实时行情（价格、涨跌幅、成交量、市值、PE）
- 获取历史K线数据（日/周/月/分钟级，支持前复权/后复权）
- 按名称或拼音搜索股票代码
- 查看当日分时走势
- 技术面分析（MA/MACD/RSI/支撑压力位/缺口/综合信号）
- 查询财务报表（利润表/资产负债表/现金流量表）
- 查询技术指标（MA/MACD/KDJ/RSI/BOLL等）
- 查询ETF基金数据（详情/持仓/净值）
- 查询股东结构、分红数据、筹码成本
- 查询龙虎榜、大宗交易、融资融券
- 查看热搜股票/板块、投资日历、新股日历、板块行情
- 公司简况、业绩预告
何时不使用
- 需要新闻资讯 → 使用新闻类 skill
- 需要期货/期权数据 → 本 skill 不覆盖
快速开始
python3 ./bin/_cli_wrapper.py list
python3 ./bin/_cli_wrapper.py schema quote
python3 ./bin/_cli_wrapper.py call quote --param code=sh600519
python3 ./bin/_cli_wrapper.py call search --param keyword=茅台
python3 ./bin/_cli_wrapper.py call analyze --param code=sh600519
python3 ./bin/_cli_wrapper.py call finance --param code=sh600519
python3 ./bin/_cli_wrapper.py call technical --param code=sh600519
python3 ./bin/_cli_wrapper.py call etf --param code=sh510300
python3 ./bin/_cli_wrapper.py call lhb --param code=sh600519
python3 ./bin/_cli_wrapper.py call hot --param type=stock
本地联调时也可以直接运行 local-dev 构建的 ./bin/stock-cli-local list，但 coze claw 部署必须走 python3 bin/_cli_wrapper.py。Coze 托管凭证环境变量只在 Python 执行上下文注入，由 wrapper 透传给 Go CLI。
环境变量
| 变量 | 必填 | 默认 | 说明 |
|---|
COZE_DATA_PROVIDER_API_KEY_NEW_7639319066594918410 | Coze 生产必填 | — | Coze 托管凭证运行时注入的 data-provider 网关鉴权密钥；凭证名称/变量名配置为 DATA_PROVIDER_API_KEY_NEW |
COZE_DATA_GATEWAY_URL | ❌ | https://data.coze.cn | 网关地址，通常无需修改 |
COZE_DATA_PROVIDER | ❌ | stock | 网关路由 provider 名称 |
COZE_DATA_TIMEOUT_SEC | ❌ | 15 | 请求超时（秒） |
本地联调二进制必须使用 -ldflags "-X code.byted.org/stone/data-provider/pkg/dataproxy.BuildMode=local" 构建，读取 DATA_PROVIDER_API_KEY。Coze 生产二进制不加该 ldflags，读取 COZE_DATA_PROVIDER_API_KEY_NEW_7639319066594918410。
Coze 凭证配置要求：凭证名称 DATA_PROVIDER_API_KEY_NEW，变量名 DATA_PROVIDER_API_KEY_NEW，Header API Key 类型，域名 data.coze.cn，请求头位置 Authorization: Bearer <key>。
支持市场
| 前缀 | 市场 | 示例 |
|---|
| sh | 上交所 A 股 | sh600519（贵州茅台） |
| sz | 深交所 A 股 | sz000001（平安银行） |
| hk | 港股 | hk00700（腾讯控股） |
| us | 美股 | usAAPL（苹果） |
常用指数：sh000001（上证指数）、sz399001（深证成指）、hkHSI（恒生指数）
Operations
行情与分析（原有）
港股实时行情选择指南：
quote 查港股有 ~15 分钟延迟（受港交所免费行情授权限制），但字段丰富（涨跌幅、换手率、市值、PE 等）。minute 查港股 无延迟（走腾讯自选股内部接口，有实时授权），但仅返回时间、价格、累计成交量/成交额。- 优先级：查港股实时股价时优先用
minute（取最后一条即为最新价）；如果需要市值、PE、换手率等扩展指标且对时效无严格要求，再用 quote。
- A 股不受此限制，
quote 和 minute 均为实时。
财务与公司信息
技术指标与筹码
股东与分红
资金流向（按市场）
交易数据
ETF基金
市场总览
Exit Code
| code | 含义 |
|---|
| 0 | 成功 |
| 1 | 客户端用法错误（未知子命令 / 缺参 / 格式错） |
| 2 | 鉴权失败（env 缺失或上游 401/403） |
| 3 | 上游业务错误（4xx） |
| 4 | 上游服务错误（5xx） |
| 5 | 网络 / 超时 / 协议错 |
错误处理范式
output=$(python3 ./bin/_cli_wrapper.py call quote --param code=sh600519 2>err.log)
case $? in
0) echo "$output" | jq . ;;
3|4) echo "上游错误"; cat err.log ;;
5) echo "网络异常，建议重试"; cat err.log ;;
*) echo "用法错"; cat err.log ;;
esac
调用约定
- 股票代码格式：
{市场前缀}{代码}，如 sh600519、hk00700、usAAPL。前缀小写，美股 ticker 保留大写
- 多数据源自动切换：quote 操作依次尝试多个数据源，任一成功即返回。kline/search/minute 同理
- 技术分析两步走：
analyze 内部自动获取 K 线数据再计算指标，无需手动传入 K 线文件
- 派生指标：本 skill 未直接提供的指标（如 PB、PCF、PS、股息率等）可通过组合现有接口数据计算得出。例如：
- PB（市净率）= 总市值（
quote）÷ 净资产（finance 资产负债表）
- PCF（市现率）= 总市值（
quote）÷ 经营现金流净额（finance 现金流量表）
- PS（市销率）= 总市值（
quote）÷ 营业收入（finance 利润表）
- 股息率 = 每股分红（
dividend）÷ 当前股价（quote）
已知限制
行情与分析
- quote 依次尝试多个数据源，任一成功即返回；港股行情有 ~15 分钟延迟，查港股实时价格应优先用
minute
- minute 走腾讯自选股接口，A 股和港股均为实时无延迟，但字段仅含时间/价格/累计量
- kline 日/周/月走 fqkline，分钟线走 mkline；历史数据量上限约 120 根
- search 结果约 10 条，适合精确匹配/自动补全场景
- 技术分析至少需要 20 根 K 线才能给出有效信号
数据覆盖范围
- 龙虎榜（lhb）/大宗交易（blocktrade）/融资融券（margintrade）：仅支持沪深市场
- 筹码成本（chip）：仅支持沪深京A股
- 股东结构（shareholder）：仅支持A股和港股
- 货币单位：港股返回港元/美元，美股返回美元
不要做
- ❌ 不要试图绕过 CLI 直接 curl 数据源：所有请求必须通过网关转发，否则无法计费和鉴权
服务端配置（TCC）
需要在 TCC 的 http_proxy_config 中添加 provider 为 stock 的配置项：
{
"provider_name": "stock",
"base_url": "http://placeholder.stock",
"description": "Stock data multi-upstream proxy"
}
- ❌ 不要修改
bin/stock-cli 的源码（源码在 tools/stock-cli/）
- ❌ 不要修改
bin/_cli_wrapper.py：该脚本是 coze claw env 注入的唯一桥接入口，任何修改都可能导致凭证注入失败
- ❌ 不要修改
bin/_gateway_proxy.py（如存在）：该脚本是 skill 网关计费集成的唯一入口
- ❌ 不要把生产二进制编成本地模式（
BuildMode=local 仅限本机联调）
- ❌ 不要在 coze claw 部署时直接运行
./bin/stock-cli（会读不到托管密钥），必须走 python3 bin/_cli_wrapper.py
