SuperAPI AI 工具集

earnings-preview-single

写作与研究

查看项目

更新于 10-16 03:50

技能介绍

用途

Single-Company Earnings Preview 用于为单一家公司生成一份精简、专业的股票研究财报前瞻报告。报告输出为一个自包含的 HTML 文件,目标为打印后 4-5 页,内容数据密集,叙述紧凑、直击要点。

主要能力

技能围绕两条指定数据源展开分析:Kensho Grounding MCP(用于搜索)与 S&P Global MCP(kfinance)。报告需覆盖最近一期财报会议记录分析、竞争对手对比,并生成带有信源追溯的结构化报告。报告正文中的每一项主张——无论是数值还是非数值——都要求包裹指向附录对应条目的超链接。

使用方式(工作流程)

技能按七个阶段推进,且要求在所有研究数据收集完成前不得开始撰写报告:

  • 阶段 1:公司档案与设置。解析单一公司代码,创建 /tmp/earnings-preview 工作目录,调用 get_latest、get_info_from_identifiers、get_company_summary_from_identifiers、get_next_earnings_from_identifiers,并将信息写入 /tmp/earnings-preview/company-info.txt。
  • 阶段 2:财报电话会议记录分析。调用 get_latest_earnings_from_identifiers 与 get_transcript_from_key_dev_id,提取直接引语、指引、关键驱动因素、风险、分析师问答主题与下季度关注主题,写入 transcript-extracts.txt。
  • 阶段 3:竞争对手分析。调用 get_competitors_from_identifiers(competitor_source="all"),选取 5-7 家最相关的上市公司,为标的公司与竞争对手获取价格、摊薄每股收益、市值和一致预期数据,并分别写入 prices.csv、peer-eps.csv、peer-market-caps.csv、consensus-eps.csv。
  • 阶段 4:新闻、预期与行业情报。通过 Kensho Grounding 执行五类搜索查询(盈利预期与分析师情绪、评级与目标价、风险与看空论点、近期新闻、行业背景),并将每条发现及其来源 URL 追加写入 kensho-findings.txt。
  • 阶段 5:财务数据收集。为 revenue、gross_profit、operating_income、ebitda、net_income、diluted_eps 获取 8 个季度的季度财务数据,还调用 get_segments_from_identifiers 获取 8 个季度的业务分部数据,写入 financials.csv,仅写原始数据不进行计算。
  • 阶段 6 与阶段 7:校验并生成 HTML 报告。计算在阶段 6 进行,且必须从磁盘上的中间文件读取,而非依赖记忆;生成报告前需用 cat 命令将所有中间文件读回上下文。

关键规则

  • 数据源(零例外):仅允许使用 Kensho Grounding MCP 与 S&P Global MCP(kfinance),禁止使用任何网络搜索或其他数据源;若 Kensho 无结果,应改写查询或标注"数据不可用",绝不能回退到网络搜索。
  • 中间文件规则:每次 MCP 工具调用返回后须立即将原始数据写入 /tmp/earnings-preview/ 下的文件,文件而非记忆是报告中所有数字、引语和来源 URL 的唯一事实来源。
  • 财季规则:不得从日历报告日期推断财季,须严格沿用 API 返回的财季与财年(例如 "Walmart Q4 FY2026")。
  • 长度规则:报告须精简,目标 4-5 页,使用紧凑要点。
  • 直接引语规则:blockquote 中的管理层引述必须逐字复制,可对照记录核实;无法找到确切措辞时须改用自己的叙述性转述。
  • 计算完整性规则:任何多步计算须逐步写出并校验中间结果。
  • 比率命名规则:所有估值比率须明确标注为 LTM 或 NTM,不得使用 "trailing" 或 "forward";LTM 使用最近 4 个已报告季度之和,NTM 使用未来 4 个季度一致预期均值 EPS 之和,两者均须在竞争对手对比表中呈现。
  • 超链接规则(严格执行):报告中每项主张(数值与非数值)均须用指向附录对应条目的超链接包裹,每个数字都要是可点击链接,并为每项独特主张分配顺序引用 ID。
  • 日期一致性规则(股票回报):所有公司计算比较回报时须使用完全相同的起止日期。
  • 市盈率货币规则(LTM P/E):每家公司使用其自身最近 4 个已报告季度。
  • 市值日期戳:报告市值时使用检索日期,若与报告日期不同须在附录注明。

适用场景

适用于分析师或投资者在单家公司财报发布前,需要快速产出数据密集、信源可追溯的股票研究前瞻报告的场景。

限制

数据源仅限 Kensho Grounding MCP 与 S&P Global MCP,不支持其他数据源或网络检索。关于具体的安装方式、运行环境依赖、收费或价格信息,资料中暂未提供。