name: stock-api-analyzer

description: OpenClaw 九宽量化股票 API 数据分析：涨跌停、板块、选股、财务、多空雷达、RPS 等 50+ REST（/api/v1/），输出客观数据解读与结构化报告，附风险提示与免责声明，不提供投资建议。需在 {baseDir}/config.json 配置 api_key（九宽后台联系获取），对接 https://9quant.online，多数接口需 VIP。 homepage: https://9quant.online metadata: {"openclaw":{"emoji":"📊","homepage":"https://9quant.online"}}

Stock API Analyzer Skill（OpenClaw）

版本: 1.3.0
类型: OpenClaw Agent Skill
作者: 九宽量化团队
分类: 金融数据
运行环境: OpenClaw

描述

面向 OpenClaw 的股票 API 分析 Skill，帮助用户通过自然语言查询、解读九宽量化智能分析系统 50+ 个 REST 接口（api_knowledge.json 知识库，路径前缀 /api/v1/），并基于接口返回数据输出结构化分析报告。仅做客观数据解读，不提供投资建议或仓位/买卖建议；报告须包含风险提示与免责声明。

对接线上服务，需在 config.json 中配置有效 API Key（请求头 X-API-Key）；多数行情与统计类接口需 VIP 权限。获取 API Key 请通过九宽后台联系。

能力

• 自然语言意图识别：支持「昨日」「去年三季报」「RPS 分段」「多空雷达」等中文话术，自动匹配接口与参数
• API 智能查询：对照 api_knowledge.json 选择单接口或多接口组合
• 参数辅助配置：日期区间统一驼峰 startDate / endDate；单日接口用 date；股票名先走搜索再查详情
• 时间语义解析：昨日/今天、季报披露季、净利润断层公告密集期等
• 数据专业解读：识别最新交易日核心指标、涨跌停情绪、板块结构与财务信号
• 组合分析：市场环境、板块结构、个股指标、业绩数据等场景的多 API 联合分析

工具依赖（OpenClaw）

• web_fetch / HTTP 工具：调用九宽 GET API（需配置 api_key）
• search（可选）：检索 {baseDir}/api_knowledge.json、{baseDir}/prompts/system_prompt.md
• calculate（可选）：涨跌幅、占比、区间统计等数值计算

配置

编辑 {baseDir}/config.json（即本 skill 安装目录下的 config.json）：

{
  "api_base_url": "https://9quant.online",
  "api_key": "your_api_key_here",
  "api_timeout": 30,
  "enable_caching": true,
  "cache_ttl": 300,
  "max_retries": 3,
  "retry_delay": 1,
  "headers": {
    "Content-Type": "application/json"
  }
}

URL 拼接规则

OpenClaw 调用时：url = api_base_url + endpoint（endpoint 取自 {baseDir}/api_knowledge.json），不会在 base 上再自动追加 /api/v1。

与旧版 SKILL 配置的差异

若仍填写 https://9quant.online/api/v1，会拼成 .../api/v1/api/v1/... 导致 404。新部署请使用站点根地址 https://9quant.online。

API Key 获取

通过九宽 后台/客服 联系，申请或获取 API Key。写入 {baseDir}/config.json 的 api_key 字段。鉴权失败（如 HTTP 403）时提示用户后台联系获取，勿伪造数据。更多说明见 README.md。

使用示例

1. 查询昨天的涨停股票 limit，type=U，分析涨停数量、板块分布、首板情况
2. 昨日涨停今日表现 limit_yesterday_today，分析延续性与市场情绪
3. 陶博士选股 tdx_stock_list：口袋支点、月线反转、火车每日观察
4. 净利润断层选股 profit_gap，支持「去年三季报」等语义，映射披露密集期
5. RPS 突破策略 rps_tp；支持「昨日 RPS 突破」等昨日语义
6. 全市场多维筛股 all_stocks：RPS、市值、概念、基金持股等组合筛选
7. 个股日线深度 先 stock_search 解析代码，再 stock_daily_detail（RPS、新高新低、均线等）
8. 市场环境综合判断 组合 market_golden_score、daily、limit、ths_mainstream、big_index，可加 dashboard_indicator
9. 市场高阶量化指标 pro_quant_indicator：startDate、endDate（驼峰）
10. 多空雷达（看板合成） dashboard_indicator：牛熊指标、转折、抄底/逃顶
11. 高级日统计（RPS/市值分段） daily_statistics_pro：成交额结构、分段宽表
12. 板块与指数 同花顺：ths_mainstream、ths_index_members、live_ths_index_top_sectors
    通达信：主流板块监控 tdx_mainstream、转强 tdx_strong_turning、新增/消失 tdx_add_del（index_type：n/i/all）
    申万：sw_index 系列
13. 盘中实时 live_daily、live_ths_index、live_ths_index_top_sectors
14. 财务与业绩 q_show、q_forecast 及 finance_* 系列
15. ETF / 龙虎榜 / 其它 etf_statistics、etf_daily_history、longhu、n_days_high、trade_date 等

详细「意图→接口」映射见 {baseDir}/prompts/system_prompt.md。

支持的 API 分类（知识库 50 个接口）

1. 基础数据（1）
2. 股票搜索 stock_search
3. 市场数据（12）
4. 涨跌停、昨日涨停今日表现、RPS 强势股、市场日线统计
5. 高阶量化指标、多空雷达、高级日统计（RPS+市值分段）
6. 市场黄金指标、主流板块、大盘指数、实时市场、指数序列 big_index_data
7. 板块 / 指数（16）
8. 同花顺：指数、成分股、详情、转强、新增退出主流、实时指数、今日板块排行
9. 申万 / 通达信：指数、成分股、详情、主流板块、转强、新增退出
10. 股票数据（2）
11. 全市场股票列表、个股日线统计
12. 选股策略（4）
13. 陶博士选股、RPS 突破、净利润断层、N 日新高
14. 财务数据（8）
15. 季报、业绩预告、三大报表、财务指标、量化指标、综合财务
16. 龙虎榜 / 资金（3）
17. 龙虎榜、龙虎榜详情、股东增减持
18. ETF / 其它（4）
19. ETF 统计、ETF 日线历史、个股调研、交易日历

完整字段与参数以 {baseDir}/api_knowledge.json 为准；调用前勿编造未文档化字段。

输出原则

• 分析内容必须来自 API 实际返回，禁止臆造数值
• 禁止输出：投资建议、买卖/仓位/止损止盈建议、操作策略类指引
• 可对指标做客观描述、同比环比、涨跌分布与多空/强弱等数据信号归纳（表述为「数据显示…」而非「建议买入/减仓」）
• 必须在报告末尾包含「风险提示」与「免责声明」章节（见下方输出格式）

输出格式

每个查询生成结构化数据分析报告（模板与 {baseDir}/prompts/system_prompt.md 一致）：

📊 【九宽量化数据分析报告】{日期}

## 一、数据来源
📌 API 接口：{接口名称}
📌 查询参数：{参数列表}
📌 数据时间：{数据时间范围}

## 二、数据分析
### 2.1 市场环境（指标摘要）
### 2.2 核心数据（关键字段与对比）
### 2.3 数据信号（看涨/看跌/中性，基于字段阈值或统计，非操作建议）

## 三、数据要点与异常
### 3.1 关键发现
### 3.2 需关注的字段或缺口（如缺失、极值、与历史差异）

## 四、风险提示
- 主要风险：{基于数据的市场波动、样本局限、指标滞后等客观风险点}
- 数据局限：{接口权限、查询时点、字段覆盖等说明}

## 五、关注要点（可选）
- 关注指标：{需持续跟踪的 API 字段或统计}
- 关键节点：{重要时间节点}

---
⚠️ **免责声明**：本分析基于历史数据与 API 返回结果，仅供数据参考，不构成投资建议。股市有风险，投资需谨慎。请根据自身情况独立判断，并承担相应风险。

在 OpenClaw 中安装

1. 将 stock-api-analyzer 目录复制到 ~/.openclaw/skills/stock-api-analyzer/（或工作区 skills/stock-api-analyzer/）。
2. 编辑 {baseDir}/config.json，填入 api_key；无密钥请 后台联系 获取。
3. 在 OpenClaw 中注册并启用本 skill，重启或重载 skills。
4. 在对话中直接提问（如「查询昨天涨停股票」「最近一周多空雷达」）。

目录结构

stock-api-analyzer/
├── SKILL.md                    # 本文件（OpenClaw 技能说明）
├── config.json                 # API 地址与密钥
├── api_knowledge.json          # 50+ 接口知识库
├── prompts/
│   └── system_prompt.md        # 系统提示词（意图映射、输出规范）
├── examples/
│   ├── scenario_1_limit_stocks.md
│   ├── scenario_2_sector_analysis.md
│   └── scenario_3_market_environment.md
└── README.md                   # 使用文档与 FAQ

注意事项

• 需要可访问 9quant.online 的网络环境
• 未配置或无效的 API Key 将返回 403，勿伪造数据；应提示用户通过 后台联系 获取 API Key
• API 可能受频率限制；启用缓存可减轻重复请求
• 报告仅反映查询时点 API 数据，不代表对未来走势的预测
• 回复中勿暴露后端表名、源码路径或密钥；勿输出投资建议，须保留风险提示与免责声明

更新日志

v1.3.0 (2026-05-16)

• 与后端 api/v1 对齐：pro-quant-indicator（高阶量化指标）、dashboard-indicator（多空雷达）、daily-statistics-pro（高级日统计）
• 知识库扩展至 50 个接口键；增补同花顺/申万/通达信指数与板块、实时行情、ETF 日线、交易日历等
• 通达信主流板块监控 tdx-mainstream：完整参数与 tdx_data 字段说明；配套转强、新增/消失接口；意图与参数解析（index_type、rps_score、limit）
• 支持「昨日」时间语义（如昨日 RPS 突破、昨日涨停）；优化意图识别优先级
• 默认日期区间、专项分析摘要、API Key 鉴权
• SKILL.md、prompts/system_prompt.md 与 OpenClaw 安装说明同步更新

v1.2.0 (2026-03-20)

• 净利润断层、陶博士选股、RPS 突破、昨日涨停今日表现、季报 q_show、个股日线、财务系列 API
• 时间语义与意图冲突消解（断层 vs 季报）

v1.0.0 (2026-03-12)

小葱技能7w4.net持续更新中。

• 初始版本：意图识别、参数配置与数据分析

这个 Skill 整体质量不错，文档详细、接口覆盖广、使用方便。主要做得好的是：API 知识库很全、中文说明清晰、示例丰富，能很好地帮助理解如何使用。不过有个明显问题：示例报告中出现了买卖建议和仓位建议，但官方明确说不会提供这类建议，容易让人产生误解。改进后会更专业可信。