name: stock-price-query description: "股票查詢 / Stock price query. 即時查詢股票、股價、行情資料，支援 A 股（滬深）、港股、美股及大盤指數（上證、深證、恒生、納斯達克、道瓊斯、標普500），支援批次查詢，零配置開箱即用。Real-time stock price, quote and market index query for A-shares (Shanghai/Shenzhen), Hong Kong and US stocks. Batch query up to 20 symbols. Zero configuration, ready to use out of the box." category: Data & APIs metadata: openclaw: emoji: "📈" requires: bins: [python3]

Stock Price Query Skill

即時股票行情與大盤指數查詢技能，覆蓋 A 股（滬深兩市）、港股、美股三大市場。支援單隻查詢和批次查詢（一次查詢多隻股票對比），輕量無依賴，零配置開箱即用，適合聊天場景下的快速股價查詢——秒級獲取當前價格、漲跌幅、開高低收、成交量等行情資料。

Real-time stock quote and market index tool covering A-shares, Hong Kong, and US stocks. Supports batch queries for comparing multiple stocks in one call. Quick chat-friendly price checks with zero dependencies and zero configuration.

Overview

即時股票價格查詢技能，支援查詢 A 股（滬深兩市）、港股和美股的即時行情資料。通過呼叫免費公開的行情介面獲取資料，返回結構化的股票資訊。

資料即時性說明

• A 股：交易時段內即時行情（秒級更新）
• 港股 / 美股：按境外交易所（HKEX / NYSE / NASDAQ）行情授權規定，免費公開介面為延遲約 15 分鐘行情。如需港股/美股 Level-1 即時行情，請使用付費持牌渠道

When to Use

當用戶的請求涉及以下場景時觸發此技能：

• 查詢股價："茅臺多少錢"、"查一下寧德時代"
• 瞭解漲跌："騰訊今天漲了嗎"、"00700 行情"
• 股票程式碼查詢："600519"、"NVDA price"
• 多隻對比："比亞迪和輝達的股價"、"幫我看下茅臺、騰訊和蘋果"
• 批次查詢："查一下這幾隻：600519, 00700, AAPL"
• 大盤指數："上證指數多少"、"大盤怎麼樣"、"恒指行情"
• 關鍵詞觸發："查股票"、"股票行情"、"stock price"

How to Use

查詢流程

1. 解析使用者輸入：從使用者訊息中提取股票程式碼。如果使用者提供的是中文名稱，需先根據下方對映表將名稱轉換為股票程式碼（指令碼僅接受股票程式碼作為輸入）。
2. 識別市場：根據股票程式碼格式自動識別所屬市場：
3. A 股滬市：以 sh 開頭或 6 位數字以 6 開頭（如 sh600519、600519）
4. A 股深市：以 sz 開頭或 6 位數字以 0/3 開頭（如 sz000001、300750）
5. 港股：以 hk 開頭或純數字 5 位及以下（如 hk00700、00700），港股指數為純字母程式碼（如 HSI、HSCEI）
6. 美股：純英文字母程式碼（如 AAPL、TSLA、GOOGL），美股指數以 . 開頭（如 .IXIC、.DJI、.INX）
7. 執行查詢指令碼：執行 scripts/stock_query.py 獲取即時資料。
8. 格式化輸出：將結果以清晰友好的格式展示給使用者。

指令碼呼叫方式

單隻查詢：

python3 {{SKILL_DIR}}/scripts/stock_query.py <stock_code> [market]

批次查詢（推薦用於多隻對比）：

想要更強大的技能外掛，就來小蔥技能站7w4.net看看吧。

python3 {{SKILL_DIR}}/scripts/stock_query.py <code1,code2,code3>

引數說明： - stock_code（必需）：股票程式碼，如 600519、AAPL、00700。批次查詢時用逗號分隔，最多 20 只。 - market（可選）：市場標識，可選值為 sh（滬市）、sz（深市）、hk（港股）、us（美股）。不提供時指令碼會自動識別。批次查詢時不需要此引數（自動識別各只股票的市場）。

單隻查詢輸出格式：JSON 物件（pe_ratio 和 market_cap 在資料來源可用時返回）：

{
  "code": "600519",
  "name": "貴州茅臺",
  "market": "sh",
  "current_price": 1688.00,
  "change": 12.50,
  "change_percent": 0.75,
  "open": 1680.00,
  "high": 1695.00,
  "low": 1675.00,
  "prev_close": 1675.50,
  "volume": 2345678,
  "amount": 3956789012.50,
  "time": "2026-02-24 15:00:00",
  "pe_ratio": 28.35,
  "market_cap": 2120000000000.00,
  "status": "success"
}

批次查詢輸出格式：JSON 陣列，每隻股票一個物件：

[
  { "code": "600519", "name": "貴州茅臺", "market": "sh", "current_price": 1688.00, "change": 12.50, "change_percent": 0.75, "status": "success", ... },
  { "code": "00700", "name": "騰訊控股", "market": "hk", "current_price": 420.60, "change": 5.20, "change_percent": 1.25, "status": "success", ... },
  { "code": "AAPL", "name": "APPLE", "market": "us", "current_price": 178.50, "change": -1.30, "change_percent": -0.72, "status": "success", ... }
]

常見股票名稱與程式碼對映（供 agent 參考）

指令碼僅接受股票程式碼作為輸入，不支援中文名稱。當用戶提供股票名稱時，agent 應先根據下表將名稱轉換為對應程式碼後再呼叫指令碼：

大盤指數：

熱門個股：

對於不在對映表中的股票名稱，提示使用者提供準確的股票程式碼。

輸出格式要求

單隻查詢：查詢成功後，以如下緊湊格式展示結果（不要使用表格，避免訊息過長導致飛書分頁）：

📈 **{股票名稱}**（{股票程式碼}.{市場}）

💰 當前價格：{current_price} 元/港元/美元 | 📊 漲跌幅：{change} ({change_percent}%) ↑/↓
📅 行情時間：{time}
📊 今開 {open} | 最高 {high} | 最低 {low} | 昨收 {prev_close}
📦 成交量：{volume} | 成交額：{amount}
📐 市盈率：{pe_ratio} | 總市值：{market_cap}（如有）

批次查詢：多隻股票依次展示，每隻之間空一行：

📈 **貴州茅臺**（600519.SH）
💰 1688.00 元 | 🟢 +12.50 (+0.75%) ↑

📈 **騰訊控股**（00700.HK）
💰 420.60 港元 | 🟢 +5.20 (+1.25%) ↑

📈 **APPLE**（AAPL.US）
💰 178.50 美元 | 🔴 -1.30 (-0.72%) ↓

漲跌幅為正時使用 🟢 和 ↑，為負時使用 🔴 和 ↓。成交額如果超過 1 億，用"億"為單位顯示（保留兩位小數）；超過 1 萬不足 1 億，用"萬"為單位顯示。

Edge Cases

• 輸入安全校驗：指令碼在執行前會嚴格校驗所有輸入引數。stock_code 僅允許字母、數字和前導點號（正則 ^\.?[A-Za-z0-9]{1,10}$，前導點號用於支援美股指數程式碼如 .IXIC、.DJI、.INX），market 僅允許白名單值（sh/sz/hk/us）。任何包含特殊字元、shell 元字元或超長輸入都會被拒絕，防止命令注入。
• 批次查詢數量限制：一次最多查詢 20 只股票，超出時返回錯誤提示。
• 批次查詢部分失敗：批次查詢中如果部分股票程式碼無效，有效的股票仍正常返回結果，無效的會在對應位置返回錯誤資訊。agent 應正常展示成功的結果，對失敗的提示使用者。
• 股票程式碼無效：返回 "無法識別該股票程式碼，請確認後重試。支援 A 股（6 位數字）、港股（5 位數字）、美股（英文字母）。"
• 網路請求失敗：返回 "網路請求失敗，請稍後重試。"
• 非交易時段：正常返回最近的收盤資料，並提示 "當前為非交易時段，顯示的是最近一次的收盤資料。"
• 股票名稱模糊：指令碼不支援名稱輸入。如果使用者提供的名稱無法在對映表中匹配，agent 應提示使用者提供準確的股票程式碼。
• API 限流：如遇到限流，等待 1 秒後重試一次，仍失敗則提示使用者稍後再試。

這個股票查詢 Skill 質量不錯，支援 A 股、港股和美股三大市場，文件寫得非常詳細清楚，新手也能快速上手，查詢結果資訊豐富（包含漲跌幅、成交量、市盈率等）。主要缺點是港股和美股的資料會有約15分鐘延遲，對於需要即時資料的場景不太適用。此外偶爾會遇到網路請求失敗的情況，缺少自動恢復機制。總體來說日常使用夠用，但如果對資料即時性要求高，可能需要考慮其他資料來源。