stock-analysis

股票分析 (v5.0)

使用 Yahoo Finance 資料分析美國股票和加密貨幣。包含投資組合管理、加密貨幣支援及定期分析。

快速開始

重要： 指令中只傳入股票代號，不要加入額外文字、標題或格式。

分析單一代號：

uv run {baseDir}/scripts/analyze_stock.py AAPL
uv run {baseDir}/scripts/analyze_stock.py MSFT --output json

比較多個代號：

uv run {baseDir}/scripts/analyze_stock.py AAPL MSFT GOOGL

加密貨幣分析 (v5.0)

分析前 20 大市值加密貨幣：

uv run {baseDir}/scripts/analyze_stock.py BTC-USD
uv run {baseDir}/scripts/analyze_stock.py ETH-USD SOL-USD

支援的加密貨幣：
BTC-USD, ETH-USD, BNB-USD, SOL-USD, XRP-USD, ADA-USD, DOGE-USD, AVAX-USD, DOT-USD, MATIC-USD, LINK-USD, ATOM-USD, UNI-USD, LTC-USD, BCH-USD, XLM-USD, ALGO-USD, VET-USD, FIL-USD, NEAR-USD

加密貨幣分析維度：

• 市值（大型/中型/小型分類）
• 類別（智慧合約 L1、DeFi、支付等）
• BTC 相關性（30 天）
• 動能（RSI、價格區間）
• 市場情境（VIX、整體市場狀態）

投資組合管理 (v5.0)

建立並管理包含混合資產（股票 + 加密貨幣）的投資組合：

# 建立投資組合
uv run {baseDir}/scripts/portfolio.py create "我的投資組合"

# 新增資產
uv run {baseDir}/scripts/portfolio.py add AAPL --quantity 100 --cost 150.00
uv run {baseDir}/scripts/portfolio.py add BTC-USD --quantity 0.5 --cost 40000 --portfolio "我的投資組合"

# 檢視持有部位及當前損益
uv run {baseDir}/scripts/portfolio.py show

# 更新/移除資產
uv run {baseDir}/scripts/portfolio.py update AAPL --quantity 150
uv run {baseDir}/scripts/portfolio.py remove BTC-USD

# 列出/刪除投資組合
uv run {baseDir}/scripts/portfolio.py list
uv run {baseDir}/scripts/portfolio.py delete "我的投資組合"

投資組合儲存位置： ~/.clawdbot/skills/stock-analysis/portfolios.json

投資組合分析 (v5.0)

分析投資組合中的所有資產，可選擇加入期間報酬：

# 分析投資組合
uv run {baseDir}/scripts/analyze_stock.py --portfolio "我的投資組合"

# 含期間報酬（每日/每週/每月/每季/每年）
uv run {baseDir}/scripts/analyze_stock.py --portfolio "我的投資組合" --period weekly
uv run {baseDir}/scripts/analyze_stock.py -p "我的投資組合" --period monthly

投資組合摘要包含：

• 總成本、當前價值、損益
• 期間報酬（若有指定）
• 集中度警告（單一資產超過 30%）
• 建議摘要（BUY/HOLD/SELL 數量）

範例：

• ✅ 正確：uv run {baseDir}/scripts/analyze_stock.py BAC
• ✅ 正確：uv run {baseDir}/scripts/analyze_stock.py BTC-USD
• ❌ 錯誤：uv run {baseDir}/scripts/analyze_stock.py === BANK OF AMERICA (BAC) - Q4 2025 EARNINGS ===
• ❌ 錯誤：uv run {baseDir}/scripts/analyze_stock.py "Bank of America"

僅使用股票代號（例如 BAC，而非「Bank of America」）。加密貨幣請使用 -USD 後綴（例如 BTC-USD）。

分析元件

此腳本評估八個關鍵維度：

1. 財報驚喜（權重 30%）：實際 vs 預期 EPS、營收超標/未達標
2. 基本面（權重 20%）：本益比、利潤率、營收成長、負債水準
3. 分析師情緒（權重 20%）：共識評級、目標價 vs 當前股價
4. 歷史模式（權重 10%）：過去財報反應、波動性
5. 市場情境（權重 10%）：VIX、SPY/QQQ 趨勢、市場狀態
6. 類股表現（權重 15%）：個股 vs 類股比較、類股趨勢
7. 動能（權重 15%）：RSI、52 週區間、成交量、相對強度
8. 情緒分析（權重 10%）：恐懼貪婪指數、空頭持倉、VIX 期限結構、內部人交易、買賣權比率

情緒子指標：

• 恐懼與貪婪指數（CNN）：反向訊號（極度恐懼 = 買入機會，極度貪婪 = 謹慎）
• 空頭持倉：高空頭 + 軋空潛力 = 看多；合理空頭 = 看空
• VIX 期限結構：正價差 = 自滿/看多；逆價差 = 壓力/看空
• 內部人活動：SEC Form 4 申報的淨買入/賣出（90 天窗口）
• 買賣權比率：高比率 = 過度恐懼/看多；低比率 = 自滿/看空

若某些元件無法取得，權重會自動正規化。

特殊時機檢查：

• 財報前警告（< 14 天）：建議 HOLD 而非 BUY
• 財報後飆升偵測（5 天內 > 15%）：標記「漲幅已反映」
• 超買條件（RSI > 70 且接近 52 週高點）：降低信心

時機警告與風險標誌

腳本會偵測高風險情境：

財報時機

• 財報前時期：若距離財報不到 14 天，BUY 訊號改為 HOLD
• 財報後飆升：若股價在財報後 5 天內上漲 > 15%，警告「漲幅可能已反映」

技術風險

• 超買條件：RSI > 70 且接近 52 週高點 = 高風險進場

市場風險

• 高 VIX：市場恐懼（VIX > 30）降低 BUY 訊號信心
• 風險趨避模式（v4.0.0）：當避險資產（GLD、TLT、UUP）同步上漲時，BUY 信心降低 30%
  • 偵測資金逃往黃金、公債和美元
  • 觸發條件：GLD ≥ +2%、TLT ≥ +1%、UUP ≥ +1%（5 日變動）

類股風險

• 類股疲弱：個股可能表現良好，但類股正在輪動退出

地緣政治風險（v4.0.0）

腳本現在掃描突發新聞（過去 24 小時）中的危機關鍵字，並自動標記受影響的股票：

• 台灣衝突：半導體（NVDA、AMD、TSM、INTC 等）→ 信心扣減 30%
• 中國緊張：科技/消費（AAPL、QCOM、NKE、SBUX 等）→ 信心扣減 30%
• 俄烏戰爭：能源/原物料（XOM、CVX、MOS、CF 等）→ 信心扣減 30%
• 中東：石油/國防（XOM、LMT、RTX 等）→ 信心扣減 30%
• 銀行危機：金融（JPM、BAC、WFC、C 等）→ 信心扣減 30%

若股票不在受影響清單中，但其類股有曝險，則適用 15% 的信心扣減。

範例警示：

⚠️ 類股風險：科技供應鏈與消費市場曝險（偵測到：china, tariff）

突發新聞警示（v4.0.0）

• 掃描 Google News RSS 中的危機關鍵字（戰爭、衰退、制裁、災難等）
• 在備註中顯示最多 2 則突發新聞警示（過去 24 小時）
• 使用 1 小時快取以避免過多 API 呼叫

輸出格式

預設（文字）：簡潔的買入/持有/賣出訊號，附 3-5 個要點與備註

JSON：結構化資料，包含分數、指標和原始資料，便於進一步分析

限制

• 資料新鮮度：Yahoo Finance 可能延遲 15-20 分鐘
• 情緒資料時效性：
  • 空頭持倉資料約落後 2 週（FINRA 申報時程）
  • 內部人交易可能延遲 2-3 天申報
  • VIX 期限結構僅在期貨交易時間更新
• 突發新聞限制（v4.0.0）：
  • Google News RSS 可能延遲 15-60 分鐘
  • 關鍵字比對可能出現誤報/漏報
  • 不分析情緒，僅偵測關鍵字
  • 1 小時快取可能導致警示稍微過時
• 資料缺失：並非所有股票都有分析師覆蓋、選擇權鏈或完整基本面
• 執行時間：每支股票 3-5 秒，採用非同步並行擷取與快取（共享指標快取 1 小時）
• 免責聲明：所有輸出均包含顯著的「非財務建議」警告
• 僅限美國市場：非美國股票代號可能資料不完整

錯誤處理

腳本能優雅處理：

• 無效代號 → 明確的錯誤訊息
• 缺少分析師資料 → 僅根據可用指標發出訊號
• API 失敗 → 指數退避重試，3 次後放棄