核心用法
jisu-stock 是集成极速数据（Jisu Data）股票查询 API 的 OpenClaw 技能，提供三类核心功能：
1. 股票行情查询（`/stock/query`）：输入股票代码获取当日分钟级行情数据，包含最新价、昨收盘价、更新时间，以及按时间维度排列的趋势数组（时间、价格、成交量、成交总额、平均价），适合追踪日内波动。
2. 股票列表查询（`/stock/list`）：按市场分类（1-沪深股市、3-港股、4-北证A股）分页获取股票清单，支持自定义页码与单页数量，便于批量筛选或展示市场概览。
3. 股票详情查询（`/stock/detail`）：获取单只股票的完整基本面数据，涵盖最新价、最高/最低价、成交量、成交额、换手率、开盘价、涨跌幅、振幅、量比、市盈率（PER）、市净率（PBR）等关键指标，满足投资决策参考需求。
显著优点
- 数据覆盖全面：同时支持 A 股（沪深+北证）与港股，满足不同市场投资者的查询需求
- 分钟级 granularity：趋势数据精确到分钟级别，适合短线交易分析
- 财务指标完整：详情接口提供 PER/PBR 等估值指标，辅助基本面判断
- 轻量易用：命令行调用，JSON 输入输出，便于自动化集成
- 分页支持：列表查询支持分页，可处理大规模数据集
潜在缺点与局限性
- 第三方依赖：数据质量与稳定性完全依赖极速数据平台，存在服务商变更政策或接口调整的风险
- API Key 成本：需自行申请并配置
JISU_API_KEY，免费额度有限，高频调用可能产生费用 - 无历史数据：仅支持当日行情查询，无法获取过往日 K 或历史趋势
- 无实时推送：被动查询模式，非 WebSocket 实时流，数据存在分钟级延迟
- 港股数据限制：港股分类编号（3）与沪深/北证逻辑分离，跨市场对比需多次调用
- 错误处理单一：业务错误与系统错误码区分明确，但需调用方自行解析 JSON 错误体
适合人群
- 个人投资者：需要快速查询持仓或关注股票的实时行情与基本面数据
- 量化研究初学者：获取标准化分钟级数据用于策略回测原型开发
- 自动化交易系统：作为数据源组件集成至 Python 交易脚本
- 金融信息工具开发者：构建股票监控 Bot、行情推送服务等应用场景
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| API Key 泄露 | 密钥硬编码或日志泄露可能导致额度被盗用 | 使用环境变量注入，定期轮换 Key |
| 数据延迟风险 | 非交易所直连，存在分钟级数据延迟 | 关键交易决策需交叉验证官方数据源 |
| 服务可用性 | 第三方 API 可能因维护、故障或额度耗尽不可用 | 实现降级逻辑，缓存最近有效数据 |
| 合规使用 | 数据仅限个人学习研究，商用需授权 | 查阅极速数据服务条款，避免违规分发 |
| 市场覆盖缺失 | 不支持美股、期货、基金等其他资产类别 | 明确技能边界，扩展需求需另寻数据源 |