earnings-tracker

Earnings Tracker - AI-powered earnings tracker

Automatically scans earnings calendars and pushes important earnings updates

---

✨ Core Features

📅 Earnings Calendar Scan

• ✅ A-share scheduled disclosure timetable (AKShare)
• ✅ US stock earnings calendar (Yahoo Finance)
• ✅ Automatically scans next week's earnings every Sunday
• ✅ Filter companies to follow

📊 Earnings Data Tracking

• ✅ Earnings forecast (early signal)
• ✅ Earnings flash report (quick overview)
• ✅ Official earnings report (complete data)
• ✅ Revenue, net profit, year-over-year growth

📈 Intelligent Analysis

• ✅ Beat/miss judgment
• ✅ Key metric extraction
• ✅ AI-related highlight identification
• ✅ Institutional commentary summary

🔔 Automatic Push

• ✅ Discord channel push
• ✅ Telegram topic push
• ✅ Scheduled task scheduling
• ✅ One-time reminder

---

🚀 Usage

1. Install dependencies

pip install akshare

---

2. Configure companies to follow

Edit config/settings.json：

{
  "watchlist": {
    "us": ["NVDA", "MSFT", "GOOGL", "META", "AMZN", "TSLA", "AMD"],
    "cn": ["600519", "000858", "601318", "000001"]
  },
  "schedule": {
    "weeklyScan": "Sunday 18:00",
    "reportScan": "after_market"
  }
}

---

3. Run scan

node scripts/earnings-scanner.cjs

---

📋 Workflow

Every Sunday 18:00 - Pre-scan

1. ✅ Scan next week's earnings calendar
2. ✅ Filter companies to follow
3. ✅ Push to Discord/Telegram
4. ✅ Wait for user confirmation

After user confirmation

1. ✅ Create a one-time reminder for each earnings report
2. ✅ Search results after earnings release
3. ✅ Format summary
4. ✅ Push to specified channel

---

🌍 Data Sources

A-shares (recommended)

Data Source	Cost	Interface
AKShare	Free	stock_yysj_em() - Scheduled disclosure timetable
AKShare	Free	stock_yjyg_em() - Earnings forecast
AKShare	Free	stock_yjkb_em() - Earnings flash report
AKShare	Free	stock_yjbb_em() - Official earnings report

US stocks

Data Source	Cost	Description
Yahoo Finance	Free	Earnings calendar
Alpha Vantage	Limited free	Financial data API

---

📊 Example Output

Earnings calendar scan

📅 下周财报日历 (2026-03-17 ~ 2026-03-21)

🇺🇸 美股：
• NVDA - 3月19日 盘后
• MSFT - 3月20日 盘后
• GOOGL - 3月18日 盘后

🇨🇳 A股：
• 600519 贵州茅台 - 3月20日
• 000858 五粮液 - 3月21日

请回复要跟踪的公司（例如：NVDA, 600519）

Earnings summary push

📊 NVDA Q4 2025 财报摘要

💰 营收: $22.1B (预期 $20.4B) ✅ 超预期 8.3%
📈 EPS: $4.12 (预期 $3.95) ✅ 超预期 4.3%
📊 毛利率: 72.1% (同比 +2.3%)

🎯 关键亮点：
• 数据中心营收 $18.4B (同比 +409%)
• AI 芯片需求强劲
• 下季度指引超预期

📌 管理层指引：
• Q1 营收预期 $24B
• 毛利率维持 70%+

来源：Yahoo Finance, Seeking Alpha

---

🔧 Configuration File

config/settings.json

{
  "watchlist": {
    "us": ["NVDA", "MSFT", "GOOGL", "META", "AMZN", "TSLA", "AMD"],
    "cn": ["600519", "000858", "601318", "000001"]
  },
  "schedule": {
    "weeklyScan": "Sunday 18:00",
    "reportScan": "after_market"
  },
  "notify": {
    "channel": "discord",
    "to": "channel:1478698808631361647"
  },
  "dataSources": {
    "cn": "akshare",
    "us": "yahoo_finance"
  }
}

---

📝 Changelog

v1.0.0 (2026-03-14)

• ✅ Initial version
• ✅ A-share earnings calendar scan (AKShare)
• ✅ US stock earnings calendar scan (Yahoo Finance)
• ✅ Discord/Telegram push
• ✅ Scheduled task scheduling

---

📊 Easily track earnings and never miss important information!