Stock API Analyzer

面向 OpenClaw / iFlow 的九宽量化股票 API 分析 Skill。基于 api_knowledge.json 知识库调用接口，仅做客观数据解读。

Quick Start

1. 读取 {baseDir}/config.json，确认 api_key 已配置
2. 解析用户意图：对照 prompts/system_prompt.md 与 api_knowledge.json
3. 发起请求：url = api_base_url + endpoint，请求头 X-API-Key: {api_key}
4. 仅使用 API 实际返回值撰写报告，末尾附风险提示与免责声明

Workflow

Task Progress:
- [ ] 识别意图（自然语言 → 接口键名与参数）
- [ ] 解析时间语义（昨日/今天/季报披露季等）
- [ ] 股票名称 → 先 stock_search 再查详情
- [ ] 调用 API（单接口或多接口组合）
- [ ] 生成结构化报告（禁止投资建议）

参数约定

• 日期区间：startDate / endDate（驼峰）
• 单日接口：date
• URL 拼接：api_base_url（站点根 https://9quant.online）+ endpoint（已含 /api/v1，勿重复）

工具依赖

• web_fetch / HTTP：调用九宽 GET API
• search（可选）：检索 api_knowledge.json、prompts/system_prompt.md
• calculate（可选）：涨跌幅、占比、区间统计

Configuration

编辑 {baseDir}/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"
  }
}

| 配置项 | 说明 | |--------|------| | api_base_url | 站点根地址，不含 /api/v1 | | api_key | 写入 X-API-Key；403 时提示用户联系九宽后台获取，勿伪造数据 | | enable_caching / cache_ttl | 响应缓存，减轻频率限制 | | max_retries / retry_delay | 失败重试 |

完整配置说明见 README.md。

Output Rules

• 分析内容必须来自 API 实际返回，禁止臆造数值或未文档化字段
• 禁止：投资建议、买卖/仓位/止损止盈建议、操作策略指引
• 可客观描述指标、同比环比、涨跌分布与多空/强弱信号（表述为「数据显示…」）
• 必须在报告末尾包含「风险提示」与「免责声明」
• 勿暴露后端表名、源码路径或 API 密钥

Report Template

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

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

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

## 三、数据要点与异常
### 3.1 关键发现
### 3.2 需关注的字段或缺口

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

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

---
⚠️ **免责声明**：本分析基于历史数据与 API 返回结果，仅供数据参考，不构成投资建议。股市有风险，投资需谨慎。

详细意图映射与输出规范见 prompts/system_prompt.md。

Examples

| 用户意图 | 接口键 | 要点 | |----------|--------|------| | 昨天涨停 | limit（type=U） | 数量、板块分布、首板 | | 昨日涨停今日表现 | limit_yesterday_today | 延续性、情绪 | | 陶博士选股 | tdx_stock_list | 口袋支点、月线反转 | | 净利润断层 | profit_gap | 支持「去年三季报」等语义 | | RPS 突破 | rps_tp | 支持「昨日 RPS 突破」 | | 全市场筛股 | all_stocks | RPS、市值、概念组合 | | 个股日线 | stock_search → stock_daily_detail | 先解析代码 | | 市场环境 | market_golden_score + daily + limit 等 | 多接口组合 | | 多空雷达 | dashboard_indicator | 牛熊、转折信号 | | 板块监控 | ths_mainstream / tdx_mainstream 等 | 见 system_prompt |

场景示例见 examples/ 目录。

API Categories

知识库共 50 个接口，完整字段以 api_knowledge.json 为准：

1. 基础数据：stock_search
2. 市场数据（12）：涨跌停、RPS、日线统计、高阶量化、多空雷达、黄金指标等
3. 板块/指数（16）：同花顺、申万、通达信指数与成分股
4. 股票数据（2）：全市场列表、个股日线统计
5. 选股策略（4）：陶博士、RPS 突破、净利润断层、N 日新高
6. 财务数据（8）：季报、预告、三大报表、财务指标
7. 龙虎榜/资金（3）：龙虎榜、详情、股东增减持
8. ETF/其它（4）：ETF 统计、日线历史、调研、交易日历

Installation（OpenClaw）

1. 复制本目录到 ~/.openclaw/skills/stock-api-analyzer/（Windows：%USERPROFILE%\.openclaw\skills\stock-api-analyzer\）
2. 编辑 config.json 填入 api_key
3. 在 OpenClaw 中注册并启用，重载 skills

Additional Resources

• README.md — 完整使用文档与 FAQ
• prompts/system_prompt.md — 意图→接口映射、参数解析
• api_knowledge.json — 50+ 接口字段与参数
• examples/ — 涨停、板块、市场环境场景