earnings-calendar

核心用法

该技能通过Financial Modeling Prep (FMP)官方API接口，自动化获取未来7个交易日内美股上市公司的财报发布日历。系统会智能过滤市值超过20亿美元的中大盘股（覆盖中市值、大市值及超大市值公司），确保数据聚焦于对市场有显著影响的标的。用户只需提供FMP API密钥（免费版即可），技能将自动计算目标日期范围，调用Python脚本获取原始数据，并按"日期→发布时段→市值规模"的三级结构进行组织，最终生成包含EPS预期、营收预期、行业分类等关键信息的Markdown格式专业报告。

显著优点

数据来源权威可靠：直接对接FMP专业金融数据API，而非爬虫抓取，确保财报时间、业绩预期的准确性和实时性。智能分层展示：自动将财报按"盘前(BMO)/盘后(AMC)/待定(TAS)"分类，并在每个时段内按市值降序排列，让投资者一眼识别 mega-cap（>2000亿美元）等重量级公司的发布时点。多环境无缝适配：完美支持CLI命令行、Claude桌面端和Web端三种使用场景，API密钥可通过环境变量、会话临时输入等多种方式灵活配置。风险信息前置：报告包含板块分布统计、交易活跃度提示、数据新鲜度声明等关键元信息，帮助用户建立完整的交易预期管理框架。

潜在缺点与局限性

地域覆盖有限：目前仅支持美股市场，无法覆盖A股、港股、欧股等其他重要市场。额度与成本约束：免费版API每日限制250次调用，虽然单次周报仅需3-5次调用，但高频使用或扩展功能时可能触及天花板。数据来源单一：完全依赖FMP API的稳定性，若服务方调整接口或限流，技能将受影响。时效性风险：上市公司可能临时调整财报发布时间，技能生成的报告基于抓取时点数据，重大节点建议通过公司IR页面二次确认。

适合的目标群体

本技能主要面向二级市场投资者（特别是关注中大盘股的趋势交易者、事件驱动策略交易者）、金融分析师（需要定期制作市场周报、行业研究的专业人士）、财经内容创作者（撰写财报前瞻、市场复盘需要结构化数据支持）以及个人理财爱好者（希望系统性追踪持仓个股财报时间的散户投资者）。对于量化研究员，该技能可作为数据获取流水线的前置环节，输出的JSON格式数据便于对接后续分析模型。

使用风险提醒

网络与API依赖：技能执行需要稳定的互联网连接访问FMP服务器，且API密钥需妥善保管（虽然脚本不存储密钥到磁盘，但在Web端会话中输入的密钥会在对话期间保留）。性能边界：处理全量中大盘股数据时，若遇到财报季高峰期（如每季度首月），数据量可能较大，需确保运行环境有足够的内存处理JSON解析。数据解释风险：报告中显示的EPS和营收预期为分析师一致预期，实际业绩可能大幅偏离，技能仅提供数据整理服务，不构成投资建议。建议用户在使用报告进行实盘交易决策前，通过SEC EDGAR、公司官网等官方渠道核实关键日期。