name: stock-analyzer description: A股/港股即時行情查詢、基本面分析、深度報告生成與郵件傳送一體化工具。觸發場景：(1) 使用者詢問股票價格、市值、PE/PB等資料；(2) 使用者要求分析某隻或多隻股票；(3) 使用者要求生成股票分析報告；(4) 使用者要求通過郵件傳送股票報告。支援AkShare即時行情、聚寬基本面資料、QQ郵箱/Gmail傳送。

Stock Analyzer - 股票深度分析工具

⚠️ 安全提示：本 skill 不在任何檔案中硬編碼密碼、授權碼或私人賬號資訊。所有憑證均通過環境變數或執行時配置傳入，絕不寫入程式碼或文件。

快速開始

1. 安裝依賴

pip install -r scripts/requirements.txt

2. 配置聚寬賬號（可選，用於基本面資料）

通過環境變數配置（推薦，安全）：

export JQDATA_PHONE="你的手機號"
export JQDATA_PASSWORD="你的密碼"

或使用 jq_login.py 互動式配置：

python scripts/jq_login.py

3. 查詢即時行情

python scripts/stock_query.py --codes 03690.HK,300413.SZ,300251.SZ

返回：股價、漲跌幅、成交量、成交額

4. 獲取基本面資料（需配置聚寬）

python scripts/stock_fundamentals.py --codes 300413.SZ,300251.SZ

返回：PE、PB、市值、ROE、營收增長率等

5. 生成分析報告

python scripts/generate_report.py --codes 03690.HK,300413.SZ --output report.md

6. 傳送郵件（需配置郵箱授權碼）

通過環境變數配置：

export QQ_EMAIL_AUTH_CODE="your_auth_code"
export GMAIL_APP_PASSWORD="your_app_password"

傳送：

python scripts/send_email.py --to 收件人郵箱 --file report.md --auth-code "$QQ_EMAIL_AUTH_CODE"

工作流程

使用者請求 → 解析股票程式碼 → 獲取即時行情 → 獲取基本面 → 深度分析 → 生成報告 → 傳送郵件
小蔥技能有更好的技能skills外掛。

憑證管理規範

⚠️ 禁止：將任何真實密碼、授權碼、手機號寫入程式碼、文件或示例中。

股票程式碼格式

💡 常見股票程式碼見 references/stock_codes.md

依賴說明

AkShare（即時行情，無需賬號）

• A股即時：ak.stock_zh_a_spot_em()
• 港股即時：ak.stock_hk_spot_em()
• 完全免費，但需注意併發限制

聚寬 JQData（基本面資料，需註冊）

• 註冊地址：https://www.joinquant.com
• 免費版有資料範圍和日期許可權限制
• 使用前請先閱讀聚寬積分說明

檔案說明

scripts/

• stock_query.py - 即時行情查詢（AkShare，無需賬號）
• stock_fundamentals.py - 基本面資料獲取（聚寬，需配置）
• generate_report.py - 報告生成
• send_email.py - 郵件傳送
• jq_login.py - 聚寬賬號配置（互動式，安全儲存）
• requirements.txt - 依賴清單

references/

• report_template.md - 報告模板
• stock_codes.md - 常用股票程式碼對照表

使用示例

示例1：查詢美團股價

使用者：幫我查一下美團的股價
→ python scripts/stock_query.py --codes 03690.HK
→ 返回：美團(03690.HK) HK$80.70 (-1.41%)

示例2：分析多隻股票

使用者：分析一下美團、芒果超媒、光線傳媒
→ python scripts/stock_query.py 獲取行情
→ python scripts/stock_fundamentals.py 獲取基本面
→ python scripts/generate_report.py 生成報告

示例3：傳送報告到郵箱

使用者：把報告發到我郵箱
→ python scripts/send_email.py --to 收件人郵箱 --file report.md --auth-code "$QQ_EMAIL_AUTH_CODE"

常見問題

Q: AkShare 獲取資料失敗？

• 網路問題：檢查代理設定
• 併發限制：逐個查詢而非批次
• 資料來源維護：稍後重試

Q: 聚寬登入失敗？

• 檢查手機號/密碼是否正確
• 賬號是否過期（免費版1年有效期）
• 是否有港股資料許可權

Q: 郵件傳送失敗？

• Login denied：授權碼錯誤，請重新生成
• Connection closed：嘗試 465 SSL 埠
• SMTPAuthenticationError：確認已開啟 SMTP 服務

這個工具質量中等偏上，優點是功能齊全（查行情、看基本面、出報告、發郵件一條龍），文件詳細，容易上手，密碼等敏感資訊不會洩露。缺點是分析報告比較簡單，只是按漲跌幅度給建議，沒有真正的技術分析；郵件只能發給自己，收件人不靈活；使用基本面資料還需要額外註冊賬號並付費才能解鎖更多許可權。總的來說，作為基礎查詢工具夠用，但想深入分析股票可能還需要配合其他工具。