| 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
- 每次只處理下一次財報，不排程更遠的未來
