mcpField
E
earnings-calendar

earnings-calendar

github.com/staskhOther39786 installsUpdated today
Repository

About earnings-calendar

A command-line skill that retrieves upcoming earnings dates for stock tickers, individually or in batches. It reports timing and consensus EPS estimates when available, with batch results ordered by date.

Key features

  1. 01Look up upcoming earnings dates
  2. 02Query one or multiple tickers
  3. 03Show before- or after-market timing
  4. 04Include consensus EPS estimates
  5. 05Sort batch results by date

Use cases

  1. 01Check earnings dates for portfolio holdings
  2. 02Plan trades around announcements
  3. 03Build a calendar for a watchlist

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/staskh/trading_skills --skill earnings-calendar

After installing, type/earnings-calendarin Claude Code to confirm it loaded.

Bundled filesscripts/earnings.py

Details

From the project README

Earnings Calendar

Retrieve upcoming earnings dates for stocks.

Instructions

Note: If uv is not installed or pyproject.toml is not found, replace uv run python with python in all commands below.

uv run python scripts/earnings.py SYMBOLS

Arguments

  • SYMBOLS - Ticker symbol or comma-separated list (e.g., AAPL or AAPL,MSFT,GOOGL,NVDA)

Output

Single symbol returns:

  • symbol - Ticker symbol
  • earnings_date - Next earnings date (YYYY-MM-DD)
  • timing - "BMO" (Before Market Open), "AMC" (After Market Close), or null
  • eps_estimate - Consensus EPS estimate, or null if unavailable

Multiple symbols returns:

  • results - Array of earnings info, sorted by date (soonest first)

Examples

# Single symbol
uv run python scripts/earnings.py NVDA

# Multiple symbols (sorted by date)
uv run python scripts/earnings.py AAPL,MSFT,GOOGL,NVDA,META

# Portfolio earnings calendar
uv run python scripts/earnings.py CAT,GOOG,HOOD,IWM,NVDA,PLTR,QQQ,UNH

Use Cases

  • Check when positions have upcoming earnings risk
  • Plan trades around earnings announcements
  • Build an earnings calendar for watchlist

Dependencies

  • pandas
  • yfinance

Timezone

All timestamps and time-based calculations must use the America/New_York timezone. All JSON output must include generated_at (NY time string) and data_delay fields.

Comments

Markdown supported