pykabu-calendar 0.1.0

Japanese earnings calendar aggregator with official IR verification

pykabu-calendar

Japanese earnings calendar aggregator with official IR verification.

Installation

pip install pykabu-calendar

Quick Start

import pykabu_calendar as cal

# Get earnings calendar for a specific date
df = cal.get_calendar("2026-02-10")

# Using lightweight sources only (no browser needed)
df = cal.get_calendar("2026-02-10", sources=["matsui", "tradersweb"])

# With historical inference
df = cal.get_calendar("2026-02-10", infer_from_history=True)

# Export to CSV
cal.export_to_csv(df, "earnings.csv")

Features

• Aggregates earnings calendars from SBI, Matsui, Monex, Tradersweb
• Infers announcement time from historical patterns
• Optionally verifies against official company IR pages
• Caches IR discovery for fast subsequent runs
• Exports to CSV (Google Sheets compatible)

Data Source Priority

1. Official IR - Most accurate (optional, slower)
2. Historical patterns - Inferred from past announcements
3. SBI Securities - Primary public source
4. Supplementary sources - Matsui, Monex, Tradersweb

Documentation

Full documentation: https://obichan117.github.io/pykabu-calendar

License

MIT