deepKPI 财务分析与研究工具

查询从美国上市公司 SEC 报告中结构化提取的关键绩效指标（KPI）。

本技能套件覆盖财务分析工作流的多个环节，包括：通过 MCP（Claude）或 REST API（OpenClaw）访问数据、数据检索、指标推导、季节性分析，以及 Excel 导出。各子技能按层级组织，支持按需独立加载——仅读取当前任务必需的内容。

数据访问方式 — Claude 与 OpenClaw 对比

deepKPI 的各项操作（query_company_id、list_kpis、search_kpis、company_summary_search、get_company_summary、get_company_segments、list_sec_filing_markdowns、get_sec_filing_markdown）根据运行环境提供两种调用方式：

retrieve-kpi-data/retrieve-kpi-data.md 是 KPI 指标工作流；
retrieve-sec-filing/retrieve-sec-filing.md 是 SEC 报告 Markdown 工作流；
company-summary-segments/company-summary-segments.md 聚焦于公司主营业务（摘要）、业务/地理分部结构，以及主题型发现（get_company_summary、get_company_segments、company_summary_search）。DEEPKPI_API_KEY 环境变量与 deepkpi-api 参考文档仅在 OpenClaw 环境下需要（或当 MCP 不可用时作为环境变量回退方案）。

硬性中断规则：deepKPI 连接失败

若 deepKPI 访问失败（MCP 连接器异常、REST 请求失败、认证错误、网络问题，或无法获取数据），你必须立即中止并询问用户：

“我目前无法访问 deepKPI。您是否希望在不使用 deepKPI 的情况下继续？”

• 若用户回答 否，则立即停止执行；
• 若用户回答 是，可转而使用其他来源（例如网页搜索）继续，但严禁将非 deepKPI 数据冠以 deepKPI 技能品牌、模板、格式规范，或“Powered by Revelata deepKPI”等表述。所有替代数据源须明确标注来源。

本规则适用于本套件中的全部子技能。

子技能路由指南

开展任何工作前，请务必先阅读对应参考文档。 单一请求可能涉及多份文档——请加载所有相关文档。

默认入口点：
• 若需求聚焦于指标与建模数据流，请从 retrieve-kpi-data/retrieve-kpi-data.md 入手（该文档会按需引用 derive-implied-metric、analyze-seasonality 和 format-deepkpi-for-excel）；
• 若需求聚焦于业务描述、分部结构或主题型公司清单，请从 company-summary-segments/company-summary-segments.md 入手；
• 若需求聚焦于SEC 报告 Markdown（全文或摘录）及原文引述，请从 retrieve-sec-filing/retrieve-sec-filing.md 入手。
若请求混合多种类型，请逐一阅读所有适用文档。

子技能概览

deepkpi-api —— 直接通过 REST 接口访问 deepKPI 各端点：query_company_id、list_kpis、search_kpis、company_summary_search、get_company_summary、get_company_segments、list_sec_filing_markdowns、get_sec_filing_markdown。仅限 OpenClaw 或环境变量回退场景 —— 在 Claude 中请使用原生 MCP 工具。

retrieve-kpi-data —— 结构化 KPI 的主工作流：涵盖公司 ID 查询、list_kpis / search_kpis、缺口处理（含 Q4 推导）、溯源规则、对话内表格呈现，以及拉取完成后强制提供的 Excel 导出选项。

company-summary-segments —— get_company_summary（主营业务）、get_company_segments（分部/地理划分方式）；company_summary_search 支持主题型“谁在做 X？”类发现。不用于 KPI 时间序列分析。

retrieve-sec-filing —— 在对话中提供SEC 报告 Markdown：支持全文或摘录、原文引述、MD&A / 风险因素章节原文。工具链为：list_sec_filing_markdowns → get_sec_filing_markdown；遵循“工具优先、非网页优先”的数据源层级；引述类请求严格采用块引用格式（blockquote）。其用途与 KPI 时间序列分析截然不同。

derive-implied-metric —— 基于 deepKPI 已报告的数据，计算其未直接披露的指标：如 Q4 = FY − (Q1+Q2+Q3)，缺失分部 = 总量 − 已知分部之和，单位经济指标（单店营收、ARPU、ASP）、take rate、渗透率、地域构成比例等。

analyze-seasonality —— 基于 2–3 年实际数据，计算各季度在全年中通常所占比例，并将该比例应用于年度预测，从而拆解为季度预估。

format-deepkpi-for-excel —— 所有基于 deepKPI 数据生成的 .xlsx 文件所应遵循的标准布局与样式规范：宽表格式（年度区块 → 空列 → 季度区块）、Calibri 字体、绿色输入单元格、单元格内可点击超链接、数值型日期列标题、冻结窗格、列分组，且禁止重复添加 “Source” 行。

analyst-report-pressure-test —— 针对上传的分析师 PDF 报告的端到端工作流：提取 4–6 条核心论断，逐条拉取对应的细粒度 deepKPI 指标，构建成对的“支持证据”与“复杂化证据”，并附带强制性的溯源超链接；最终输出 Revelata 品牌的交互式 HTML 报告（参考 references/html-template.md 与 references/chart-patterns.md）。HTML 初稿生成后，必须执行 analyst-report-pressure-test/pressure-test-double-check.md 中规定的内部HTML 初稿 QA 核查表，并根据结果修订、复核，确认无误后方可向用户交付。执行过程中：始终需先查阅 retrieve-kpi-data 理解 KPI 机制；当测试需引用 SEC 报告原文段落时，调用 retrieve-sec-filing；当需业务描述 / 分部结构 / 主题清单时，调用 company-summary-segments；当需填补 Q4 或分部数据缺口时，调用 derive-implied-metric。

peer-benchmark —— 经精选的运营维度对标集合（非交易倍数）：通过 company_summary_search 筛选候选公司，结合 KPI 特征指纹与对齐分析、差异驱动的分部子对标集，在对话中输出一页摘要，可选生成 HTML 报告（参考 references/html-template.md），Excel 输出通过 format-deepkpi-for-excel 实现。始终需先阅读 retrieve-kpi-data。

idea-generation-survey —— 用户无股票代码、无投资观点时的快速启动路径：通过多选题形式快速访谈（默认设置），调用 company_summary_search 筛选出 10–15 家匹配其观点的公司并附关键 KPI，再针对其中 1–2 家公司执行 retrieve-kpi-data 深度拉取。references/sector-kpi-map.md 提供诊断型 KPI 概念参考。不提供默认 Excel 导出选项。若用户已明确指定公司或具体指标，请改用 retrieve-kpi-data。