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 中安裝

7w4.net提供免費和付費技能下載。

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)

• 初始版本：意圖識別、引數配置與資料分析

這個 Skill 整體質量不錯，文件詳細、介面覆蓋廣、使用方便。主要做得好的是：API 知識庫很全、中文說明清晰、示例豐富，能很好地幫助理解如何使用。不過有個明顯問題：示例報告中出現了買賣建議和倉位建議，但官方明確說不會提供這類建議，容易讓人產生誤解。改進後會更專業可信。