用途:获取美股未来一周(当前日期起 7 天)的财报公告,聚焦市值超过 20 亿美元、可能影响市场的中大型公司,输出按日期与发布时间分组的 Markdown 报告。
主要能力:调用 FMP 财报日历 API 获取数据;通过公司资料接口按市值(>$2B)过滤;包含 EPS 与营收预期;按日期→发布时间(BMO/AMC/TAS)→市值降序排列;生成含执行摘要、每日分组表格、市值最高公司、行业分布与时间说明的报告;支持 CLI、桌面与网页多环境。
使用方式:需先获取 FMP API Key(免费层 250 次/天)。CLI 可设置环境变量 export FMP_API_KEY="your-api-key-here";桌面或网页环境会在执行时询问 Key,仅保存在当前会话。核心命令:python scripts/fetch_earnings_fmp.py 2025-11-03 2025-11-09 > earnings_data.json,再执行 python scripts/generate_report.py earnings_data.json earnings_calendar_2025-11-02.md。报告文件名格式为 earnings_calendar_[YYYY-MM-DD].md。若无法使用 API,可手动从 Finviz 或 Yahoo Finance 收集数据后按同一模板整理。
适用场景:每周财报前瞻、关注某日财报、按市值与行业梳理市场事件。
限制:依赖 FMP API 与有效 Key;免费层每日 250 次调用;仅覆盖美股且市值 >$2B;财报日期与时间可能变动,需以公司官方投资者关系页面为准;EPS 与营收为分析师共识预期,非实际结果。