earnings-setup

name	earnings-setup
description	設定財報追蹤自動化。從 CSV 清單出發，查詢財報日期，建行事曆事件，建立 cron 輪詢排程。觸發詞：「設定財報追蹤」「earnings setup」「加股票到追蹤清單」「追蹤財報」

Earnings Setup — 財報追蹤自動化設定

檔案路徑

• 腳本目錄: /Users/fredchu/Documents/For_Claude/scripts/earnings-autopilot/
• Ticker 清單: /Users/fredchu/Documents/For_Claude/inbox/earnings/tickers.csv
• 狀態目錄: /Users/fredchu/Documents/For_Claude/scripts/earnings-autopilot/state/
• ical CLI: /Users/fredchu/bin/ical

流程

Step 1: 讀取 Ticker 清單

cat /Users/fredchu/Documents/For_Claude/inbox/earnings/tickers.csv

解析 CSV（逗號分隔），取得所有 ticker symbols。 如果用戶指定特定 ticker，只處理那些。

Step 2: 查詢財報日期

對每支 ticker 執行：

python3 /Users/fredchu/Documents/For_Claude/scripts/earnings-autopilot/fetch_earnings_date.py TICKER

收集結果，分類：

• 可排程（60 天內）
• 太遠（> 60 天）— 列出但不自動排程
• 查詢失敗 — 列出供用戶處理

向用戶報告結果表格，確認要排程哪些。

Step 3: 建行事曆事件

對確認的 ticker，用 ical CLI 建事件：

/Users/fredchu/bin/ical add --title "NVDA 盤後財報" --date "2026-05-28" --calendar "個人" --allday

• 標題格式：{TICKER} {盤前/盤後/未知} 財報
• 時間：如果知道 AMC/BMO 就標註，否則標「未知」
• 全天事件

Step 4: 建立 Cron 輪詢排程

/Users/fredchu/Documents/For_Claude/scripts/earnings-autopilot/cron_manager.sh add TICKER Q{N}_{YEAR} YYYY-MM-DD

Step 5: 建立狀態檔

確認 state/{TICKER}_{QUARTER}.json 已建立（poll_transcript.sh 會自動建立）。

Step 6: 報告

向用戶彙整報告：

• 已排程的 ticker + 財報日期 + cron 排程
• 太遠的 ticker（建議下次再設定）
• 失敗的 ticker

注意事項

• 距離 > 60 天的 ticker 列出並詢問用戶，不自動排程
• yfinance 需要安裝：pip install yfinance
• 每次只處理下一次財報，不排程更遠的未來