Octagon sec mda analysis
Skill findscripter/everything-skills/09-verticals/octagon-sec-mda-analysis
当需要从美股上市公司 SEC 文件(10-K/10-Q)的 MD&A 段落中提取战略举措、财务表现、宏观挑战与前瞻性陈述时使用;通过 Octagon MCP 的 octagon-agent 用自然语言提示拉取并产出结构化 MD&A 解读(含数据来源 octagon-sec-agent);不适用于无 Octagon API Key/未配置 MCP、非美股 SEC 体系、或需要逐字原文与下单交易的场景;触发词:MD&A、管理层讨论与分析、10-K、10-Q、SEC、octagon-agentFrom its SKILL.md
npx -y skills add findscripter/everything-skills --skill octagon-sec-mda-analysisAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
7.2 KB, ~2.1k tokens by cl100k_base, as published. Nobody here has run it
何时使用
当需要快速读懂某美股上市公司在 SEC 文件中**管理层讨论与分析(MD&A)**段落传递的信号时使用,典型产出:战略举措、财务表现驱动因素、宏观挑战与应对、前瞻性陈述与风险、跨期/同业对比。MD&A 对应 10-K 的 Item 7 与 10-Q 的 Item 2。
底层依赖 Octagon MCP 的 octagon-agent 工具(市场情报综合体,覆盖 SEC 文件、财报、财务与行情),数据来源标注为 octagon-sec-agent。
不该用的边界:
- 未配置 Octagon MCP 或无
OCTAGON_API_KEY—— 先按下文完成 MCP 安装与鉴权,否则工具不可用。 - 非美股 SEC 披露体系(如 A 股、港股、私有公司)—— 该工具针对 SEC EDGAR。
- 需要逐字原文 / 法律级精确引用 ——
octagon-agent返回的是结构化解读与摘要,关键结论须回到原始 filing 复核。 - 需要实盘下单、撮合或实时 tick 行情 —— 本技能只做文本情报解读,不做交易。
- 想要程序化拉取行情/财务数值(股价、利润表、技术指标)—— 用
alpha-vantage-market-data之类的数据 API 更合适。
步骤
- 确认 MCP 就绪:在 AI 客户端(Cursor / Claude Desktop / Windsurf)中已配置
octagon-mcp且octagon-agent工具可见(配置见「指令」)。 - 确定分析参数:
- Ticker(必填):股票代码,如 AAPL、MSFT、GOOGL。
- Filing Type(可选):10-K(年报)/ 10-Q(季报)。
- Focus Areas(可选):战略举措 / 财务表现 / 风险 / 分部 / 跨期对比。
- 用自然语言提示调用
octagon-agent,把参数写进 prompt(见「示例」)。 - 解读输出四大块:战略举措、宏观挑战、财务表现、风险与前瞻性陈述。
- 交叉验证与提炼:把 MD&A 主张对照实际财务数字,关注语气、措辞与口径变化,必要时做跨期/同业对比。
指令
安装 Octagon MCP(npx,需 Node.js):
- API Key:在 Octagon 注册并在 API Keys 页生成,妥善保存。
- Claude Desktop / Windsurf 配置(
claude_desktop_config.json或model_config.json):
{
"mcpServers": {
"octagon-mcp-server": {
"command": "npx",
"args": ["-y", "octagon-mcp@latest"],
"env": { "OCTAGON_API_KEY": "YOUR_API_KEY_HERE" }
}
}
}
- Cursor 命令式:
env OCTAGON_API_KEY=<key> npx -y octagon-mcp;Windows 用cmd /c "set OCTAGON_API_KEY=<key> && npx -y octagon-mcp"。 - 验证:刷新 MCP 列表,应出现
octagon-agent;用Retrieve the current stock price for AAPL冒烟测试。
MCP 调用格式(octagon-agent):
{
"server": "octagon-mcp",
"toolName": "octagon-agent",
"arguments": {
"prompt": "Analyze the Management Discussion and Analysis section from AAPL's latest quarterly report."
}
}
输出结构(典型): Strategic Initiatives / Macroeconomic Challenges / Financial Performance / Risks & Forward-Looking Statements;末尾标注 Data Sources: octagon-sec-agent。
MD&A 组成速查(用于设计 prompt 的 focus):
| 模块 | 关注点 |
|---|---|
| 经营成果 Results of Operations | 营收驱动、毛利与成本结构、营业费用(R&D/SG&A)、税务有效税率 |
| 流动性与资本 Liquidity & Capital | 现金头寸、三类现金流、债务与契约、资本配置(CapEx/回购/分红)、营运资本 |
| 关键会计政策 | 收入确认、商誉/减值估计、或有事项、公允价值 |
| 前瞻性陈述 | 指引、战略、风险、安全港免责 |
示例
直接给 octagon-agent 自然语言提示(把 TICKER 换成目标):
# 标准 MD&A 解读
Analyze the Management Discussion and Analysis section from AAPL's latest quarterly report.
# 年报战略主题
Analyze the MD&A section from MSFT's latest 10-K filing and summarize key strategic themes.
# 仅提取财务表现讨论
Extract the financial performance discussion from GOOGL's latest MD&A.
# 战略举措聚焦
What strategic initiatives does AMZN highlight in their latest MD&A section?
# 跨期对比
Compare the MD&A commentary between TSLA's Q4 2025 and Q4 2024 10-Q filings.
# 分部表现
Analyze the segment performance discussion in META's latest MD&A.
注意事项
- 先验证 MCP 与 Key:Key 字符串无多余空格;连不上先查网络与 Octagon 可达性;遇限流降低请求频率。
- 结论须回原文复核:
octagon-agent输出为解读/摘要,重要数字与表述应对照原始 10-K/10-Q 与财务报表核验,必要时查 8-K 获取期间内的重大更新。 - 读「弦外之音」:管理层没说的往往和说了的一样重要;留意从具体数字转为模糊措辞、分部合并、KPI 更换、披露变少等信号。
- 语气与措辞:乐观("strong performance"/"momentum")、谨慎("headwinds"/"uncertainty")、防守("despite"/"although")、自信("expect"/"anticipate"),语气漂移本身是信息。
- 警惕非 GAAP:管理层常强调调整后口径;评估其可持续性,区分一次性收益。
- 跟踪指引兑现度:把过去指引与实际结果对照,识别系统性高估/低估偏差。
- 输出仅供投资研究与分析参考,不构成投资建议;不能替代尽调、回测、风控与专家复核。缺关键参数(如 Ticker)时先停下确认。
互见
- related:
alpha-vantage-market-data—— MD&A 是定性解读,配合行情/财务 API 获取定量数据交叉验证。 - combines_with:
dcf-valuation-model、three-statement-model—— 把 MD&A 提炼的营收增长、利润率轨迹、CapEx/营运资本假设喂进估值与建模。 - combines_with:
diligence-issue-extractor—— MD&A 的红旗信号(营收质量、利润率可持续性、现金流背离、债务契约)可汇入尽调问题清单。
采编自 OctagonAI/skills(MIT 许可),已做中文适配重写。
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.