earnings-calendar

📅 美股财报日历智能追踪助手

基于FMP官方API的专业财报日历工具,自动追踪市值20亿以上美股公司未来7天收益发布时点,生成结构化周报助力投资决策。

收藏
13.4k
安装
3.2k
版本
v0.1.0
CLS 安全性认证2026-05-06
点击查看完整报告 >

使用说明

核心用法

该技能通过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、公司官网等官方渠道核实关键日期。

安全解读

核心用法

earnings-calendar 是一款专业的金融数据获取 Skill,通过 Financial Modeling Prep (FMP) API 自动抓取未来 7 天美股财报日程。核心工作流包括:获取当前日期计算目标周 → 加载 FMP API 指南 → 检测/请求 API 密钥 → 调用 Python 脚本获取数据 → 按日期/时段/市值分组 → 生成结构化 Markdown 报告。

关键特性

  • 智能过滤:仅保留 $2B+ 市值中大盘股,聚焦市场影响力公司
  • 时段分组:Before Market Open(BMO)/After Market Close(AMC)/Time Announced Soon(TAS)
  • 市值排序:Mega-cap ($200B+) → Large-cap ($10B-$200B) → Mid-cap ($2B-$10B)
  • 多环境适配:CLI 环境变量、Desktop/Web 会话存储双模式
  • 自动报告:含执行摘要、重点观察、行业分布、交易提示

显著优点

1. 数据权威性:FMP 是业界知名金融数据服务商,数据结构化程度高
2. 功能单一明确:无隐藏功能,专注财报日历单一场景

3. 安全设计良好:HTTPS 加密传输,API 密钥不硬编码,会话级临时存储

4. 输出专业:自动计算统计指标(峰值日、行业分布、最高市值 TOP5)

5. 降级方案:支持手动数据录入模式,API 不可用时仍可工作

潜在局限与风险

| 方面 | 说明 |
|------|------|
| 覆盖范围 | 仅 $2B+ 市值公司,小盘股需额外查询 |
| API 限额 | 免费版 250 次/天,单次查询消耗 3-5 次调用 |
| 时效性 | 财报时间可能临时调整,需交叉验证 |
| 地域限制 | 仅覆盖美股,无港股/A 股支持 |
| 依赖单一源 | 未设计多源校验机制 |

适合人群

  • 个人投资者:快速掌握下周市场重大事件
  • 量化研究员:获取结构化财报日程数据
  • 财经内容创作者:生成专业格式的财报周报
  • 机构交易员:盘前/盘后重点公司监控

常规风险

  • API 密钥泄露风险:需严格遵循环境变量配置,避免误提交至代码仓库
  • 数据时效风险:财报时间可能变更,关键交易决策需二次确认
  • 服务依赖风险:FMP API 服务中断或政策调整将影响功能
  • 来源可信度:T3 级个人开发者维护,生产环境建议额外审查

使用建议

推荐搭配环境变量永久配置 + 30 天周期重新认证,高频用户可考虑 FMP 付费套餐解除限额。

earnings-calendar 内容

assets文件夹
references文件夹
scripts文件夹
手动下载zip · 30.7 kB
earnings_report_template.mdtext/markdown
请选择文件