用途:检索美股即将发布的财报公告,面向市值超过 20 亿美元(中盘及以上)的、可能影响市场的公司,生成按日期与公布时段分组的 Markdown 日程报告。
主要能力:通过 Financial Modeling Prep (FMP) API 获取结构化财报数据;按市值(>$2B)过滤;包含 EPS 与营收预期;按日期、公布时段(BMO 盘前 / AMC 盘后 / TAS 未公布)与市值分组排序;支持 CLI、Desktop、Web 多环境;灵活管理 API Key。
使用方式:需 FMP API Key,可访问 https://site.financialmodelingprep.com/developer/docs 免费注册,免费额度 250 次/天。CLI 可设环境变量 export FMP_API_KEY="your-api-key-here";Desktop 设系统环境变量或配置 MCP;Web 在执行时输入(仅当前会话保存)。取数脚本:python scripts/fetch_earnings_fmp.py 2025-11-03 2025-11-09 "${API_KEY}" > earnings_data.json;报告脚本:python scripts/generate_report.py earnings_data.json earnings_calendar_2025-11-02.md。流程为先取当前日期并计算未来 7 天区间,再读取 references/fmp_api_guide.md,检测或请求 API Key,调用上述脚本取数与生成报告。报告文件名约定 earnings_calendar_[YYYY-MM-DD].md,日期为生成日。
适用场景:每周财报前瞻、聚焦某日财报;若 API 不可用,可手动从 Finviz 或 Yahoo Finance 收集数据并注明“Data Source: Manual Entry”。
限制:依赖 FMP API 与有效 Key;免费额度 250 次/天,超限返回 429;Key 无效返回 401。财报日期与时段可能变动,关键信息应经公司投资者关系页面核实。EPS 与营收为分析师共识预期,非实际结果。市值分类:Mega >$200B、Large $10B-$200B、Mid $2B-$10B。